watcheye-collector 2.0.0

Description:

watcheyecollector 2.0.0

Collector
Collector is a Django application to collect monitoring data samples
through HTTP or SNMP GET interface. Collected data might be then
visualized using e.g. Grafana.

Dependencies
Collector uses InfluxDB
time series database for storing monitoring data samples and django
supported database for storing
configuration and
Redis broker.


Quick start
Assuming InfluxDB is properly configured (setting up authentication
is recommended) and so is Redis broker just a few steps are required.

Install watcheye-collector:
$ pip install watcheye-collector

Add collector application to INSTALLED_APPS setting.
INSTALLED_APPS = [
...
'collector',
]

Integrate Celery with your django project (see Celery documentation
for further reference).
Add InfluxDB connection and Celery configuration in settings.py
file:
INFLUXDB_HOST = 'my_host'
INFLUXDB_USERNAME = 'user'
INFLUXDB_PASSWORD = 'secret'

CELERY_BEAT_SCHEDULE = {
'snmp-scheduler': {
'task': 'collector.tasks.snmp_scheduler',
'schedule': crontab(minute='*')
}
}
CELERY_RESULT_BACKEND = 'redis://my_broker_host/0'
CELERY_BROKER_URL = 'redis://my_broker_host/1'

# to use non-default values configure also:
INFLUXDB_PORT = 1234
INFLUXDB_DATABASE = 'my_database'
INFLUXDB_RETENTION_POLICY = 'my_policy'
INFLUXDB_DURATION = '30d'

To set InfluxDB instance up run:
python manage.py setupinfluxdb --username <admin_username>

To create the collector models run:
python manage.py migrate

Include the collector URLconf in your project urls.py:
path('collector/', include('collector.urls')),

Start the development server and visit http://127.0.0.1:8000/admin/
to create a collector configuration (the Admin application must also
be enabled).
Run Celery worker with:
celery --beat --app <my_project> worker

POST some samples:
$ curl -i -X POST \
-H "Content-Type: application/json" \
-d '{"host":"test", "timestamp": 1500000000,
"samples": [{"parameter":"CPU", "value": 10}]}' \
http://127.0.0.1:8000/collector/