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 --- .../apcupsd/integrations/apc_ups.md | 34 ++++++++++++++++++++++ 1 file changed, 34 insertions(+) (limited to 'src/collectors/charts.d.plugin/apcupsd') diff --git a/src/collectors/charts.d.plugin/apcupsd/integrations/apc_ups.md b/src/collectors/charts.d.plugin/apcupsd/integrations/apc_ups.md index 5e34aa7d1..fdf1ccc9e 100644 --- a/src/collectors/charts.d.plugin/apcupsd/integrations/apc_ups.md +++ b/src/collectors/charts.d.plugin/apcupsd/integrations/apc_ups.md @@ -178,6 +178,7 @@ apcupsd_update_every=5 ### Debug Mode + To troubleshoot issues with the `apcupsd` collector, run the `charts.d.plugin` with the debug option enabled. The output should give you clues as to why the collector isn't working. @@ -200,4 +201,37 @@ should give you clues as to why the collector isn't working. ./charts.d.plugin debug 1 apcupsd ``` +### Getting Logs + +If you're encountering problems with the `apcupsd` 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 apcupsd +``` + +#### 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 apcupsd /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 apcupsd +``` + -- cgit v1.2.3