Alignak - Broker module for the monitoring logs, directy store to Mongo DB
Project description
Note that this module is only useful to get the Alignak monitoring logs in a Mongo DB if you do not use the Alignak backend
Alignak module for the monitoring logs
Installation
The installation of this module will copy some configuration files in the Alignak default configuration directory (eg. /usr/local/etc/alignak). The copied files are located in the default sub-directory used for the modules (eg. arbiter/modules).
From PyPI
To install the module from PyPI:
sudo pip install alignak-module-mongo-logs
From source files
To install the module from the source files (for developing purpose):
git clone https://github.com/Alignak-monitoring-contrib/alignak-module-mongo-logs cd alignak-module-mongo-logs sudo pip install . -e
Short description
This module for Alignak collects the monitoring logs (alerts, notifications, …) to log them into a collection of a Mongo DB.
This module was back-ported from the Shinken mod-mongo-logs but it does not manage the availability for hosts and services.
Configuration
Once installed, this module has its own configuration file in the /usr/local/etc/alignak/arbiter/modules directory. The default configuration file is mod-mongo-logs.cfg. This file is commented to help configure all the parameters.
To configure Alignak broker to use this module:
edit your broker daemon configuration file
add the module_alias parameter value (logs) to the modules parameter of the daemon
To configure this module for Mongo DB:
edit the module configuration file to set the MongoDB parameters
Metrics
This module is able to push metrics to an external TSDB (Graphite, InfluxDB). Configure the metrics parameters in the configuration:
; -------------------------------------------------------------------- ; Module internal metrics ; Export module metrics to a statsd server. ; By default at localhost:8125 (UDP) with the alignak prefix ; Default is not enabled ; -------------------------------------------------------------------- ;statsd_host = localhost ; For StatsD ;statsd_port = 8125 ; For Graphite ;statsd_port = 2004 ; Default ;statsd_prefix=alignak ; Use this prefix to use the alignak name in the metrics hierarchy ;statsd_prefix=%(alignak_name)s.modules ; Default is disabled ;statsd_enabled = 0 ;graphite_enabled = 0 ; --------------------------------------------------------------------
Available metrics:
committed-logs counts the DB commited logs
monitoring-event-got.%s counts the detected events
monitoring-event-ignored.%s counts the ignored events (not DB commited)
queue-size is the module message queue size. If greater than 1, it indicates a module overload because the queue should be emptied on each loop turn
managed-broks-time is the broks management duration on each loop turn
Note that only the events in this list are DB commited: [‘TIMEPERIOD TRANSITION’, ‘RETENTION LOAD’, ‘RETENTION SAVE’, ‘CURRENT STATE’, ‘NOTIFICATION’, ‘ALERT’, ‘DOWNTIME’, ‘FLAPPING’, ‘ACTIVE CHECK’, ‘PASSIVE CHECK’, ‘COMMENT’, ‘ACKNOWLEDGE’, ‘DOWNTIME’]
An example Grafana dashboard:
Bugs, issues and contributing
Contributions to this project are welcome and encouraged … issues in the project repository are the common way to raise an information.
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 alignak_module_mongo_logs-1.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5a01662e1fe573f5c164ae66d99523193d5bd8dd8d458425370035f8e879b81e |
|
MD5 | baf8c1ce7659cdcae27fd35f6899751d |
|
BLAKE2b-256 | d5421da57e859853d25669583c59871d94c2aef6370541dd3ee67eaa1890517a |
Hashes for alignak_module_mongo_logs-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ee08fd802f7f5c26500cc4e53c6d8a7c7ca183717343bf8caff0759bf224634f |
|
MD5 | ab7b5e528d14c89af2e338f03cd2c795 |
|
BLAKE2b-256 | af93db17f2027077bc629a59999cd3ae49a81997aadf72b14833c6a6b409242a |