Agent fty-alert-stats computes metric statistics on alerts.
To build fty-alert-stats project run:
./autogen.sh
./configure
make
make check # to run self-test
To run fty-alert-stats project:
- from within the source tree, run:
./src/fty-alert-stats
For the other options available, refer to the manual page of fty-alert-stats
- from an installed base, using systemd, run:
systemctl start fty-alert-stats
Configuration file - fty-alert-stats.cfg - supports the following entries:
- agent/metric_ttl: TTL of published metrics (in seconds)
- agent/tick_period: Period of agent ticking (in seconds), should be <= metric_ttl / 4
- resync_period: Time between resynchronizations (in seconds)
fty-alert-stats is composed of 1 actor:
- fty-alert-stats: main actor
The agent keeps a list of alerts and assets, periodically resynchronized with the system every 12 hours. The agent publishes metrics (TTL of 12 minutes), periodically refreshed as needed to keep them alive.
Agent publishes alerts.active.warning@<asset>
and
alerts.active.critical@<asset>
metrics, where each metric is a count of all
active alerts on the asset (and, if applicable, all child assets combined).
Agent does not publish alerts.
When receiving mailbox message with REPUBLISH
subject, agent will republish
all its metrics. Agent will reply with subject REPUBLISH
and payload:
OK
: metrics were republished.RESYNC
: agent is currently resyncing data, metrics will be republished when resync is done.
When receiving RESYNC
on its pipe, agent will query fty-alert-list and
asset-agent (fty-asset) to synchronize itself with the rest of the system.
Failure to synchronize is not fatal, but the agent will not be able
to compute meaningful statistics before its first successful synchronization.
When receiving METRIC_TTL
on its pipe, agent will set metric TTL to the value
contained in the second frame of the message (in seconds).
When receiving TICK_PERIOD
on its pipe, agent will set ticking period to the
value contained in the second frame of the message (in seconds).
Agent is subscribed to ALERTS and ASSETS streams and publishes to METRICS.