Node exporter (node-exporter)

Exposes the hardware and operating system metrics of every host (CPU, memory, disks, network, systemd units).

Generated from catalog/services/node-exporter.yaml: do not edit by hand.

Summary

Version	1.9.1
Use	install and configure
Layer	infrastructure (shown apart)
Category	Observability
Installation methods	binary
External connection	no
Sandbox only	no

Licence

SPDX identifier	Apache-2.0
Licence policy	core licence (MIT or Apache-2.0)
Licence exception	-
Platform component	node-exporter

Packages and artifacts

A package the project of the service publishes (its image, its binary archive, its Python or OS package) carries the licence of the service; a third-party package carries the licence written on its row, read from the official upstream metadata.

Kind	Package	Version	Licence	Details
binary archive	node_exporter-1.9.1.linux-amd64.tar.gz	1.9.1	Apache-2.0	https://github.com/prometheus/node_exporter/releases/download/v1.9.1/node_exporter-1.9.1.linux-amd64.tar.gz, x86_64, checksum sha256

Supported systems and architectures

Method	Operating systems	Architectures
binary	RHEL family (dnf), Debian family (apt), Arch Linux (pacman)	x86_64 (architecture of the artifacts of the descriptor)

Certified host systems: RHEL 8/9/10, Rocky Linux 8/9/10, AlmaLinux 8/9/10, Oracle Linux 8/9, CentOS Stream 9/10, Ubuntu 22.04/24.04, Debian 12, Arch Linux (rolling). The host preflight accepts these systems (other releases of a known family give a warning, end of life releases are refused) and the x86_64 and aarch64 architectures.

Prerequisites

Host

The descriptor declares no host preflight check.

Network and ports

Component	Port name	Port	Opened in the host firewall
node-exporter	metrics	9100/tcp	yes

Services and connections needed

This service has no dependency.

Installation methods and modes

Method	Default	What the method uses
binary	yes	the binary archives of the descriptor, unpacked under the service directory

Components

Component	Kind	Installation methods	Ports
Node exporter (node-exporter)	worker	binary	9100/tcp

Every host (every-host) (default)

One exporter per managed host.

What the mode deploys:

Component	Placement
node-exporter	min 0, recommended 3

Install this service

The install wizard of the Navin Manager plans, validates and runs the installation; you need the services:install permission on the cluster.

1. Open the wizard. In Clusters, choose the row action Install services of the target cluster. The wizard opens on its first step, Service.

2. Choose the service. On the Service step, select Node exporter. The card shows the licence Apache-2.0.

3. Choose the hosts and the mode. On the Hosts step, tick the hosts, then choose the Mode: every-host (default). Each mode deploys the components listed in Installation methods and modes.

4. Bindings. This service has no dependency: the Bindings step has nothing to bind.

5. Configure. On the Configure step, review the parameters (see Configuration parameters). Passwords left empty with a generated default are generated and sealed by the Manager.

6. Review and install. On the Install step the Manager validates the plan and shows the installation order; when it says "The plan is valid. Ready to install.", choose Install. A highly available mode is installed only when its HA checks pass.

7. Verify. The operation ends when the health checks of every instance pass (see Health checks); the service then shows as running in Services. Open the service and choose Run the smoke test in the Checks card: Scrapes the metrics and checks that the CPU, memory and file system collectors answer with values.

High availability

Cluster	per host (per-host)
High availability	per host (per-host)
Failover	none (none)
Replication	none (none)
Quorum	none (none)
Discovery	static (static)
Entry point	per host (per-host)
Official documentation	https://github.com/prometheus/node_exporter

Topology per mode

Modes	Highest catalog level	Distribution	Quorum component	Fault domains	Description
every-host	ha (ha)	per host (per-host)	-	-	One agent on every host: each host covers itself, the loss of a host only loses its own coverage.

Notes

• Each exporter reports its own host only; Prometheus alerts when an exporter stops answering.

Configuration parameters

General

Parameter	Type	Default	Allowed values	Required	Secret	Restart	Description
Metrics port (port)	port	9100	-	no	no	no	Port of /metrics.
systemd collector (systemd_collector)	bool	true	-	no	no	no	Report the state of the navin-* systemd units.
TLS (tls_enabled)	bool	false	-	no	no	no	Serve /metrics over HTTPS (--web.config.file) with a certificate issued by the manager CA; Prometheus then scrapes it in https and verifies it with that CA.

Endpoints

Endpoint	Scheme	Component	Port	Path	TLS parameter	Binding parameters	Binding secrets	Provisioning command
metrics	http	node-exporter	9100 (port)	/metrics	tls_enabled	-	-	-

Health checks

Liveness (per instance)

Component	Check	Details
node-exporter	HTTP {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn if config.tls_enabled else (host.ip or '127.0.0.1') }}:{{ config.port }}/metrics	Expected 200; 20 retries; interval 1 s; timeout 3 s

Readiness (service check)

Check	Details
HTTP {{ 'https' if config.tls_enabled else 'http' }}://{{ host.fqdn if config.tls_enabled else (host.ip or '127.0.0.1') }}:{{ config.port }}/metrics	Expected 200; Expected node_exporter_build_info

Smoke test

Scrapes the metrics and checks that the CPU, memory and file system collectors answer with values. (node-exporter: cpu, memory, filesystem)

Preflight checks

Check	Type	Meaning	Severity	Components
port_free	port_free {"param": "port"}	port 9100 free on the host	blocking	every component

Uninstall

Paths removed when the data is purged: {{ paths.log }}.

Upstream documentation

• Homepage: https://prometheus.io
• Source: https://github.com/prometheus/node_exporter
• High availability: https://github.com/prometheus/node_exporter