diff options
Diffstat (limited to '')
-rw-r--r-- | src/go/plugin/go.d/modules/dnsquery/integrations/dns_query.md (renamed from src/go/collectors/go.d.plugin/modules/dnsquery/integrations/dns_query.md) | 39 |
1 files changed, 37 insertions, 2 deletions
diff --git a/src/go/collectors/go.d.plugin/modules/dnsquery/integrations/dns_query.md b/src/go/plugin/go.d/modules/dnsquery/integrations/dns_query.md index fccac8b59..b081a7bbc 100644 --- a/src/go/collectors/go.d.plugin/modules/dnsquery/integrations/dns_query.md +++ b/src/go/plugin/go.d/modules/dnsquery/integrations/dns_query.md @@ -1,6 +1,6 @@ <!--startmeta -custom_edit_url: "https://github.com/netdata/netdata/edit/master/src/go/collectors/go.d.plugin/modules/dnsquery/README.md" -meta_yaml: "https://github.com/netdata/netdata/edit/master/src/go/collectors/go.d.plugin/modules/dnsquery/metadata.yaml" +custom_edit_url: "https://github.com/netdata/netdata/edit/master/src/go/plugin/go.d/modules/dnsquery/README.md" +meta_yaml: "https://github.com/netdata/netdata/edit/master/src/go/plugin/go.d/modules/dnsquery/metadata.yaml" sidebar_label: "DNS query" learn_status: "Published" learn_rel_path: "Collecting Metrics/DNS and DHCP Servers" @@ -156,6 +156,8 @@ jobs: ### Debug Mode +**Important**: Debug mode is not supported for data collection jobs created via the UI using the Dyncfg feature. + To troubleshoot issues with the `dns_query` collector, run the `go.d.plugin` with the debug option enabled. The output should give you clues as to why the collector isn't working. @@ -178,4 +180,37 @@ should give you clues as to why the collector isn't working. ./go.d.plugin -d -m dns_query ``` +### Getting Logs + +If you're encountering problems with the `dns_query` 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 dns_query +``` + +#### 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 dns_query /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 dns_query +``` + |