Export logs from ringserver as influxdb timeseries
Project description
ringserverstats
Installation
ringserverstats is distributed on PyPI <https://pypi.org>
_ as a universal
wheel and is available on Linux/macOS and Windows and supports
Python 2.7/3.5+ and PyPy.
$ pip install ringserverstats
Usage
To work properly, this program needs the following environment variables set :
INFLUXDB_HOST
: The host name or adress of influxdb serverINFLUXDB_PORT
: The port number of influxdb serverINFLUXDB_USER
: The influxdb user to authenticate toINFLUXDB_PASS
: The password to authenticate withINFLUXDB_DB
: The database name containing the metricINFLUXDB_VERIFY_SSL
: Set toyes
orno
to verify SSL connection
$ python ringser_stats tlogs.log
Explanations
The TX logs from ringserver are metrics suitable for a timeserie database. The idea is to parse the logs, as in the exemple below, and to generate values to insert into an influxdb timeseries database.
The file grafana_dashboard.json can be imported into grafana to visualize this timeserie.
Used tags in influxdb :
show tag keys from ringserver
The ringserver measure has several tags :
- network, station, location, channel : which data was requested
- geohash : location of the client in geohash format
- clienthash : a hash of the client ip (usefull to correlate the clients requests)
License
ringserver_stats is distributed under the terms of the GPL v3 or later
Build
: python3 setup.py sdist bdist_wheel
Test
: tox
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ringserverstats-0.3.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1b43b7d965768ab74f9661743879dde40eb3d17d00c8cd0f1fec78428d43efe9 |
|
MD5 | b2422ddc77fb4a8e2459939d24b3bff7 |
|
BLAKE2b-256 | 8a52bc0a8b06fffa10864e5f14b47f5dadc158c04666fe9106837c9aa18e2b55 |