Skip to content
Alarm callback that is writing to HipChat chatrooms
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

HipChat Plugin for Graylog

Github Downloads GitHub Release Build Status

An alarm callback plugin for integrating HipChat into Graylog.

Required Graylog version: 2.4.0 and later.

  • Please use version 1.2.0 of this plugin if you are still running Graylog 1.x.
  • Please use version 1.3.0 of this plugin if you are still running Graylog 2.0.x, 2.1.x, 2.2.x, or 2.3.x.


Download the plugin and place the .jar file in your Graylog plugin directory. The plugin directory is the plugins/ directory relative from your Graylog installation path by default and can be configured in the graylog.conf file.

Restart Graylog and you are done.


Custom templates can be defined with the same JMTE syntax used in the email templates, as long as they only work on the HTML subset supported by the HipChat API.

For example the following template includes the custom field named myField in the HipChat message:

${if stream_url}<a href="${stream_url}">${end}
<strong>Alert for ${stream.title}</strong>
${if stream_url}
<i>${check_result.resultDescription}, triggered at ${check_result.triggeredAt}</i>
${if backlog}Last messages accounting for this alert:<br/>
<table align="left">
<tr><th>My Field</th><th>Details</th></tr>
${foreach backlog message}<br/>
    <td><code>${message.source}, ${}</code></td>
<i>(No messages to display.)</i>

If no custom template has been configured, the default email template is used.


This project is using Maven and requires Java 8 or higher.

You can build a plugin (JAR) with mvn package.

DEB and RPM packages can be build with mvn jdeb:jdeb and mvn rpm:rpm respectively.

Plugin Release

We are using the maven release plugin:

$ mvn release:prepare
$ mvn release:perform

This sets the version numbers, creates a tag and pushes to GitHub. TravisCI will build the release artifacts and upload to GitHub automatically.

You can’t perform that action at this time.