Skip to content

docs: Document benign scripts.d directory-watcher error - #23400

Draft
nedi-app[bot] wants to merge 1 commit into
masterfrom
docs/netdata-scripts-d-directory-missing-no-metrics
Draft

docs: Document benign scripts.d directory-watcher error#23400
nedi-app[bot] wants to merge 1 commit into
masterfrom
docs/netdata-scripts-d-directory-missing-no-metrics

Conversation

@nedi-app

@nedi-app nedi-app Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Document benign scripts.d directory-watcher error. Files changed: src/go/plugin/scripts.d/README.md.

User Request

No metrics are reported by the nodes and an error "start watching '/etc/netdata/scripts.d': no such file or directory" is reported on the node

Prompt (English)

Diagnose why no metrics are reported by nodes and resolve the 'start watching /etc/netdata/scripts.d: no such file or directory' error logged on the node.

Reason for Change

This change applies the specific user request using repository-truth evidence from the audit execution workspace.


Summary by cubic

Document the non-fatal "start watching '/etc/netdata/scripts.d': no such file or directory" message in scripts.d.plugin and clarify it doesn't cause missing metrics. Add a quick way to silence it by creating the directory and note that scripts.d.plugin only runs optional Nagios-style checks; investigate go.d or other collectors for "no metrics" issues.

Written for commit 4f5da83. Summary will update on new commits.

Review in cubic

…pts.d/README.md documenting the benign 'start watching '/etc/netdata/scripts.d': no such file or directory' error emitted by the file watcher when the optional user job directory is absent. Verified against source that the error is non-fatal (watch.go watchDirs() logs at error level but does not return/exit), that scripts.d.plugin runs only Nagios-style checks (main.go imports solely the nagios collector), and that no default jobs ship (stock nagios.conf is fully commented out). Clarifies the message cannot cause general 'no metrics reported' and gives an optional mkdir -p resolution.
@nedi-app nedi-app Bot added the nedi-audit PRs created by the nedi-audit pipeline label Aug 5, 2026
@github-actions github-actions Bot added area/docs area/collectors Everything related to data collection collectors/go.d area/go labels Aug 5, 2026
@sonarqubecloud

sonarqubecloud Bot commented Aug 5, 2026

Copy link
Copy Markdown

@ilyam8

ilyam8 commented Aug 5, 2026

Copy link
Copy Markdown
Member

I think this watch functionality should just be removed. If we decide to support it, it should be implemented consistently across all go plugins in the agent, not just one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/collectors Everything related to data collection area/docs area/go collectors/go.d nedi-audit PRs created by the nedi-audit pipeline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant