InfluxDB Monitor

ntopng features an InfluxDB Driver to export timeseries to InfluxDB. Using InfluxDB causes ntopng to enable and periodically execute the InfluxDB monitor. The InfluxDB monitor checks InfluxDB health and status. The home of the InfluxDB Monitor shows a brief overview

The InfluxDB Monitor Home

The InfluxDB Monitor Home

The overview has the following items:

  • health: A badge which is either green, yellow or red, depending on the status of InfluxDB. The badge is green when ntopng is correctly exporting to InfluxDB, yellow when there are export errors that are recoverable and didn’t cause any data loss, red when export errors are persistent and data loss is occurring.
  • storage utilization: Total disk space used by InfluxDB.
  • ram: Total memory InfluxDB has obtained from the operating system.
  • total exports. Total number of successful writes into InfluxDB. A single write writes multiple points at once.
  • total points: Total number of points successfully written into InfluxDB.
  • dropped points: Total number of points dropped due to InfluxDB write failures.
  • series cardinality: An indication of how challenging is for InfluxDB to handle written points.

When InfluxDB is temporarily unable to export, the health turns yellow.

InfluxDB Temporarily Unable to Export

InfluxDB Temporarily Unable to Export

Temporarily unable to export means ntopng is actively retrying failing exports. Exports typically fails when InfluxDB is down or cannot ingest new data. After several attempts, ntopng gives up and drops the data it couldn’t export. In this case, the health turns into red.

InfluxDB Failing to Export

InfluxDB Failing to Export

Failing to export also causes alerts to be triggered with the reason of the failure to help the administrator fixing the issue.

InfluxDB Monitor Alerts

InfluxDB Monitor Alerts

ntopng keeps retrying even when the health is red to recover as soon as InfluxDB becomes fully functional again.

Timeseries of items shows in the overview are available as well from the char page.

InfluxDB Monitor Timeseries

InfluxDB Monitor Timeseries

Timeseries can be disabled from the Settings, tab Timeseries->System Probes.

The InfluxDB monitor is implemented as an ntopng plugin. Source code is available on gitHub.