• English日本語한국어
  • Log inStart now

Set up SNMP data monitoring

Set up your network devices so they send network data to New Relic.

Add SNMP data

Prerequisites and supported SNMP versions

New Relic prerequisites

  • A New Relic account. If you haven't already, sign up for free! No credit card required.
  • If you choose to install SNMP manually, you also need:
    • A New Relic account ID.
    • A New Relic .

Linux host prerequisites

If you're using linux, you need:

  • SSH access to the host
  • Access to install/remove applications and services
  • Network access as defined in the network prerequisites


To receive SNMP Traps, KTranslate must bind to UDP 162. In a host-based install, the following command will be included during the install process. When executed, KTranslate will be run with elevated privileges.

sudo setcap cap_net_bind_service=+ep /usr/bin/ktranslate

Docker prerequisites

We recommend using Kentik's ktranslate docker container to deploy SNMP monitoring. To use it, you need:

SNMP devices prerequisites

Configured network devices for SNMP polling from the ktranslate docker container. Some samples of basic SNMP configurations can be found here:

Network security prerequisites

Check the network security prerequisites for SNMP.

Supported SNMP versions

Our network monitoring container supports all major versions of SNMP (v1, v2c, and v3). Additionally, SNMP v3 has support for the following authentication and privacy settings:

Set up SNMP data monitoring in New Relic

  1. Go to one.newrelic.com > Add more data.

  2. Scroll down until you see Network and click SNMP.

  3. Follow the steps outlined in the guided installation process. You can use docker or linux.

    one.newrelic.com > Add more data > Network > SNMP to set up SNMP data monitoring.

  4. If you have a proxy, add it to the ktranslate.env file in /etc/default/ after installation, but before starting the ktranslate service. The ktranslate.env file needs to be similar to:

    KT_FLAGS="-snmp /etc/ktranslate/snmp-base.yaml \
    -metrics=jchf \
    -tee_logs=true \
    -service_name=snmp-collector \
    -snmp_discovery_on_start=true \
    -snmp_discovery_min=180 \
  5. Visualize your network performance data in New Relic.

Did this doc help with your installation?

Collection of SNMP traps

It is not necessary to run a dedicated agent for trap collection as all SNMP polling agents will run this passive listener.

Ktranslate listens for incoming SNMP traps on UDP port 1620, but you can use a port redirect in your docker run... command to redirect packets sent to UDP 162 on the host into UDP 1620 on the container

docker run -d --name ktranslate-snmp --restart unless-stopped -p 162:1620/udp \
-v `pwd`/snmp-base.yaml:/snmp-base.yaml \
kentik/ktranslate:v2 \
-snmp /snmp-base.yaml \
-nr_account_id=$YOUR_NR_ACCOUNT_ID \
-metrics=jchf \
-tee_logs=true \
-service_name=snmp \
Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.