From c3d17e42247a010fa41c2d720aa512723bd2ef0a Mon Sep 17 00:00:00 2001 From: Alicia Thuerk Date: Tue, 11 Nov 2025 12:24:16 -0700 Subject: [PATCH 1/2] updating SNMP troubleshooting --- .../devices/troubleshooting.md | 68 +++++++++++++------ 1 file changed, 48 insertions(+), 20 deletions(-) diff --git a/content/en/network_monitoring/devices/troubleshooting.md b/content/en/network_monitoring/devices/troubleshooting.md index 04e8612d3061c..5a877c59cdae8 100644 --- a/content/en/network_monitoring/devices/troubleshooting.md +++ b/content/en/network_monitoring/devices/troubleshooting.md @@ -59,26 +59,54 @@ The output should look similar to the following: - Run an `snmp walk` on the device's admin IP to determine why the Agent cannot connect to your device. - **Note**: Provide your credentials directly in the CLI. If credentials aren't provided, the Agent attempts to locate them in your running Agent configuration files. - - **Linux**:
- SNMP v2: - ``` - sudo -u dd-agent datadog-agent snmp walk -C - ``` - SNMP v3: - ``` - sudo -u dd-agent datadog-agent snmp walk -A -a -X -x - ``` - **Windows**: - ``` - agent snmp walk [:Port] + **Note**: Provide your credentials directly in the CLI. If credentials aren't provided, the Agent attempts to locate them in your running Agent configuration files. + + Refer to your vendor specific documentation for additional information on running these commands. - Example: - agent.exe snmp walk 10.143.50.30 1.3.6 - ``` + {{< tabs >}} + {{% tab "Linux" %}} + + SNMP v2: + + ```shell + sudo -u dd-agent datadog-agent snmp walk -C + ``` - Refer to your vendor specific documentation for additional information on running these commands. + SNMP v3: + + ```shell + sudo -u dd-agent datadog-agent snmp walk -A -a -X -x + ``` + + {{% /tab %}} + {{% tab "Windows" %}} + + **Note**: Run this command as administrator from the Agent installation directory to avoid the following error: + + ```shell + Error: unable to read artifact: open C:\ProgramData\Datadog\auth_token: Access is denied. + ``` + + Navigate to the Agent installation directory: + + ```shell + cd "c:\Program Files\Datadog\Datadog Agent\bin" + ``` + + Run the SNMP walk command: + + ```shell + agent snmp walk [:Port] + ``` + + Example: + + ```shell + agent.exe snmp walk 10.143.50.30 1.3.6 + ``` + + {{% /tab %}} + {{< /tabs >}} ## Troubleshooting SNMP errors @@ -104,7 +132,7 @@ If you see a permission denied error while port binding in agent logs, the port Run `iptables -L OUTPUT` and ensure there is no deny rule: - ``` + ```shell vagrant@agent-dev-ubuntu-22:~$ sudo iptables -L OUTPUT Chain OUTPUT (policy ACCEPT) target prot opt source destination @@ -215,7 +243,7 @@ Check for any rules blocking UDP traffic on your configured ports. For example:` **Solution**: Add a net bind capability to the Agent binary, which allows the Agent to bind to reserved ports: - ``` + ```shell sudo setcap 'cap_net_bind_service=+ep' /opt/datadog-agent/bin/agent/agent ``` From 15c47dceb569ccbbb2f533014bb34d69764f76f2 Mon Sep 17 00:00:00 2001 From: Alicia Thuerk Date: Tue, 11 Nov 2025 14:30:15 -0700 Subject: [PATCH 2/2] updating per feedback --- .../en/network_monitoring/devices/troubleshooting.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/en/network_monitoring/devices/troubleshooting.md b/content/en/network_monitoring/devices/troubleshooting.md index 5a877c59cdae8..7e78e540c890d 100644 --- a/content/en/network_monitoring/devices/troubleshooting.md +++ b/content/en/network_monitoring/devices/troubleshooting.md @@ -81,12 +81,6 @@ The output should look similar to the following: {{% /tab %}} {{% tab "Windows" %}} - **Note**: Run this command as administrator from the Agent installation directory to avoid the following error: - - ```shell - Error: unable to read artifact: open C:\ProgramData\Datadog\auth_token: Access is denied. - ``` - Navigate to the Agent installation directory: ```shell @@ -103,6 +97,12 @@ The output should look similar to the following: ```shell agent.exe snmp walk 10.143.50.30 1.3.6 + ``` + + **Note**: Run this command as administrator from the Agent installation directory to avoid the following error: + + ```shell + Error: unable to read artifact: open C:\ProgramData\Datadog\auth_token: Access is denied. ``` {{% /tab %}}