ID: instant-messaging

This plugin provides abstract support for instant-messaging notifications to Jenkins, including a common bot-driven command and query interface and the core for pipeline steps integration code.

Practical support for particular IM protocols is implemented by various concrete plugins like the Jabber/XMPP or the IRC plugin, allowing users to have the same interactions with their Jenkins server whatever messenger they use.

Note that there are some other IM protocol plugins that chose to implement everything from scratch, so they do not use instant-messaging-plugin as a dependency and do not enjoy its common features.

There are also plugins which add commands available via instant messaging such as Log Command.

For more information, visit the plugin information page:

The practical suggestions for freestyle or pipeline job setup may be seen in and pages.

Regex support in bot commands

The currentlyBuilding (cb) and queue (q) commands now support an optional argument to apply regular expression filters to the lines they would output, and count and report hits compared to the full job lists.

The key argument for this is ~ and the rest of the argument string is assumed to be the regular expression (note however that whitespace between tokens of the argument string is converted during argument processing; for clarity it would be preferable to pass a single-token argument with \s+ in positions where whitespace matches are expected).

Beside ordinarily matching what is present in a line, this can be used with "negative lookups" for matching lines that do not contain certain patterns. Certain know-how applies to such expressions:

  • To negative-match the whole string from start, use a caret, e.g.:
cb ~ ^(?!master)

to skip jobs running on nodes whose name starts with (or equals) master. Without the caret it did not work.

  • For matching inside a job name, the .* must be also inside the lookahead pattern:
cb ~ ^(?!.*rescan)

would list only jobs whose IM report line does NOT include rescan.

ArchivesGet past versions
Version: 1.42
Requires Jenkins 2.269
Installs: 3,133
Jim Klimov
Help us improve this page!
To propose a change submit a pull request to the plugin page on GitHub.