prometheus-node-exporter(1)

📦
version 1.12.1 · 15 versions
, in epel 9

Hey bestie 💖 this is prometheus-node-exporter(1), version 1.12.1 — the manual for the Prometheus Node-Exporter. Yes, the header repeats the manual name and we’re folding that in like a good little group chat. Let’s get into it. 🎀

🌸 NAME

prometheus-node-exporter — The Prometheus Node-Exporter. That’s it, that’s the name. Short, iconic, and already telling you what’s up. 👑

✨ SYNOPSIS

Run it with flags like this, no cap:

prometheus-node-exporter [<flags>]

💖 DESCRIPTION

This section is empty in the original — literally zero description text. The actual tea is in OPTIONS, so keep scrolling. 🫶

🎀 OPTIONS

Okay bestie, buckle up: every flag from this part is below, with its exact name, default, and mutual-exclusion drama preserved. ✨

  • -h, --help — Shows context-sensitive help. Also try --help-long and --help-man, because this help has range. 💅
  • --collector.arp.device-include=COLLECTOR.ARP.DEVICE-INCLUDE — Regexp of arp devices to include. Heads up: this is mutually exclusive with device-exclude.
  • --collector.arp.device-exclude=COLLECTOR.ARP.DEVICE-EXCLUDE — Regexp of arp devices to exclude. Mutually exclusive with device-include.
  • --collector.arp.netlink — Use netlink to gather stats instead of /proc/net/arp. Netlink era, slay. 🦋
  • --collector.bcache.priorityStats — Exposes the expensive priority stats. It’s giving luxury scrape. 💸
  • --collector.cpu.guest — Enables metric node_cpu_guest_seconds_total.
  • --collector.cpu.info — Enables metric cpu_info.
  • --collector.cpu.info.flags-include=COLLECTOR.CPU.INFO.FLAGS-INCLUDE — Filters the flags field in cpuInfo with a value that must be a regular expression. Regex girlies rise. 🧚
  • --collector.cpu.info.bugs-include=COLLECTOR.CPU.INFO.BUGS-INCLUDE — Filters the bugs field in cpuInfo with a value that must be a regular expression.
  • --collector.diskstats.device-exclude="^(z?ram|loop|fd|(h|s|v|xv)d[a-z]|nvme\d+n\d+p)\d+$" — Regexp of diskstats devices to exclude. Mutually exclusive with device-include. That default regex is doing the absolute most, ngl.
  • --collector.diskstats.device-include=COLLECTOR.DISKSTATS.DEVICE-INCLUDE — Regexp of diskstats devices to include. Mutually exclusive with device-exclude.
  • --collector.ethtool.device-include=COLLECTOR.ETHTOOL.DEVICE-INCLUDE — Regexp of ethtool devices to include. Mutually exclusive with device-exclude.
  • --collector.ethtool.device-exclude=COLLECTOR.ETHTOOL.DEVICE-EXCLUDE — Regexp of ethtool devices to exclude. Mutually exclusive with device-include.
  • --collector.ethtool.metrics-include=".*" — Regexp of ethtool stats to include. Default is the very inclusive .*. 🫶
  • --collector.filesystem.mount-points-exclude="^/(dev|proc|run|sys|mnt|media|var/lib/docker/.+|var/lib/containers/storage/.+)($|/)" — Regexp of mount points to exclude for filesystem collector. Mutually exclusive with mount-points-include. That default regex is long af but it’s right there.
  • --collector.filesystem.mount-points-include=COLLECTOR.FILESYSTEM.MOUNT-POINTS-INCLUDE — Regexp of mount points to include for filesystem collector. Mutually exclusive with mount-points-exclude.
  • --collector.filesystem.fs-types-exclude="^(autofs|binfmt_misc|bpf|cgroup2?|configfs|debugfs|devpts|devtmpfs|fusectl|hugetlbfs|iso9660|mqueue|nsfs|overlay|proc|procfs|pstore|rpc_pipefs|securityfs|selinuxfs|squashfs|erofs|sysfs|tracefs)$" — Regexp of filesystem types to exclude for filesystem collector. Mutually exclusive with fs-types-include. Default list is huge and yes, it’s exact.
  • --collector.filesystem.fs-types-include=COLLECTOR.FILESYSTEM.FS-TYPES-INCLUDE — Regexp of filesystem types to include for filesystem collector. Mutually exclusive with fs-types-exclude.
  • --collector.hwmon.chip-include=COLLECTOR.HWMON.CHIP-INCLUDE — Regexp of hwmon chip to include. Mutually exclusive with device-exclude.
  • --collector.hwmon.chip-exclude=COLLECTOR.HWMON.CHIP-EXCLUDE — Regexp of hwmon chip to exclude. Mutually exclusive with device-include.
  • --collector.hwmon.sensor-include=COLLECTOR.HWMON.SENSOR-INCLUDE — Regexp of hwmon sensor to include. Mutually exclusive with sensor-exclude.
  • --collector.hwmon.sensor-exclude=COLLECTOR.HWMON.SENSOR-EXCLUDE — Regexp of hwmon sensor to exclude. Mutually exclusive with sensor-include.
  • --collector.infiniband.device-include=COLLECTOR.INFINIBAND.DEVICE-INCLUDE — Regexp of infiniband devices to include. Mutually exclusive with device-exclude.
  • --collector.infiniband.device-exclude=COLLECTOR.INFINIBAND.DEVICE-EXCLUDE — Regexp of infiniband devices to exclude. Mutually exclusive with device-include.
  • --collector.interrupts.name-include=COLLECTOR.INTERRUPTS.NAME-INCLUDE — Regexp of interrupts name to include. Mutually exclusive with --collector.interrupts.name-exclude.
  • --collector.interrupts.name-exclude=COLLECTOR.INTERRUPTS.NAME-EXCLUDE — Regexp of interrupts name to exclude. Mutually exclusive with --collector.interrupts.name-include.
  • --collector.interrupts.include-zeros — Include interrupts that have a zero value. Zero is still data, bestie. 💅
  • --collector.ipvs.backend-labels="local_address,local_port,remote_address,remote_port,proto,local_mark" — Comma separated list for IPVS backend stats labels. Default is that whole string, exactly.
  • --collector.netclass.ignored-devices="^$" — Regexp of net devices to ignore for netclass collector.
  • --collector.netclass.ignore-invalid-speed — Ignore devices where the speed is invalid. This will be the default behavior in 2.x. Future-default alert 🚨
  • --collector.netclass.netlink — Use netlink to gather stats instead of /proc/net/dev.
  • --collector.netclass_rtnl.with-stats — Expose the statistics for each network device, replacing netdev collector. It says what it says. 💅
  • --collector.netdev.device-include=COLLECTOR.NETDEV.DEVICE-INCLUDE — Regexp of net devices to include. Mutually exclusive with device-exclude.
  • --collector.netdev.device-exclude=COLLECTOR.NETDEV.DEVICE-EXCLUDE — Regexp of net devices to exclude. Mutually exclusive with device-include.
  • --collector.netdev.address-info — Collect address-info for every device.
  • --collector.netdev.enable-detailed-metrics — Use (incompatible) metric names that provide more detailed stats on Linux. Incompatible, bestie — not a drill.
  • --collector.netdev.netlink — Use netlink to gather stats instead of /proc/net/dev.
  • --collector.netdev.label-ifalias — Add ifAlias label.
  • --collector.netstat.fields="^(.*_(InErrors|InErrs)|Ip_Forwarding|Ip(6|Ext)_(InOctets|OutOctets)|Icmp6?_(InMsgs|OutMsgs)|TcpExt_(Listen.*|Syncookies.*|TCPSynRetrans|TCPTimeouts|TCPOFOQueue|TCPRcvQDrop)|Tcp_(ActiveOpens|InSegs|OutSegs|OutRsts|PassiveOpens|RetransSegs|CurrEstab)|Udp6?_(InDatagrams|OutDatagrams|NoPorts|RcvbufErrors|SndbufErrors))$" — Regexp of fields to return for netstat collector. That default regex is a whole mood. 🔥
  • --collector.ntp.server="127.0.0.1" — NTP server to use for ntp collector.
  • --collector.ntp.server-port=123 — UDP port number to connect to on NTP server.
  • --collector.ntp.protocol-version=4 — NTP protocol version.
  • --collector.ntp.server-is-local — Certify that collector.ntp.server address is not a public ntp server. It’s giving trust issues but make it explicit.
  • --collector.ntp.ip-ttl=1 — IP TTL to use while sending NTP query.
  • --collector.ntp.max-distance=3.46608s — Max accumulated distance to the root.
  • --collector.ntp.local-offset-tolerance=1ms — Offset between local clock and local ntpd time to tolerate.
  • --path.procfs="/proc" — procfs mountpoint.
  • --path.sysfs="/sys" — sysfs mountpoint.
  • --path.rootfs="/" — rootfs mountpoint.
  • --path.udev.data="/run/udev/data" — udev data path.
  • --collector.pcidevice.idsfile=COLLECTOR.PCIDEVICE.IDSFILE — Path to pci.ids file to use for PCI device identification.
  • --collector.pcidevice.names — Enable PCI device name resolution (requires pci.ids file).
  • --collector.perf.cpus="" — List of CPUs from which perf metrics should be collected. Default is the empty string.
  • --collector.perf.tracepoint=COLLECTOR.PERF.TRACEPOINT — perf tracepoint that should be collected.
  • --collector.perf.disable-hardware-profilers — disable perf hardware profilers.
  • --collector.perf.hardware-profilers=COLLECTOR.PERF.HARDWARE-PROFILERS — perf hardware profilers that should be collected.
  • --collector.perf.disable-software-profilers — disable perf software profilers.
  • --collector.perf.software-profilers=COLLECTOR.PERF.SOFTWARE-PROFILERS — perf software profilers that should be collected.
  • --collector.perf.disable-cache-profilers — disable perf cache profilers.
  • --collector.perf.cache-profilers=COLLECTOR.PERF.CACHE-PROFILERS — perf cache profilers that should be collected.
  • --collector.powersupply.ignored-supplies="^$" — Regexp of power supplies to ignore for powersupplyclass collector.
  • --collector.qdisc.fixtures="" — test fixtures to use for qdisc collector end-to-end testing.
  • --collector.qdisc.device-include=COLLECTOR.QDISC.DEVICE-INCLUDE — Regexp of qdisc devices to include. Mutually exclusive with device-exclude.
  • --collector.qdisc.device-exclude=COLLECTOR.QDISC.DEVICE-EXCLUDE — Regexp of qdisc devices to exclude. Mutually exclusive with device-include.
  • --collector.rapl.enable-zone-label — Enables service unit metric unit_start_time_seconds.
  • --collector.runit.servicedir="/etc/service" — Path to runit service directory.
  • --collector.slabinfo.slabs-include=".*" — Regexp of slabs to include in slabinfo collector.
  • --collector.slabinfo.slabs-exclude="" — Regexp of slabs to exclude in slabinfo collector.
  • --collector.stat.softirq — Export softirq calls per vector.
  • --collector.supervisord.url="http://localhost:9001/RPC2" — XML RPC endpoint.
  • --collector.sysctl.include=COLLECTOR.SYSCTL.INCLUDE — Select sysctl metrics to include.
  • --collector.sysctl.include-info=COLLECTOR.SYSCTL.INCLUDE-INFO — Select sysctl metrics to include as info metrics.
  • --collector.systemd.unit-include=".+" — Regexp of systemd units to include. Units must both match include and not match exclude to be included. Double filter, no cap.
  • --collector.systemd.unit-exclude=".+\.(automount|device|mount|scope|slice|target)" — Regexp of systemd units to exclude. Units must both match include and not match exclude to be included.
  • --collector.systemd.enable-task-metrics — Enables service unit tasks metrics unit_tasks_current and unit_tasks_max.
  • --collector.systemd.enable-restarts-metrics — Enables service unit metric service_restart_total.
  • --collector.systemd.enable-start-time-metrics — Enables service unit metric unit_start_time_seconds.
  • --collector.tapestats.ignored-devices="^$" — Regexp of devices to ignore for tapestats.
  • --collector.textfile.directory=/var/lib/prometheus/node-exporter — Directory to read text files with metrics from, supports glob matching. (repeatable)
  • --collector.vmstat.fields="^(oom_kill|pgpg|pswp|pg.*fault).*" — Regexp of fields to return for vmstat collector.
  • --collector.wifi.fixtures="" — test fixtures to use for wifi collector metrics.
  • --collector.arp — Enable the arp collector. Default: enabled.
  • --collector.bcache — Enable the bcache collector. Default: enabled.

...and the collector keep-going continues, bestie 💅 every single one of these is just on or off out of the box, no cap:

  • --collector.bcachefs — turns on the bcachefs collector (default: enabled).
  • --collector.bonding — turns on the bonding collector (default: enabled).
  • --collector.btrfs — turns on the btrfs collector (default: enabled).
  • --collector.buddyinfo — turns on the buddyinfo collector (default: disabled).
  • --collector.cgroups — turns on the cgroups collector (default: disabled).
  • --collector.conntrack — turns on the conntrack collector (default: enabled).
  • --collector.cpu — turns on the cpu collector (default: enabled).
  • --collector.cpu_vulnerabilities — turns on the cpu_vulnerabilities collector (default: disabled).
  • --collector.cpufreq — turns on the cpufreq collector (default: enabled).
  • --collector.diskstats — turns on the diskstats collector (default: enabled).
  • --collector.dmi — turns on the dmi collector (default: enabled).
  • --collector.dmmultipath — turns on the dmmultipath collector (default: enabled).
  • --collector.drbd — turns on the drbd collector (default: disabled).
  • --collector.drm — turns on the drm collector (default: disabled).
  • --collector.edac — turns on the edac collector (default: enabled).
  • --collector.entropy — turns on the entropy collector (default: enabled).
  • --collector.ethtool — turns on the ethtool collector (default: disabled).
  • --collector.fibrechannel — turns on the fibrechannel collector (default: enabled).
  • --collector.filefd — turns on the filefd collector (default: enabled).
  • --collector.filesystem — turns on the filesystem collector (default: enabled).
  • --collector.hwmon — turns on the hwmon collector (default: enabled).
  • --collector.infiniband — turns on the infiniband collector (default: enabled).
  • --collector.interrupts — turns on the interrupts collector (default: disabled).
  • --collector.ipvs — turns on the ipvs collector (default: enabled).
  • --collector.kernel_hung — turns on the kernel_hung collector (default: enabled).
  • --collector.ksmd — turns on the ksmd collector (default: disabled).
  • --collector.lnstat — turns on the lnstat collector (default: disabled).
  • --collector.loadavg — turns on the loadavg collector (default: enabled).
  • --collector.logind — turns on the logind collector (default: disabled).
  • --collector.mdadm — turns on the mdadm collector (default: enabled).
  • --collector.meminfo — turns on the meminfo collector (default: enabled).
  • --collector.meminfo_numa — turns on the meminfo_numa collector (default: disabled).
  • --collector.mountstats — turns on the mountstats collector (default: disabled).
  • --collector.netclass — turns on the netclass collector (default: enabled).
  • --collector.netdev — turns on the netdev collector (default: enabled).
  • --collector.netstat — turns on the netstat collector (default: enabled).
  • --collector.network_route — turns on the network_route collector (default: disabled).
  • --collector.nfs — turns on the nfs collector (default: enabled).
  • --collector.nfsd — turns on the nfsd collector (default: enabled).
  • --collector.ntp — turns on the ntp collector (default: disabled).
  • --collector.nvme — turns on the nvme collector (default: enabled).
  • --collector.nvmesubsystem — turns on the nvmesubsystem collector (default: disabled).
  • --collector.os — turns on the os collector (default: enabled).
  • --collector.pcidevice — turns on the pcidevice collector (default: disabled).
  • --collector.perf — turns on the perf collector (default: disabled).
  • --collector.powersupplyclass — turns on the powersupplyclass collector (default: enabled).
  • --collector.pressure — turns on the pressure collector (default: enabled).
  • --collector.processes — turns on the processes collector (default: disabled).
  • --collector.qdisc — turns on the qdisc collector (default: disabled).
  • --collector.rapl — turns on the rapl collector (default: enabled).
  • --collector.runit — turns on the runit collector (default: disabled).
  • --collector.schedstat — turns on the schedstat collector (default: enabled).
  • --collector.selinux — turns on the selinux collector (default: enabled).
  • --collector.slabinfo — turns on the slabinfo collector (default: disabled).
  • --collector.sockstat — turns on the sockstat collector (default: enabled).
  • --collector.softirqs — turns on the softirqs collector (default: disabled).
  • --collector.softnet — turns on the softnet collector (default: enabled).
  • --collector.stat — turns on the stat collector (default: enabled).
  • --collector.supervisord — turns on the supervisord collector (default: disabled).
  • --collector.swap — turns on the swap collector (default: disabled).
  • --collector.sysctl — turns on the sysctl collector (default: disabled).
  • --collector.systemd — turns on the systemd collector (default: enabled).
  • --collector.tapestats — turns on the tapestats collector (default: enabled).
  • --collector.tcpstat — turns on the tcpstat collector (default: disabled).
  • --collector.textfile — turns on the textfile collector (default: enabled).
  • --collector.thermal_zone — turns on the thermal_zone collector (default: enabled).
  • --collector.time — turns on the time collector (default: enabled).
  • --collector.timex — turns on the timex collector (default: enabled).
  • --collector.udp_queues — turns on the udp_queues collector (default: enabled).
  • --collector.uname — turns on the uname collector (default: enabled).
  • --collector.vmstat — turns on the vmstat collector (default: enabled).
  • --collector.watchdog — turns on the watchdog collector (default: enabled).
  • --collector.wifi — turns on the wifi collector (default: disabled).
  • --collector.xfrm — turns on the xfrm collector (default: disabled).
  • --collector.xfs — turns on the xfs collector (default: enabled).
  • --collector.zfs — turns on the zfs collector (default: enabled).
  • --collector.zoneinfo — turns on the zoneinfo collector (default: disabled).

okay now the web/server vibes, aka where your metrics actually live 🦋

  • --web.telemetry-path="/metrics" — the path where your metrics get exposed. The default is "/metrics", iconic, don't touch it if you don't have to.
  • --web.disable-exporter-metrics — excludes the metrics about the exporter itself — that's the promhttp_*, process_*, and go_* families. literally "no thoughts about myself" mode 💀
  • --web.max-requests=40 — the maximum number of parallel scrape requests. default is 40. and bestie, use 0 to disable it entirely.
  • --collector.disable-defaults — sets all collectors to disabled by default. full reset, start from zero, main character energy 🔥
  • --runtime.gomaxprocs=1 — the target number of CPUs Go will run on (GOMAXPROCS). default is 1.
  • --web.systemd-socket — uses systemd socket activation listeners instead of port listeners. Linux only, so if you're on anything else, this is not your moment 🫶
  • --web.listen-address=:9100 — the addresses where the metrics and web interface get exposed. It's repeatable for multiple addresses! Examples: :9100 or [::1]:9100 for http, and vsock://:9100 for vsock. ngl, that's several vibes.
  • --web.config.file="" — path to a configuration file that can enable TLS or authentication. default is "". See this doc for the deets:
https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md
  • --log.level=info — only log messages with this severity or above. one of: [debug, info, warn, error]. default is info.
  • --log.format=logfmt — output format of log messages. one of: [logfmt, json]. default is logfmt.
  • --version — show application version. slay, that's it.

🎀 and that's the whole page, bestie — you ate 💅 the footer down there keeps the version deets and the date, and it very cutely says node_exporter sits alongside prometheus-node-exporter(1), so like… that's the source info + version + date, all wrapped up in the bottom line the way the classic manpages do it. periodt. 🌸

📦 where this page comes from
  • epel 9: node-exporter 1.12.1-1.el9 · Apache-2.0 AND BSD-2-Clause AND BSD-2-Clause-Views AND BSD-3-Clause AND MIT AND MPL-2.0
  • 💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms