Skip to main content

Node Exporter Linux Metrics

This pack helps you monitor your Linux server based on metrics exported by Node exporter.

Pack Assets​

Templates​

The Centreon Plugin Pack Node Exporter Linux Metrics brings a host template:

  • App-Monitoring-Node-Exporter-Linux-custom

It brings the following service templates:

Service AliasService TemplateService DescriptionDefaultDiscovery
Node-CpuApp-Monitoring-Node-Exporter-Linux-CpuCheck node CPU usageX
Node-LoadApp-Monitoring-Node-Exporter-Linux-LoadCheck node loadX
Node-MemoryApp-Monitoring-Node-Exporter-Linux-MemoryCheck node memory usageX
Node-StorageApp-Monitoring-Node-Exporter-Linux-StorageCheck node storage usageXX
Node-TrafficApp-Monitoring-Node-Exporter-Linux-TrafficCheck node CPU usageXX

Discovery rules​

Rule NameDescription
App-Monitoring-Node-Exporter-Linux-Interface-NameDiscover Linux server's interfaces to automatically monitor them
App-Monitoring-Node-Exporter-Linux-Storage-NameDiscover Linux server's partitions to automatically monitor them

Collected metrics & status​

Metric NameUnit
cpu.utilization.percentage%
node_cpu#node.cpu.idle.utilization.percentage%
node_cpu#node.cpu.iowait.utilization.percentage%
node_cpu#node.cpu.irq.utilization.percentage%
node_cpu#node.cpu.nice.utilization.percentage%
node_cpu#node.cpu.softirq.utilization.percentage%
node_cpu#node.cpu.steal.utilization.percentage%
node_cpu#node.cpu.system.utilization.percentage%
node_cpu#node.cpu.user.utilization.percentage%

Prerequisites​

To install Node exporter on your Linux server please refer to this documentation: https://prometheus.io/docs/guides/node-exporter/#installing-and-running-the-node-exporter.

Setup​

  1. Install the plugin package on every Centreon poller expected to monitor Node Exporter Linux Metrics resources:
yum install centreon-plugin-Applications-Monitoring-Nodeexporter-Linux
  1. On the Centreon web interface, on page Configuration > Plugin Packs, install the Node Exporter Linux Metrics Centreon Plugin Pack.

Configuration​

Host​

  • Log into Centreon and add a new host through Configuration > Hosts.
  • Fill the Name, Alias & IP Address/DNS fields according to your Node Exporter Linux Metrics server settings.
  • Apply the App-Monitoring-Node-Exporter-Linux-custom template to the host.
  • Once the template is applied, fill in the corresponding macros. Some macros are mandatory.
MandatoryMacroDescription
EXTRAOPTIONSAny extra option you may want to add to every command line (eg. a --verbose flag)
NODEEXPORTERPORT(Default: '9100')
NODEEXPORTERPROTO(Default: 'http')
NODEEXPORTERURL(Default: '/metrics')

How to check in the CLI that the configuration is OK and what are the main options for?​

Once the plugin is installed, log into your Centreon poller's CLI using the centreon-engine user account (su - centreon-engine) and test the plugin by running the following command:

/usr/lib/centreon/plugins//centreon_monitoring_nodeexporter_linux.pl \
--plugin=apps::monitoring::nodeexporter::linux::plugin \
--mode=load \
--hostname=10.0.0.1 \
--urlpath='/metrics' \
--port='9100' \
--proto='http' \
--warning-load1='' \
--critical-load1='' \
--warning-load5='' \
--critical-load5='' \
--warning-load15='' \
--critical-load15='' \
--use-new-perfdata

The expected command output is shown below:

OK: Load 1 minute: 0.49, Load 5 minutes: 0.71, Load 15 minutes: 0.66 | 'load.1minute.count'=0.49;;;0; 'load.5minutes.count'=0.71;;;0; 'load.15minutes.count'=0.66;;;0;

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_monitoring_nodeexporter_linux.pl \
--plugin=apps::monitoring::nodeexporter::linux::plugin \
--mode=load \
--help

All available modes can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_monitoring_nodeexporter_linux.pl \
--plugin=apps::monitoring::nodeexporter::linux::plugin \
--list-mode

Troubleshooting​

Please find the troubleshooting documentation for Centreon Plugins typical issues.