From 6d058baed82fa9c8b3ece957feacabd0fae444c7 Mon Sep 17 00:00:00 2001 From: Stefano Tondo Date: Thu, 22 Oct 2026 16:15:10 +0200 Subject: [PATCH 1/3] docs: pipeline: inputs: node-exporter-metrics: document scrape_on_start Signed-off-by: Stefano Tondo --- pipeline/inputs/node-exporter-metrics.md | 1 + 1 file changed, 1 insertion(+) diff --git a/pipeline/inputs/node-exporter-metrics.md b/pipeline/inputs/node-exporter-metrics.md index f5efd5da0..8a7929ef7 100644 --- a/pipeline/inputs/node-exporter-metrics.md +++ b/pipeline/inputs/node-exporter-metrics.md @@ -69,6 +69,7 @@ This helps with down-sampling when collecting metrics. | `path.rootfs` | The root filesystem mount point. | `/` | | `path.sysfs` | The path in the filesystem used to collect system metrics. | `/sys` | | `scrape_interval` | The rate in seconds at which metrics are collected from the host operating system. | `5` | +| `scrape_on_start` | Publish the first round of metrics 5 seconds after startup, instead of waiting a full `scrape_interval`. Useful with long intervals. Applies only when `scrape_interval` is greater than `2`. | `false` | | `systemd_exclude_pattern` | Regular expression to determine which units are excluded in the metrics produced by the `systemd` collector. | `.+\\.(automount\|device\|mount\|scope\|slice)` | | `systemd_include_pattern` | Regular expression to determine which units are included in the metrics produced by the `systemd` collector. | Not applied unless explicitly set. | | `systemd_include_service_task_metrics` | Determines if the collector will include service task metrics. | `false` | From 68c23c0150e3284cc9c19afff8057f2869f2f00e Mon Sep 17 00:00:00 2001 From: "Eric D. Schabell" Date: Fri, 23 Oct 2026 13:48:17 +0200 Subject: [PATCH 2/3] docs: pipeline: inputs: node-exporter-metrics: clarify scrape_on_start timing Describe scrape_on_start as a one-time publish of the current metrics five seconds after startup. Note that the first regular round is published first when scrape_interval is 3 or 4, and at the same time when it is 5. Signed-off-by: Eric D. Schabell --- pipeline/inputs/node-exporter-metrics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pipeline/inputs/node-exporter-metrics.md b/pipeline/inputs/node-exporter-metrics.md index 8a7929ef7..1647ff03c 100644 --- a/pipeline/inputs/node-exporter-metrics.md +++ b/pipeline/inputs/node-exporter-metrics.md @@ -69,7 +69,7 @@ This helps with down-sampling when collecting metrics. | `path.rootfs` | The root filesystem mount point. | `/` | | `path.sysfs` | The path in the filesystem used to collect system metrics. | `/sys` | | `scrape_interval` | The rate in seconds at which metrics are collected from the host operating system. | `5` | -| `scrape_on_start` | Publish the first round of metrics 5 seconds after startup, instead of waiting a full `scrape_interval`. Useful with long intervals. Applies only when `scrape_interval` is greater than `2`. | `false` | +| `scrape_on_start` | Publish the current metrics once, 5 seconds after startup, so the first round doesn't wait a full `scrape_interval`. Intended for long intervals. Regular publishing every `scrape_interval` is unchanged. When `scrape_interval` is `3` or `4`, the first regular round is published before this one. When it's `5`, both are published at the same time. Applies only when `scrape_interval` is greater than `2`. | `false` | | `systemd_exclude_pattern` | Regular expression to determine which units are excluded in the metrics produced by the `systemd` collector. | `.+\\.(automount\|device\|mount\|scope\|slice)` | | `systemd_include_pattern` | Regular expression to determine which units are included in the metrics produced by the `systemd` collector. | Not applied unless explicitly set. | | `systemd_include_service_task_metrics` | Determines if the collector will include service task metrics. | `false` | From 30c2bbd37553e177bd34719fd29ffc5b7825cc44 Mon Sep 17 00:00:00 2001 From: Stefano Tondo Date: Fri, 23 Oct 2026 14:53:53 +0200 Subject: [PATCH 3/3] docs: pipeline: inputs: node-exporter-metrics: scrape_on_start needs an interval above 5 Signed-off-by: Stefano Tondo --- pipeline/inputs/node-exporter-metrics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pipeline/inputs/node-exporter-metrics.md b/pipeline/inputs/node-exporter-metrics.md index 1647ff03c..6d7caacb2 100644 --- a/pipeline/inputs/node-exporter-metrics.md +++ b/pipeline/inputs/node-exporter-metrics.md @@ -69,7 +69,7 @@ This helps with down-sampling when collecting metrics. | `path.rootfs` | The root filesystem mount point. | `/` | | `path.sysfs` | The path in the filesystem used to collect system metrics. | `/sys` | | `scrape_interval` | The rate in seconds at which metrics are collected from the host operating system. | `5` | -| `scrape_on_start` | Publish the current metrics once, 5 seconds after startup, so the first round doesn't wait a full `scrape_interval`. Intended for long intervals. Regular publishing every `scrape_interval` is unchanged. When `scrape_interval` is `3` or `4`, the first regular round is published before this one. When it's `5`, both are published at the same time. Applies only when `scrape_interval` is greater than `2`. | `false` | +| `scrape_on_start` | Publish the current metrics once, 5 seconds after startup, so the first round doesn't wait a full `scrape_interval`. Intended for long intervals. Regular publishing every `scrape_interval` is unchanged. Applies only when `scrape_interval` is greater than `5`, because with a shorter interval the first regular round is already published earlier. | `false` | | `systemd_exclude_pattern` | Regular expression to determine which units are excluded in the metrics produced by the `systemd` collector. | `.+\\.(automount\|device\|mount\|scope\|slice)` | | `systemd_include_pattern` | Regular expression to determine which units are included in the metrics produced by the `systemd` collector. | Not applied unless explicitly set. | | `systemd_include_service_task_metrics` | Determines if the collector will include service task metrics. | `false` |