This is a Splunk Modular Input Add-On for indexing messages from a MQTT Broker.
http://en.wikipedia.org/wiki/MQTT
This Modular Input utilizes the PAHO Java client library version 0.4.0 , http://www.eclipse.org/paho/
Settings -> Data Inputs -> MQTT
to add a new Input stanza via the UIREADME/inputs.conf.spec
. The inputs.conf
file should be placed in a local
directory under an App or User context.You require an activation key to use this App. Visit http://www.baboonbones.com/#activation to obtain a non-expiring key
Any log entries/errors will get written to $SPLUNK_HOME/var/log/splunk/splunkd.log
These are also searchable in Splunk : index=_internal error mqtt.py
The default heap maximum is 64MB. If you require a larger heap, then you can alter this in $SPLUNKHOME/etc/apps/mqttta/bin/mqtt.py on line 95
You can declare custom JVM System Properties when setting up new input stanzas. Note : these JVM System Properties will apply to the entire JVM context and all stanzas you have setup
The way in which the Modular Input processes the received MQTT messages is enitrely pluggable with custom implementations should you wish.
To do this you code an implementation of the com.splunk.modinput.mqtt.AbstractMessageHandler class and jar it up.
Ensure that the necessary jars are in the $SPLUNKHOME/etc/apps/mqttta/bin/lib directory.
If you don't need a custom handler then the default handler com.splunk.modinput.mqtt.DefaultMessageHandler will be used.
This project was initiated by Damien Dallimore , damien@baboonbones.com