--- name: "prometheus-node-exporter" section: "1" platform: "linux" package: "prometheus-node-exporter" version: "1.9.0-1+b4" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/prometheus-node-exporter" --- # prometheus-node-exporter(1) Prometheus exporter for machine metrics ## NAME prometheus-node-exporter - Prometheus exporter for machine metrics ## SYNOPSIS - **prometheus-node-exporter \[\\]** ## DESCRIPTION ## OPTIONS - **-h, --help** Show context-sensitive help (also try --help-long and --help-man). - **--collector.arp.device-include=COLLECTOR.ARP.DEVICE-INCLUDE** Regexp of arp devices to include (mutually exclusive to device-exclude). - **--collector.arp.device-exclude=COLLECTOR.ARP.DEVICE-EXCLUDE** Regexp of arp devices to exclude (mutually exclusive to device-include). - **--collector.arp.netlink** Use netlink to gather stats instead of /proc/net/arp. - **--collector.bcache.priorityStats** Expose expensive priority stats. - **--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** Filter the \`flags\` field in cpuInfo with a value that must be a regular expression - **--collector.cpu.info.bugs-include=COLLECTOR.CPU.INFO.BUGS-INCLUDE** Filter the \`bugs\` field in cpuInfo with a value that must be a regular expression - **--collector.diskstats.device-exclude** Regexp of diskstats devices to exclude (mutually exclusive to device-include). - **--collector.diskstats.device-include=COLLECTOR.DISKSTATS.DEVICE-INCLUDE** Regexp of diskstats devices to include (mutually exclusive to device-exclude). - **--collector.ethtool.device-include=COLLECTOR.ETHTOOL.DEVICE-INCLUDE** Regexp of ethtool devices to include (mutually exclusive to device-exclude). - **--collector.ethtool.device-exclude=COLLECTOR.ETHTOOL.DEVICE-EXCLUDE** Regexp of ethtool devices to exclude (mutually exclusive to device-include). - **--collector.ethtool.metrics-include** Regexp of ethtool stats to include. - **--collector.filesystem.mount-points-exclude** Regexp of mount points to exclude for filesystem collector. (mutually exclusive to mount-points-include) - **--collector.filesystem.mount-points-include=COLLECTOR.FILESYSTEM.MOUNT-POINTS-INCLUDE** Regexp of mount points to include for filesystem collector. (mutually exclusive to mount-points-exclude) - **--collector.filesystem.fs-types-exclude** Regexp of filesystem types to exclude for filesystem collector. (mutually exclusive to fs-types-include) - **--collector.filesystem.fs-types-include=COLLECTOR.FILESYSTEM.FS-TYPES-INCLUDE** Regexp of filesystem types to exclude for filesystem collector. (mutually exclusive to fs-types-exclude) - **--collector.hwmon.chip-include=COLLECTOR.HWMON.CHIP-INCLUDE** Regexp of hwmon chip to include (mutually exclusive to device-exclude). - **--collector.hwmon.chip-exclude=COLLECTOR.HWMON.CHIP-EXCLUDE** Regexp of hwmon chip to exclude (mutually exclusive to device-include). - **--collector.hwmon.sensor-include=COLLECTOR.HWMON.SENSOR-INCLUDE** Regexp of hwmon sensor to include (mutually exclusive to sensor-exclude). - **--collector.hwmon.sensor-exclude=COLLECTOR.HWMON.SENSOR-EXCLUDE** Regexp of hwmon sensor to exclude (mutually exclusive to sensor-include). - **--collector.interrupts.name-include=COLLECTOR.INTERRUPTS.NAME-INCLUDE** Regexp of interrupts name to include (mutually exclusive to --collector.interrupts.name-exclude). - **--collector.interrupts.name-exclude=COLLECTOR.INTERRUPTS.NAME-EXCLUDE** Regexp of interrupts name to exclude (mutually exclusive to --collector.interrupts.name-include). - **--collector.interrupts.include-zeros** Include interrupts that have a zero value - **--collector.ipvs.backend-labels** Comma separated list for IPVS backend stats labels. - **--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. - **--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. - **--collector.netdev.device-include=COLLECTOR.NETDEV.DEVICE-INCLUDE** Regexp of net devices to include (mutually exclusive to device-exclude). - **--collector.netdev.device-exclude=COLLECTOR.NETDEV.DEVICE-EXCLUDE** Regexp of net devices to exclude (mutually exclusive to 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 - **--collector.netdev.netlink** Use netlink to gather stats instead of /proc/net/dev. - **--collector.netdev.label-ifalias** Add ifAlias label - **--collector.netstat.fields** Regexp of fields to return for netstat collector. - **--collector.ntp.server** 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 - **--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** procfs mountpoint. - **--path.sysfs** sysfs mountpoint. - **--path.rootfs** rootfs mountpoint. - **--path.udev.data** udev data path. - **--collector.perf.cpus** List of CPUs from which perf metrics should be collected - **--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 to device-exclude). - **--collector.qdisc.device-exclude=COLLECTOR.QDISC.DEVICE-EXCLUDE** Regexp of qdisc devices to exclude (mutually exclusive to device-include). - **--collector.rapl.enable-zone-label** Enables service unit metric unit\_start\_time\_seconds - **--collector.runit.servicedir** 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** 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. - **--collector.systemd.unit-exclude** 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** 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). - **--collector.bonding** Enable the bonding collector (default: enabled). - **--collector.btrfs** Enable the btrfs collector (default: enabled). - **--collector.buddyinfo** Enable the buddyinfo collector (default: disabled). - **--collector.cgroups** Enable the cgroups collector (default: disabled). - **--collector.conntrack** Enable the conntrack collector (default: enabled). - **--collector.cpu** Enable the cpu collector (default: enabled). - **--collector.cpu\_vulnerabilities** Enable the cpu\_vulnerabilities collector (default: disabled). - **--collector.cpufreq** Enable the cpufreq collector (default: enabled). - **--collector.diskstats** Enable the diskstats collector (default: enabled). - **--collector.dmi** Enable the dmi collector (default: enabled). - **--collector.drbd** Enable the drbd collector (default: disabled). - **--collector.drm** Enable the drm collector (default: disabled). - **--collector.edac** Enable the edac collector (default: enabled). - **--collector.entropy** Enable the entropy collector (default: enabled). - **--collector.ethtool** Enable the ethtool collector (default: disabled). - **--collector.fibrechannel** Enable the fibrechannel collector (default: enabled). - **--collector.filefd** Enable the filefd collector (default: enabled). - **--collector.filesystem** Enable the filesystem collector (default: enabled). - **--collector.hwmon** Enable the hwmon collector (default: enabled). - **--collector.infiniband** Enable the infiniband collector (default: enabled). - **--collector.interrupts** Enable the interrupts collector (default: disabled). - **--collector.ipvs** Enable the ipvs collector (default: enabled). - **--collector.ksmd** Enable the ksmd collector (default: disabled). - **--collector.lnstat** Enable the lnstat collector (default: disabled). - **--collector.loadavg** Enable the loadavg collector (default: enabled). - **--collector.logind** Enable the logind collector (default: disabled). - **--collector.mdadm** Enable the mdadm collector (default: enabled). - **--collector.meminfo** Enable the meminfo collector (default: enabled). - **--collector.meminfo\_numa** Enable the meminfo\_numa collector (default: disabled). - **--collector.mountstats** Enable the mountstats collector (default: disabled). - **--collector.netclass** Enable the netclass collector (default: enabled). - **--collector.netdev** Enable the netdev collector (default: enabled). - **--collector.netstat** Enable the netstat collector (default: enabled). - **--collector.network\_route** Enable the network\_route collector (default: disabled). - **--collector.nfs** Enable the nfs collector (default: enabled). - **--collector.nfsd** Enable the nfsd collector (default: enabled). - **--collector.ntp** Enable the ntp collector (default: disabled). - **--collector.nvme** Enable the nvme collector (default: enabled). - **--collector.os** Enable the os collector (default: enabled). - **--collector.perf** Enable the perf collector (default: disabled). - **--collector.powersupplyclass** Enable the powersupplyclass collector (default: enabled). - **--collector.pressure** Enable the pressure collector (default: enabled). - **--collector.processes** Enable the processes collector (default: disabled). - **--collector.qdisc** Enable the qdisc collector (default: disabled). - **--collector.rapl** Enable the rapl collector (default: enabled). - **--collector.runit** Enable the runit collector (default: disabled). - **--collector.schedstat** Enable the schedstat collector (default: enabled). - **--collector.selinux** Enable the selinux collector (default: enabled). - **--collector.slabinfo** Enable the slabinfo collector (default: disabled). - **--collector.sockstat** Enable the sockstat collector (default: enabled). - **--collector.softirqs** Enable the softirqs collector (default: disabled). - **--collector.softnet** Enable the softnet collector (default: enabled). - **--collector.stat** Enable the stat collector (default: enabled). - **--collector.supervisord** Enable the supervisord collector (default: disabled). - **--collector.sysctl** Enable the sysctl collector (default: disabled). - **--collector.systemd** Enable the systemd collector (default: enabled). - **--collector.tapestats** Enable the tapestats collector (default: enabled). - **--collector.tcpstat** Enable the tcpstat collector (default: disabled). - **--collector.textfile** Enable the textfile collector (default: enabled). - **--collector.thermal\_zone** Enable the thermal\_zone collector (default: enabled). - **--collector.time** Enable the time collector (default: enabled). - **--collector.timex** Enable the timex collector (default: enabled). - **--collector.udp\_queues** Enable the udp\_queues collector (default: enabled). - **--collector.uname** Enable the uname collector (default: enabled). - **--collector.vmstat** Enable the vmstat collector (default: enabled). - **--collector.watchdog** Enable the watchdog collector (default: enabled). - **--collector.wifi** Enable the wifi collector (default: disabled). - **--collector.xfrm** Enable the xfrm collector (default: disabled). - **--collector.xfs** Enable the xfs collector (default: enabled). - **--collector.zfs** Enable the zfs collector (default: enabled). - **--collector.zoneinfo** Enable the zoneinfo collector (default: disabled). - **--web.telemetry-path** Path under which to expose metrics. - **--web.disable-exporter-metrics** Exclude metrics about the exporter itself (promhttp\_\*, process\_\*, go\_\*). - **--web.max-requests=40** Maximum number of parallel scrape requests. Use 0 to disable. - **--collector.disable-defaults** Set all collectors to disabled by default. - **--runtime.gomaxprocs=1** The target number of CPUs Go will run on (GOMAXPROCS) - **--web.systemd-socket** Use systemd socket activation listeners instead of port listeners (Linux only). - **--web.listen-address=:9100** Addresses on which to expose metrics and web interface. Repeatable for multiple addresses. Examples: \`:9100\` or \`\[::1\]:9100\` for http, \`vsock://:9100\` for vsock - **--web.config.file** Path to configuration file that can enable TLS or authentication. See: https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md - **--log.level=info** Only log messages with the given severity or above. One of: \[debug, info, warn, error\] - **--log.format=logfmt** Output format of log messages. One of: \[logfmt, json\] - **--version** Show application version.