Set up SNMP data monitoring

If you prefer to do the setup manually, proceed with the following steps.

1. On a Linux host with Docker installed, download the ktranslate image by running one of the following:

   • Docker Hub
     bash

     Copy

     $
     docker pull kentik/ktranslate:v2

   • Quay.io
     bash

     Copy

     $
     docker pull quay.io/kentik/ktranslate:v2

2. Copy the snmp-base.yaml file to the local $HOME directory of your Docker user, and discard the container by running

   bash

   Copy

   $
   cd .
   $
   id=$(docker create kentik/ktranslate:v2)
   $
   docker cp $id:/etc/ktranslate/snmp-base.yaml .
   $
   docker rm -v $id

3. Edit the snmp-base.yaml file and define the discovery.cidrs and discovery.default_communities attributes to appropriate values for your network.

   Tip

   We recommend to set discovery.add_mibs: true to automate the addition of all discovered MIBs into the global.mibs_enabled attribute.

4. Launch a short-lived container to execute discovery by running

   bash

   Copy

   $
   docker run -ti --name ktranslate-discovery --rm --net=host \
   >
   --user `id -u`:`id -g` \
   >
   -v `pwd`/snmp-base.yaml:/snmp-base.yaml \
   >
   kentik/ktranslate:v2 \
   >
       -snmp /snmp-base.yaml \
   >
       -log_level info \
   >
       -snmp_discovery=true

   After the discovery run finishes, you should see an output similar to the following:

   bash

   Copy

   $
   >[Info] KTranslate Adding 3 new snmp devices to the config, 0 replaced from 3
   $
   # In this example, the discovery run found 3 new SNMP devices.

   The discovered devices are listed in the snmp-base.yaml file's devices.{} section. By default, only the IF-MIB mib is polled. You can manually add other mibs to the global.mibs_enabled attribute if you did not set discovery.add_mibs: true before running the discovery.

5. Run ktranslate to poll target devices by running:

   bash

   Copy

   $
   docker run -d --name ktranslate-snmp --restart unless-stopped --net=host \
   >
   -v `pwd`/snmp-base.yaml:/snmp-base.yaml \
   >
   -e NEW_RELIC_API_KEY=$YOUR_NR_LICENSE_KEY  \
   >
   kentik/ktranslate:v2 \
   >
     -snmp /snmp-base.yaml \
   >
     -nr_account_id=$YOUR_NR_ACCOUNT_ID \
   >
     ## If your account is located in Europe, add the following flag:
   $
     ## -nr_region=EU \
   $
     ## If you want to use FedRAMP, add the following flag to use the FedRAMP authorized endpoints:
   $
     ## -nr_region=GOV \
   $
     -metrics=jchf \
   >
     -tee_logs=true \
   >
     -service_name=snmp \
   >
     nr1.snmp

6. To get better visibility into how your network is being used, set up network flow data monitoring.

7. To get insights into system messages from your devices, setup network syslog collection.

8. Visualize your network performance data in New Relic.