Using StatsD with Bleemeo

Professional

Default installation will listen for StatsD metrics and forward them to Bleemeo Cloud platform.

Bleemeo agent uses the StatsD listener of Telegraf.

To use a StatsD client with Bleemeo, all you need is to point your StatsD client to your Bleemeo monitoring agent. Listener is activated by default on StatsD default port (8125).

It can be customized in the telegraf section of the monitoring agent configuration:

telegraf:
  statsd:
    enable: true
    address: "127.0.0.1"
    port: 8125

StatsD metrics supported

Caution

When you activate your StatsD metrics, remember that you also need to allow those metrics to reach the Cloud platform by allowing them in the metric section of your monitoring agent, as described below.

The following StatsD metric types are supported:

• counter: The metric will be “statsd_NAME”. It’s a rate per second.

• gauge: The metric will be “statsd_NAME”.

• timing: Multiple metrics will be created:

  • “statsd_NAME_90_percentile”: 90th percentile in milliseconds. It means 90% of the events took less than this time to complete.
  • “statsd_NAME_count”: Rate per second.
  • “statsd_NAME_lower”: Minimum time in milliseconds.
  • “statsd_NAME_mean”: Average time in milliseconds.
  • “statsd_NAME_stddev”: Standard deviation in milliseconds.
  • “statsd_NAME_upper”: Maximum time in milliseconds.

To activate the metrics you want to see in Bleemeo, add in the metric section of the configuration of the monitoring agent:

metric:
  allow_metrics:
    - statsd_visitors_count
  deny_metrics:
    - statsd_visitors_lower
  include_default_metrics: true