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.