The Autodiscovery module runs as a stand-alone script, that will take a set of parameters and use them to scan given subnets for SNMP devices. It will then add any known OID's and appropriate tags to the Datadog SNMP conf.yaml so that the Datadog agent can start polling those OID's.
Download the Autodiscovery package
Install it on the server that will be used as a SNMP Poller
Generate a Datadog API and App key
discovery.yaml file to scan the appropriate subnets, Datadog, and RapDev Keys
Start the SNMP scans and use the Metrics Explorer in Datadog to verify the correct metrics
Once downloaded, you can run the installer to extract all the files by selecting the destination folder and clicking Install.
After the installer is completed, navigate to your installation folder and you should see the following files.
discovery.default.yamlusing your editor of choice and save it to the folder as
The first block is the SNMP and Subnet configurations:
snmp_subnet_config:- subnet:snmp:- udp_port:snmp_version: 3auth_name:auth_key:private_key:auth_protocol:priv_protocol:blacklisted_hosts: tags: - subnet:snmp:- udp_port: 161community_string: publicsnmp_version: 2blacklisted_hosts: tags: 
subnet: Accepts a list of subnets the format of
10.1.1.0/24, where the IP is following by the Subnet Mask. The list must be delineated using a comma, eg:
snmp: Accepts all the SNMP configuration variables. Each Subnet block must have its own SNMP configuration defined.
blacklisted_hosts: Accepts a list of host IPs delineated by a comma, eg:
tags: Accepts a list of strings, that will be added as tags to all metrics discovered and created on this subnet. eg:
tags: [aws-region-east1, storage-network, cisco-devices]
The next block of configuration is the utility variables defined as follows
snmp_utils_config:- timeout: 3retries: 5discovery_frequency: 1
Timeout: This is defined in seconds, and is used as a timeout variable when discovering new OID's
Retries: Number of times to retry the same OID before failing that OID
Discovery Frequency: The interval in hours for how frequently to auto-discovery the subnets defined. This is not the polling frequency. By default, Datadog has a polling frequency of 15 seconds per metric.
rapdev:- token:datadog:- key:app:api_url:
RapDev Token: This is the token provided to you by the Sign-Up email. If you have not received one, please click here to generate a new token.
Datadog API Key: You can generate this from your Datadog account. Click here for more details
Datadog APP Key: You can generate this from your Datadog account. Click here for more details
discovery.yaml config file
snmp_subnet_config:- subnet: 10.81.45.102/32snmp:- udp_port: 161snmp_version: 3auth_name: rapdevauth_key: shashashaprivate_key: aesaesaesauth_protocol: SHApriv_protocol: AESblacklisted_hosts: tags: [datacenter:boston, zone:1a]- subnet: [10.67.36.0/24, 10.10.24.0/24]snmp:- udp_port: 161snmp_version: 2community_string: publicblacklisted_hosts: tags: [datacenter:chicago, zone:1b]- subnet: 10.121.39.0/24snmp:- udp_port: 161snmp_version: 2auth_name: rapdevcommunity_string: publicblacklisted_hosts: tags: [datacenter:virginia, zone:1c]snmp_utils_config:- timeout: 3retries: 5discovery_frequency: 1rapdev:- token: d83aba1df7c39ee57135bb958d #sample hash, does not workdatadog:- key: e34d013b93d5cd4cdf5b50e17e #sample hash, does not workapp: da834e60225b35726ae468deed #sample hash, does not workapi_url: https://api.datadoghq.eu #only set this if you are using the EU Datadog application
Once your YAML is configured, you can install and start the service. To do so, open a
command prompt as administrator, and run the following command:
If the service is installed correctly and starts running, you should see:
C:\DD-SNMP> .\dd-snmp-install-service.batService "dd-snmp-autodiscovery" installed successfully!The RapDev DD SNMP Auto-Discovery service is starting.The RapDev DD SNMP Auto-Discovery service was started successfully.
One you have configured and started the poller, you should start seeing the metrics in the Datadog Metrics Explorer. All metrics discovered and polled will have the following naming convention:
Once you have verified that the metrics are added and being discovered, you can navigate to the Dashboards and find the auto-generated Dashboards for all discovered hardware. The dashboards will have the following naming conventions:
[Model] - Dashboard
If you're having trouble setting up the integration, please feel free to start a Chat with us or send us an email at email@example.com.