---
title: SNMP walk
description: snmpwalk description.
breadcrumbs: Docs > Integrations > SNMP walk
---

# SNMP walk
Supported OS 
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

This integration provides insight into SNMP walk states in real time to:

- Visualize and monitor SNMP walk states.
- Be notified about SNMP walk failovers.

## Setup{% #setup %}

The SNMP walk check is not included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package, so you need to install it.

You can also use the [`snmp walk`](https://docs.datadoghq.com/network_monitoring/devices/troubleshooting.md?tab=linux#device-not-visible-in-datadog) command as an alternative to this integration:

```
sudo -u dd-agent datadog-agent snmp walk
```

### Installation{% #installation %}

For Agent v7.21+ / v6.21+, follow the instructions below to install the SNMP walk check on your host. See [Use Community Integrations](https://docs.datadoghq.com/agent/guide/use-community-integrations.md) to install with the Docker Agent or earlier versions of the Agent.

1. Run the following command to install the Agent integration:

   ```shell
   datadog-agent integration install -t datadog-snmpwalk==<INTEGRATION_VERSION>
   ```

1. Configure your integration similar to core [integrations](https://docs.datadoghq.com/getting_started/integrations.md).

### Configuration{% #configuration %}

1. Edit the `snmpwalk.d/conf.yaml` file in the `conf.d/` folder at the root of your [Agent's configuration directory](https://docs.datadoghq.com/agent/guide/agent-configuration-files.md#agent-configuration-directory) to start collecting your SNMP walk metrics. See the [sample snmpwalk.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/snmpwalk/datadog_checks/snmpwalk/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent).

## Validation{% #validation %}

[Run the Agent's `status` subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#service-status) and look for `snmpwalk` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

The SNMP walk integration does not include any metrics.

### Events{% #events %}

The SNMP walk check does not include any events.

### Service Checks{% #service-checks %}

The SNMP walk integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](http://docs.datadoghq.com/help).