From f09848204fa5283d21ea43e262ee41aa578e1808 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 26 Aug 2024 10:15:24 +0200 Subject: Merging upstream version 1.47.0. Signed-off-by: Daniel Baumann --- integrations/templates/troubleshooting.md | 37 +++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) (limited to 'integrations/templates') diff --git a/integrations/templates/troubleshooting.md b/integrations/templates/troubleshooting.md index f78d49a7f..2176dd010 100644 --- a/integrations/templates/troubleshooting.md +++ b/integrations/templates/troubleshooting.md @@ -4,6 +4,10 @@ ### Debug Mode +[% if entry.meta.plugin_name == 'go.d.plugin' %] +**Important**: Debug mode is not supported for data collection jobs created via the UI using the Dyncfg feature. +[% endif %] + To troubleshoot issues with the `[[ entry.meta.module_name ]]` collector, run the `[[ entry.meta.plugin_name ]]` with the debug option enabled. The output should give you clues as to why the collector isn't working. @@ -42,6 +46,39 @@ should give you clues as to why the collector isn't working. ``` [% endif %] +### Getting Logs + +If you're encountering problems with the `[[ entry.meta.module_name ]]` collector, follow these steps to retrieve logs and identify potential issues: + +- **Run the command** specific to your system (systemd, non-systemd, or Docker container). +- **Examine the output** for any warnings or error messages that might indicate issues. These messages should provide clues about the root cause of the problem. + +#### System with systemd + +Use the following command to view logs generated since the last Netdata service restart: + +```bash +journalctl _SYSTEMD_INVOCATION_ID="$(systemctl show --value --property=InvocationID netdata)" --namespace=netdata --grep [[ entry.meta.module_name ]] +``` + +#### System without systemd + +Locate the collector log file, typically at `/var/log/netdata/collector.log`, and use `grep` to filter for collector's name: + +```bash +grep [[ entry.meta.module_name ]] /var/log/netdata/collector.log +``` + +**Note**: This method shows logs from all restarts. Focus on the **latest entries** for troubleshooting current issues. + +#### Docker Container + +If your Netdata runs in a Docker container named "netdata" (replace if different), use this command: + +```bash +docker logs netdata 2>&1 | grep [[ entry.meta.module_name ]] +``` + [% else %] [% if entry.troubleshooting.problems.list %] ## Troubleshooting -- cgit v1.2.3