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.
``` bash
$ pip install ringserverstats
```
## Usage
To work properly, this program needs the following environment variables set :
* `INFLUXDB_HOST` : The host name or adress of influxdb server
* `INFLUXDB_PORT` : The port number of influxdb server
* `INFLUXDB_USER` : The influxdb user to authenticate to
* `INFLUXDB_PASS` : The password to authenticate with
* `INFLUXDB_DB` : The database name containing the metric
* `INFLUXDB_VERIFY_SSL` : Set to `yes` or `no` to verify SSL connection
``` bash
$ 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 :
``` sql
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
## 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.
``` bash
$ pip install ringserverstats
```
## Usage
To work properly, this program needs the following environment variables set :
* `INFLUXDB_HOST` : The host name or adress of influxdb server
* `INFLUXDB_PORT` : The port number of influxdb server
* `INFLUXDB_USER` : The influxdb user to authenticate to
* `INFLUXDB_PASS` : The password to authenticate with
* `INFLUXDB_DB` : The database name containing the metric
* `INFLUXDB_VERIFY_SSL` : Set to `yes` or `no` to verify SSL connection
``` bash
$ 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 :
``` sql
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
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
ringserverstats-0.1.0.tar.gz
(2.3 kB
view hashes)
Built Distribution
Close
Hashes for ringserverstats-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3f9d10585bf38ccf858ed73a352707bdf2febc3d68ac1e99d35a59b4649d0e92 |
|
MD5 | 4dbcc08820e06962f6a4722b1074bdc4 |
|
BLAKE2b-256 | 8f811f9680e06ba72494e8af0174ca3f3491aa5f1cc64cd8707d77ec9e322385 |