This documentation is for an older version of the software. If you are using the current version of Cumulus Linux, this content may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Collecting Interface Statistics

The NetQ Agent collects interface counters from /proc/net/dev and pushes them to the NetQ Telemetry Server, where they are stored in a container running an InfluxDB database. Only counters for physical interfaces are collected; NetQ does not collect counters for non-physical interfaces like bonds, bridges and VXLANs.

The NetQ Agent uses the netq-stats-pushd service to collect counters and push them to the database on the telemetry server. The service collects counters every 15 seconds.

The counters that are collected include:

  • rx_bytes, rx_drop, rx_errs, rx_frame, rx_multicast, rx_packets

  • tx_bytes, tx_carrier, tx_colls, tx_drop, tx_errs, tx_packets

Early Access Feature

Collecting counters is an early access feature in Cumulus NetQ 1.2.

Configuring Counter Collection

The InfluxDB database is installed in its own container by default on the telemetry server. The netq-stats-pushd service is also installed, but must be enabled. You also need to enable counter collection on every node for which you want to gather statistics.

To enable and start the netq-stats-pushd service on the telemetry server, run:

cumulus@ts:~$ sudo systemctl enable netq-stats-pushd.service
cumulus@ts:~$ sudo systemctl start netq-stats-pushd.service

To check the status of the service, use systemd:

cumulus@ts:~$ sudo systemctl status netq-stats-pushd.service 
● netq-stats-pushd.service - NetQ Stats Storage daemon
   Loaded: loaded (/lib/systemd/system/netq-stats-pushd.service; enabled)
   Active: active (running) since Mon 2017-11-27 00:51:09 UTC; 6s ago
 Main PID: 30550 (netq-stats-push)

On every node you want to monitor, enable counter collection, then restart the NetQ Agent:

cumulus@ts:~$ netq config add stats
cumulus@ts:~$ netq config restart agent

Once the agent is restarted, the netq-stats-pushd service starts collecting interface statistics and pushes them to the database on the telemetry server.

Troubelshooting

The primary log files for the telemetry server are:

  • /var/log/cts/cts-influxdb.log

  • /var/log/netq-stats-pushd.log

On each node, check the NetQ Agent log file: /var/log/netq-agent.log.

Disabling Counter Collection

To disable counter collection on a node, run the following commands:

cumulus@switch:~$ netq config del stats
cumulus@switch:~$ netq config restart agent

Disabling this feature does not purge the data already collected from the database.

Once all nodes have stopped pushing statistics, you can stop and disable the netq-stats-pushd service on the telemetry server:

cumulus@ts:~$ sudo systemctl stop netq-stats-pushd.service
cumulus@ts:~$ sudo systemctl disable netq-stats-pushd.service