Go to file
Tobias 282077ff52
Merge pull request #5 from genofire/master
add example dashboard
2019-02-07 13:59:04 +01:00
LICENSE Create LICENSE 2018-01-30 00:29:37 +01:00
README.md add example dashboard 2018-11-09 13:04:31 +01:00
grafana-example.json add example dashboard 2018-11-09 13:04:31 +01:00
grafana-example.png add example dashboard 2018-11-09 13:04:31 +01:00
rspamd-influxdb.py Adding --config parameter to provide a path to a configuration file for security reasons (issue #2) 2018-11-09 11:57:45 +01:00

README.md

rspamd-influxdb

Quick and dirty approach to get stats of rspamd out of the webinterface's API into InfluxDB for visualizing using Grafana.

Usage

python3 rspamd-influxdb.py --url "https://example.com:1337" --password "superSecretPassword"

You may provide the URL and password by defining the path to a configuration file in order to prevent other users from reading the password in clear text from the process list. To do so you need to provide the --config $path argument, e.g.

python3 rspamd-influxdb.py --config "~/config.json"

The configuration file needs to contain the fields url and password as valid JSON. An example file could look like this:

{
    "url": "https://example.com",
    "password": "superSecretPassword"
}

Utilization

Use this script call within InfluxData's Telegraf

e.g.:

[[inputs.exec]]
	commands = ["python3 /opt/rspamd-influxdb/rspamd-influxdb.py --config /etc/telegraf/tools-conf/rspamd-fetch.json"]
	timeout = "5s"
	data_format = "influx"

Security Tip

chown root:telegraf /etc/telegraf/tools-conf/rspamd-fetch.json
chmod 640 /etc/telegraf/tools-conf/rspamd-fetch.json

Grafana example

Grafana Example