From 38f06f1bd3cf0510780a3f2e25671e209575dbfe Mon Sep 17 00:00:00 2001 From: "Eric D. Schabell" Date: Thu, 6 Aug 2026 13:36:42 +0200 Subject: [PATCH] docs: pipeline: inputs: node-exporter-metrics: mark timex collector released in 5.1 - Update timex collector version from "Unreleased" to "5.1" - Remove dead "Collectors marked Unreleased" caveat paragraph (no other collector carries that flag) - Add timex to the Linux default metrics list and note its adjtimex(2) dependency Note, update for code changes without corresponding docs PR. Signed-off-by: Eric D. Schabell --- pipeline/inputs/node-exporter-metrics.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/pipeline/inputs/node-exporter-metrics.md b/pipeline/inputs/node-exporter-metrics.md index 45bfe2341..aa4ece995 100644 --- a/pipeline/inputs/node-exporter-metrics.md +++ b/pipeline/inputs/node-exporter-metrics.md @@ -64,7 +64,7 @@ This helps with down-sampling when collecting metrics. | `diskstats.ignore_device_regex` | Specify the regular expression for the` diskstats` to prevent collection of/ignore. | `^(ram\|loop\|fd\|(h\|s\|v\|xv)d[a-z]\|nvme\\d+n\\d+p)\\d+$` | | `filesystem.ignore_filesystem_type_regex` | Specify the regular expression for the `filesystem` types to prevent collection of or ignore. | `^(autofs\|binfmt_misc\|bpf\|cgroup2?\|configfs\|debugfs\|devpts\|devtmpfs\|fusectl\|hugetlbfs\|iso9660\|mqueue\|nsfs\|overlay\|proc\|procfs\|pstore\|rpc_pipefs\|securityfs\|selinuxfs\|squashfs\|sysfs\|tracefs)$` | | `filesystem.ignore_mount_point_regex` | Specify the regular expression for the `mount` points to prevent collection of/ignore. | `^/(dev\|proc\|run/credentials/.+\|sys\|var/lib/docker/.+\|var/lib/containers/storage/.+)($\|/)` | -| `metrics` | Specify which metrics are collected from the host operating system. The available collectors and their data sources depend on the operating system. On Linux, these metrics depend on `/procfs`, `/sysfs`, systemd, or custom files, and the actual values of metrics will be read from `/proc`, `/sys`, or systemd as needed: `cpu`, `cpufreq`, `meminfo`, `diskstats`, `filesystem`, `stat`, `loadavg`, `vmstat`, `netdev`, `netstat`, `sockstat`, `filefd`, `nvme`, and `processes` depend on `procfs`. `cpufreq`, `hwmon`, `thermal_zone`, and `powersupplyclass` depend on `sysfs`. `systemd` depends on systemd services. `textfile` requires explicit path configuration using `collector.textfile.path`. On macOS, the collectors read from native system interfaces instead of `/proc` and `/sys`: `filesystem` uses `getmntinfo`, `diskstats` and `powersupplyclass` use `IOKit`, and `cpu`, `meminfo`, `netdev`, `loadavg`, and `uname` use `sysctl` and related system calls. The default differs by operating system. | Linux: `"cpu,cpufreq,meminfo,diskstats,filesystem,uname,stat,time,loadavg,vmstat,netdev,netstat,sockstat,filefd,systemd,nvme,thermal_zone,hwmon,powersupplyclass"`. macOS: `"cpu,loadavg,meminfo,diskstats,filesystem,uname,netdev,powersupplyclass"` | +| `metrics` | Specify which metrics are collected from the host operating system. The available collectors and their data sources depend on the operating system. On Linux, these metrics depend on `/procfs`, `/sysfs`, systemd, or custom files, and the actual values of metrics will be read from `/proc`, `/sys`, or systemd as needed: `cpu`, `cpufreq`, `meminfo`, `diskstats`, `filesystem`, `stat`, `loadavg`, `vmstat`, `netdev`, `netstat`, `sockstat`, `filefd`, `nvme`, and `processes` depend on `procfs`. `cpufreq`, `hwmon`, `thermal_zone`, and `powersupplyclass` depend on `sysfs`. `systemd` depends on systemd services. `timex` depends on the `adjtimex(2)` system call. `textfile` requires explicit path configuration using `collector.textfile.path`. On macOS, the collectors read from native system interfaces instead of `/proc` and `/sys`: `filesystem` uses `getmntinfo`, `diskstats` and `powersupplyclass` use `IOKit`, and `cpu`, `meminfo`, `netdev`, `loadavg`, and `uname` use `sysctl` and related system calls. The default differs by operating system. | Linux: `"cpu,cpufreq,meminfo,diskstats,filesystem,uname,stat,time,timex,loadavg,vmstat,netdev,netstat,sockstat,filefd,systemd,nvme,thermal_zone,hwmon,powersupplyclass"`. macOS: `"cpu,loadavg,meminfo,diskstats,filesystem,uname,netdev,powersupplyclass"` | | `path.procfs` | The mount point used to collect process information and metrics. | `/proc` | | `path.rootfs` | The root filesystem mount point. | `/` | | `path.sysfs` | The path in the filesystem used to collect system metrics. | `/sys` | @@ -104,12 +104,10 @@ The Version column specifies the Fluent Bit version where the collector is avail | `textfile` | Exposes custom metrics from text files. Requires `collector.textfile.path` to be set. | Linux | 2.2.0 | | `thermal_zone` | Exposes thermal statistics from `/sys/class/thermal/thermal_zone/*`. | Linux | 2.2.1 | | `time` | Exposes the current system time. | Linux | 1.8 | -| `timex` | Exposes selected `adjtimex(2)` system call stats. | Linux | Unreleased | +| `timex` | Exposes selected `adjtimex(2)` system call stats. | Linux | 5.1 | | `uname` | Exposes system information as provided by the `uname` system call. | Linux, macOS | 1.8 | | `vmstat` | Exposes statistics from `/proc/vmstat`. | Linux | 1.8.2 | -Collectors marked `Unreleased` aren't present in any released version yet, and enabling them has no effect. The `timex` collector is tracked in [`fluent-bit#11718`](https://github.com/fluent/fluent-bit/pull/11718). - ## Threading This input always runs in its own [thread](../../administration/multithreading.md#inputs).