• 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

Linux host prerequisites

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

callout.Host-based SNMP trap receiver

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

If deployed to Docker

  • Docker installed in a Linux host
  • Ability to launch new containers via command line

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

Direction

Source

Destination

Ports

Protocol

Outbound

Docker host only

ktranslate image on Docker Hub or Quay.io

443

TCP

Outbound

Linux or Docker host

New Relic Metric API US Endpoint: https://metric-api.newrelic.com EU Endpoint: https://metric-api.eu.newrelic.com

443

TCP

Outbound

Linux or Docker host

New Relic Event API US Endpoint: https://insights-collector.newrelic.com EU Endpoint: https://insights-collector.eu01.nr-data.net

443

TCP

Outbound

Linux or Docker host

New Relic Log API US Endpoint: https://log-api.newrelic.com EU Endpoint: https://log-api.eu.newrelic.com

443

TCP

Outbound

Linux or Docker host

Target devices for SNMP polling

161 (default)

UDP

Outbound

Linux host only

packagecloud.io for downloading rpm or deb packages (not required for Docker-based install)

443 (default)

TCP

Inbound

Source devices for SNMP Trap data

Linux or Docker host

162 (default)

UDP

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 monitoring and click SNMP.

  3. Follow the steps in New Relic.

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

  4. Visualize your network performance data in New Relic.

While you wait for your data to come in...

Did this doc help you install?

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

bash
$
docker run -d --name ktranslate-snmp --restart unless-stopped -p 162:1620/udp \
>
-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 \
>
-metrics=jchf \
>
-tee_logs=true \
>
-service_name=snmp \
>
nr1.snmp
Copyright © 2022 New Relic Inc.

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