Openwire Graylog Plugin

Provides an Openwire input for Graylog using the ActiveMQ client library

License	The GNU General Public License, Version 3.0
Categories	Wire Data Data Structures Graylog Application Layer Libs Logging
GroupId	com.github.exabrial
ArtifactId	graylog-plugin-openwire
Last Version	1.3.0
Release Date	Aug 19, 2020
Type	jar
Description	Openwire Graylog Plugin Provides an Openwire input for Graylog using the ActiveMQ client library
Project URL	https://github.com/exabrial/graylog-plugin-openwire
Source Code Management	https://github.com/exabrial/graylog-plugin-openwire/tree/master

Download graylog-plugin-openwire

Filename	Size
graylog-plugin-openwire-1.3.0.pom
graylog-plugin-openwire-1.3.0.jar	1 MB
graylog-plugin-openwire-1.3.0-sources.jar	12 KB
graylog-plugin-openwire-1.3.0-javadoc.jar	104 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.exabrial/graylog-plugin-openwire/ -->
<dependency>
    <groupId>com.github.exabrial</groupId>
    <artifactId>graylog-plugin-openwire</artifactId>
    <version>1.3.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.exabrial/graylog-plugin-openwire/
implementation 'com.github.exabrial:graylog-plugin-openwire:1.3.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.exabrial/graylog-plugin-openwire/
implementation ("com.github.exabrial:graylog-plugin-openwire:1.3.0")

Apache Buildr

'com.github.exabrial:graylog-plugin-openwire:jar:1.3.0'

Apache Ivy

<dependency org="com.github.exabrial" name="graylog-plugin-openwire" rev="1.3.0">
  <artifact name="graylog-plugin-openwire" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.exabrial', module='graylog-plugin-openwire', version='1.3.0')
)

Scala SBT

libraryDependencies += "com.github.exabrial" % "graylog-plugin-openwire" % "1.3.0"

Leiningen

[com.github.exabrial/graylog-plugin-openwire "1.3.0"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.apache.activemq : activemq-client	jar	5.16.0

provided (3)

Group / Artifact	Type	Version
com.google.auto.value : auto-value	jar	1.7.4
com.google.auto.service : auto-service	jar	1.0-rc7
org.graylog2 : graylog2-server	jar	3.1.4

Project Modules

There are no modules declared in this project.

Graylog Plugin Openwire

Bridges ActiveMQ->Graylog

Provides an input for Graylog using the ActiveMQ client library. Openwire is the native protocol for ActiveMQ, but all valid client ActiveMQ URLs can be used.

If you use Logback inside your Java [possibly EE] applications, I have two logback appenders you can use:

• https://github.com/exabrial/logback-jms-appender (Best for Java EE apps with a managed JMS Configuration)
• https://github.com/exabrial/logback-openwire-appender (Best for Spring Boot or non EE standalone apps)

Acknowledgements

The Graylog MQTT plugin lays the groundwork on how to accomplish writing your own inputs for Graylog. The code is well organized and very readable. https://github.com/graylog-labs/graylog-plugin-mqtt

License

Since Upsteam Graylog and the MQTT plugin are GPL, this project is GPL to conform with the terms of the license.

Installation

Download the plugin and place the .jar file in your Graylog plugin directory, which is usually called plugins.

cd ~
gpg --keyserver pool.sks-keyservers.net --recv-keys 871638A21A7F2C38066471420306A354336B4F0D
wget https://github.com/exabrial/graylog-plugin-openwire/releases/download/graylog-plugin-openwire-1.3.0/graylog-plugin-openwire-1.3.0.jar.asc
wget https://github.com/exabrial/graylog-plugin-openwire/releases/download/graylog-plugin-openwire-1.3.0/graylog-plugin-openwire-1.3.0.jar
gpg --verify graylog-plugin-openwire-1.3.0.jar.asc graylog-plugin-openwire-1.3.0.jar
rm graylog-plugin-openwire-1.3.0.jar.asc
sudo mv graylog-plugin-openwire-1.3.0.jar /usr/share/graylog-server/plugin/
sudo chown root:root /usr/share/graylog-server/plugin/graylog-plugin-openwire-1.3.0.jar
sudo systemctl restart graylog-server

After that step is completed, restart your server and you should have the new input options available.

Configuration

Property Name	Example	Purpose
brokerUrl	failover:(ssl://activemq-1.example.com:61616,ssl://activemq-2.example.com:61616)?randomize=false&backup=true	The ActiveMQ client URL. Any valid ActiveMQ client URL can be used.
queueName	ch.qos.logback	The Queue name to read logs off of.
username	loguser	The username to use to establish the connection to ActiveMQ.
password	myPassw0rd	The password to use to establish the connection to ActiveMQ.
throttling_allowed	true	If the graylog server gets busy, slow down this input. Recommend checking this box.

Versions

Version
1.3.0 Aug 19, 2020
1.2.0 Nov 4, 2019
1.1.0 Jul 7, 2019
1.0.2 Oct 27, 2018
1.0.1 Sep 4, 2018
1.0.0 Sep 4, 2018