node_exporter¶
Der Prometheus-Exporter für Linux-Server: liefert Werte zu CPU, Speicher, Platten, Dateisystemen und Netzwerk auf Port 9100. Unter Debian und Ubuntu heißt das Programm
prometheus-node-exporter.

Syntax¶
node_exporter [--web.listen-address=:9100] [--collector.NAME | --no-collector.NAME]
Optionen¶
| Option | Beschreibung |
|---|---|
--web.listen-address= |
Adresse und Port, Standard :9100 |
--collector.textfile.directory= |
Zusätzlich *.prom-Dateien aus diesem Verzeichnis lesen |
--collector.systemd |
Den Collector für systemd-Units einschalten (standardmäßig aus) |
--no-collector.NAME |
Einen Collector abschalten, z. B. --no-collector.wifi |
--collector.disable-defaults |
Ohne Collectors starten und dann einzelne einschalten |
--web.config.file= |
Datei mit Einstellungen für TLS und Basic Auth |
Unter Debian und Ubuntu kommen die Optionen in ARGS="…" in /etc/default/prometheus-node-exporter; danach sudo systemctl restart prometheus-node-exporter.
Beispiele¶
Ein paar Werte direkt vom Exporter:
curl -s localhost:9100/metrics | grep -E '^node_(load1|memory_MemAvailable_bytes|memory_MemTotal_bytes) '
node_load1 0.18
node_memory_MemAvailable_bytes 2.61210112e+09
node_memory_MemTotal_bytes 4.11205632e+09
Läuft der Dienst:
systemctl status prometheus-node-exporter --no-pager | head -3
● prometheus-node-exporter.service - Prometheus exporter for machine metrics
Loaded: loaded (/usr/lib/systemd/system/prometheus-node-exporter.service; enabled; preset: enabled)
Active: active (running) since Mon 2026-10-26 10:42:17 CET; 2h 11min ago
Freier Platz im Wurzeldateisystem:
curl -s localhost:9100/metrics | grep 'node_filesystem_avail_bytes.*mountpoint="/"'
node_filesystem_avail_bytes{device="/dev/sda2",device_error="",fstype="ext4",mountpoint="/"} 2.4823209984e+10
Werte stehen immer in Grundeinheiten: Bytes, Sekunden. 2.48e+10 Bytes sind etwa 23 GiB.
Ein eigener Wert über den Textfile-Collector:
echo "backup_last_success_timestamp_seconds $(date +%s)" > /tmp/backup.prom
sudo mv /tmp/backup.prom /var/lib/prometheus/node-exporter/
curl -s localhost:9100/metrics | grep ^backup_
backup_last_success_timestamp_seconds 1.793007737e+09
Eine Alarmregel wie time() - backup_last_success_timestamp_seconds > 86400 meldet dann ein Backup, das seit einem Tag nicht gelaufen ist.
Collectors, die nichts gefunden haben:
curl -s localhost:9100/metrics | grep '^node_scrape_collector_success.* 0$'
node_scrape_collector_success{collector="bonding"} 0
node_scrape_collector_success{collector="fibrechannel"} 0
node_scrape_collector_success{collector="infiniband"} 0
node_scrape_collector_success{collector="tapestats"} 0
node_scrape_collector_success{collector="zfs"} 0
0 ist hier kein Fehler: Der Server hat einfach kein Netzwerk-Bonding, kein Fibre Channel, kein InfiniBand, kein Bandlaufwerk und kein ZFS.
Wann brauche ich das?¶
- Auf jedem Server, den Prometheus überwachen soll
- Um von Hand zu prüfen, welche Werte ein Server liefert, bevor du eine Regel schreibst
- Um eigene Werte in Prometheus zu bringen, etwa den Zeitpunkt des letzten erfolgreichen Backups
Eigene Metriken mit dem Textfile-Collector
Ein Skript schreibt Zeilen wie backup_last_success_timestamp_seconds 1793007737 in eine
.prom-Datei im Textfile-Verzeichnis. Der Node Exporter liefert sie bei jedem Scrape mit:
ideal für Cronjobs. Schreib erst in eine temporäre Datei und benenne sie dann um, damit der
Exporter nie eine halbe Datei liest.
Port 9100 ist für alle offen
Der Node Exporter hat standardmäßig keine Anmeldung. Erlaube den Port nur vom
Prometheus-Server, etwa mit ufw: sudo ufw allow from 192.0.2.10 to any port 9100 proto tcp.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Paket | prometheus-node-exporter |
prometheus-node-exporter |
nicht in den Paketquellen: Release-Archiv oder Container prom/node-exporter |
prometheus-node-exporter |
| Programm und Dienst | prometheus-node-exporter |
prometheus-node-exporter |
node_exporter |
prometheus-node-exporter |
| Optionen in | /etc/default/prometheus-node-exporter |
/etc/default/prometheus-node-exporter |
eigene systemd-Unit | /etc/conf.d/prometheus-node-exporter |
Verwandte Befehle¶
prometheus · promtool · curl · systemctl