search

graylog-labs / graylog-plugin-riemann

Graylog2 output plugin to send events to a Riemann instance
Apache License 2.0
7 stars 1 forks source link
graylog graylog-plugin output riemann stream stream-processing

readme

Riemann Plugin for Graylog

Build Status

An output plugin for integrating Riemann with Graylog.

Required Graylog version: 2.0.0 and later

Installation

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

Restart graylog-server and you are done.

Usage

You should now be able to add a Riemann output to your streams through the option Manage outputs.

Screenshot: Riemann Output Settings

The important parameters are the host address and port number to successfully establish a connection to Riemann. Additionally the plugin can send the log message as one JSON string or automatically extract every field as a Riemann custom event field.

You will now receive messages from this stream in Riemann.

Build

This project is using Maven 3 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. Travis CI will build the release artifacts and upload to GitHub automatically.

Credits

Thanks to Henrik Johansen and Region Syddanmark for sponsorship!