New Relic Metric API
US Endpoint: https://metric-api.newrelic.com
EU Endpoint: https://metric-api.eu.newrelic.com
443
TCP
Outbound
Docker host
New Relic Log API
US Endpoint: https://log-api.newrelic.com
EU Endpoint: https://log-api.eu.newrelic.com
443
TCP
Outbound
Docker host
Target devices for SNMP polling
161 (default)
UDP
Inbound
Source devices for SNMP Trap data
Docker host
162 (default)
UDP
Supported SNMP versions
Our NPM container supports all major versions of SNMP (v1, v2c, and v3). Additionally, SNMP v3 has support for the following authentication and privacy settings:
Setting
Protocol
Authentication
NoAuth
Authentication
MD5
Authentication
SHA
Authentication
SHA224
Authentication
SHA256
Authentication
SHA384
Authentication
SHA512
Privacy
NoPriv
Privacy
DES
Privacy
AES
Privacy
AES192
Privacy
AES256
Privacy
AES192C
Privacy
AES256C
ヒント
We recommend using read-only community strings/authentication with SNMP.
Copy the snmp-base.yaml file to the local $HOME directory of your Docker user, and discard the container by running
bash
$
cd.
$
id=$(docker create kentik/ktranslate:v2)
$
docker cp$id:/etc/ktranslate/snmp-base.yaml .
$
docker rm -v $id
Edit the snmp-base.yaml file and define the discovery.cidrs and discovery.default_communities attributes to appropriate values for your network.
ヒント
We recommend to set discovery.add_mibs: true to automate the addition of all discovered MIBs into the global.mibs_enabled attribute.
Launch a short-lived container to execute discovery by running
bash
$
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
$
>[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.
Run ktranslate to poll target devices by running:
bash
$
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: