Configurar o monitoramento de dados SNMP

Você pode usar nosso processo de instalação guiada para instalar o agente de monitoramento SNMP ou instalar o agente manualmente. Este documento aborda os pré-requisitos para iniciar o processo de instalação e um passo a passo das opções de instalação.

Pré-requisitos

Antes de começar, você precisará se inscrever em uma conta New Relic. Se você optar por instalar o agente manualmente, também precisará de:

Um ID de conta New Relic.
Uma New Relic
.

Recomenda-se implantar o agente de monitoramento SNMP como um contêiner tanto para Docker quanto para Podman. Se precisar, você pode instalá-lo alternativamente como um serviço baremetal no Linux.

Se estiver usando Linux para instalar o agente como um serviço, você precisará de:

Acesso SSH ao host
Acesso para instalar/remover aplicativos e serviços
Um destes sistemas operacionais suportados:
- CentOS 8
- Debian 12 (leitor ávido)
- Debian 11 (alvo)
- Debian 10 (Buster)
- RedHat Enterprise Linux 9
- Ubuntu 20.04 (FocalLTS)
- Ubuntu 22.04 (Jammy LTS)
- Ubuntu 23.04 (Lunar)
Importante
Para receber Traps SNMP, o agente deve vincular-se ao UDP 162. Em uma instalação baseada em host, o comando a seguir será incluído durante o processo de instalação. Quando executado, o KTranslate será executado com privilégios elevados.
sudo setcap cap_net_bind_service=+ep /usr/bin/ktranslate

Existem também pré-requisitos para o seu ambiente de rede e para os próprios dispositivos de rede.

Versões SNMP suportadas

Nosso Monitoramento de rede contêiner suporta todas as versões principais do SNMP (v1, v2c e v3), incluindo Traps e Informs. Além disso, o SNMP v3 oferece suporte para as seguintes configurações de autenticação e privacidade:

Contexto	Protocolo
Autenticação	`NoAuth`
Autenticação	`MD5`
Autenticação	`SHA`
Autenticação	`SHA224`
Autenticação	`SHA256`
Autenticação	`SHA384`
Autenticação	`SHA512`
Privacidade	`NoPriv`
Privacidade	`DES`
Privacidade	`AES`
Privacidade	`AES192`
Privacidade	`AES256`
Privacidade	`AES192C`
Privacidade	`AES256C`

Dica

Recomendamos o uso de strings/autenticação de comunidade somente leitura com SNMP.

Configure o monitoramento de dados SNMP no New Relic

Vá para one.newrelic.com > All capabilities > Add more data
Role para baixo até ver Network e clique em SNMP.
Siga as etapas descritas no processo de instalação guiada. Você pode usar Docker, Podman ou Linux.
Adicionar dados SNMP
one.newrelic.com > All capabilities > Add more data > Network > SNMP para configurar o monitoramento de dados SNMP.
Investigue os dados de desempenho da sua rede na interface New Relic .

Antes de ler sobre a instalação manual do agente SNMP, considere usar nosso processo de instalação guiada para evitar erros:

Adicionar dados SNMP

Em um host Linux com Docker instalado, faça download da imagem ktranslate executando um dos seguintes procedimentos:
- Hub Docker:
  bash
```
$docker pull kentik/ktranslate:v2
```
- Quay.io:
  bash
```
$docker pull quay.io/kentik/ktranslate:v2
```
Copie o arquivo snmp-base.yaml para o diretório local $HOME do seu usuário Docker e descarte o contêiner executando:
bash
```
$cd ~
$id=$(docker create kentik/ktranslate:v2)
$docker cp $id:/etc/ktranslate/snmp-base.yaml .
$docker rm -v $id
```
Edite o arquivo snmp-base.yaml e defina o atributo discovery.cidrs e discovery.default_communities para valores apropriados para sua rede.
Dica
Recomendamos configurar discovery.add_mibs: true para automatizar a adição de todos os MIBs descobertos no atributo global.mibs_enabled . Além disso, recomendamos configurar discovery.check_all_ips: true para evitar problemas de descoberta em dispositivos com posturas de segurança mais rígidas.
Inicie o agente Monitoramento de rede para sondar dispositivos de destino e escutar mensagens de interceptação SNMP recebidas. Substitua $CONTAINER_SERVICE por um nome exclusivo para o contêiner e substitua$YOUR_NR_LICENSE_KEY e $YOUR_NR_ACCOUNT_ID pelos seus valores:
bash
```
$docker run -d --name ktranslate-$CONTAINER_SERVICE --restart unless-stopped --pull=always -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=$CONTAINER_SERVICE \
>  -snmp_discovery_on_start=true \
>  -snmp_discovery_min=180 \
>  nr1.snmp
```
Dica
Não é necessário executar um agente dedicado para coleta de traps, pois todos os agentes de polling SNMP executarão um ouvinte passivo. Por padrão, o contêiner escutará na porta 162 (UDP) do host; mas você pode alterar o mapeamento de porta publicado no comando docker run - -p 162:1620/udp. Se quiser configurar um contêiner dedicado, você pode seguir as etapas desta seção.
Investigue os dados de desempenho da sua rede na interface New Relic .

Em um host com o Podman instalado, faça download da imagem ktranslate executando o seguinte comando:
- Hub Docker:
  bash
```
$podman pull docker.io/kentik/ktranslate:v2
```
Copie o arquivo snmp-base.yaml para o diretório local $HOME do seu usuário Podman e descarte o contêiner executando:
bash
```
$cd ~
$id=$(podman create kentik/ktranslate:v2)
$podman cp $id:/etc/ktranslate/snmp-base.yaml .
$podman rm -v $id
```
Edite o arquivo snmp-base.yaml e defina o atributo discovery.cidrs e discovery.default_communities para valores apropriados para sua rede.
Dica
Recomendamos configurar discovery.add_mibs: true para automatizar a adição de todos os MIBs descobertos no atributo global.mibs_enabled . Além disso, recomendamos configurar discovery.check_all_ips: true para evitar problemas de descoberta em dispositivos com posturas de segurança mais rígidas.
O contêiner Rootless Podman não consegue se vincular a portas abaixo de 1024. Para lidar com o redirecionamento de pacotes para mensagens trap, você precisará criar uma regra iptables para que os pacotes de destino cheguem na porta UDP 162:
bash
```
$sudo iptables -t nat -A PREROUTING -p udp --dport 162 -j REDIRECT --to-port 1620
```
Inicie o agente Monitoramento de rede para sondar dispositivos de destino e escutar mensagens de interceptação SNMP recebidas. Substitua $CONTAINER_SERVICE por um nome exclusivo para o contêiner e substitua$YOUR_NR_LICENSE_KEY e $YOUR_NR_ACCOUNT_ID pelos seus valores:
bash
```
$podman run -d --name ktranslate-$CONTAINER_SERVICE --userns=keep-id --restart unless-stopped --pull=always --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 \
>  -metrics=jchf \
>  -tee_logs=true \
>  -service_name=$CONTAINER_SERVICE \
>  -snmp_discovery_on_start=true \
>  -snmp_discovery_min=180 \
>  nr1.snmp
```
Dica
Não é necessário executar um agente dedicado para coleta de traps, pois todos os agentes de polling SNMP executarão um ouvinte passivo. Por padrão, o contêiner escutará na porta 162 (UDP) do host, mas você pode alterar o mapeamento da porta publicada no comando docker run - -p 162:1620/udp. Se quiser configurar um contêiner dedicado, você pode seguir as etapas desta seção.
Investigue os dados de desempenho da sua rede na interface New Relic .

Dependendo do seu gerenciador de pacote, use um dos comandos abaixo para instalar ktranslate

Yum:

bash

$curl -s https://packagecloud.io/install/repositories/kentik/ktranslate/script.rpm.sh | sudo bash && \
>  sudo yum install ktranslate

Apt:

bash

$curl -s https://packagecloud.io/install/repositories/kentik/ktranslate/script.deb.sh | sudo bash && \
>  sudo apt-get install ktranslate

Defina as variáveis de ambiente usadas por ktranslate:

bash

$sudo tee "/etc/default/ktranslate.env" > /dev/null <<'EOF'
$NR_ACCOUNT_ID=$YOUR_NR_ACCOUNT_ID
$NEW_RELIC_API_KEY=$YOUR_NR_LICENSE_KEY
$KT_FLAGS="-snmp /etc/ktranslate/snmp-base.yaml \
>  -metrics=jchf \
>  -tee_logs=true \
>  -service_name=$CONTAINER_SERVICE \
>  -snmp_discovery_on_start=true \
>  -snmp_discovery_min=180 \
>  nr1.snmp"
$EOF
$
$# ensure /etc/default/ktranslate.env is owned by ktranslate user
$sudo chown ktranslate:ktranslate /etc/default/ktranslate.env
$
$# Ktranslate listens for SNMP Traps on privileged port 162. Allow ktranslate to bind to this port with the following command
$sudo setcap cap_net_bind_service=+ep /usr/bin/ktranslate

Se você não tiver um arquivo de configuração snmp-base.yaml , crie um com:

bash

$sudo tee "/etc/ktranslate/snmp-base.yaml" > /dev/null <<'EOF'
$devices: {}
$trap:
$  listen: '0.0.0.0:162'
$discovery:
$  cidrs:
$    - x.x.x.x/yy
$  ignore_list: []
$  debug: false
$  ports:
$    - 161
$  default_communities:
$    - public
$  default_v3: null
$  add_devices: true
$  add_mibs: true
$  threads: 4
$  replace_devices: true
$  check_all_ips: true
$  use_snmp_v1: false
$global:
$  poll_time_sec: 300
$  mib_profile_dir: /etc/ktranslate/profiles
$  mibs_enabled:
$    - IF-MIB
$  timeout_ms: 3000
$  retries: 0
$EOF
$
$# ensure /etc/ktranslate/snmp-base.yaml is owned by ktranslate user
$sudo chown ktranslate:ktranslate /etc/ktranslate/snmp-base.yaml

Edite o arquivo snmp-base.yaml e defina o atributo discovery.cidrs e discovery.default_communities para valores apropriados para sua rede.
Dica
Recomendamos definir discovery.add_mibs: true para automatizar a adição de todos os MIBs descobertos no atributo global.mibs_enabled . Além disso, é recomendável definir discovery.check_all_ips: true para evitar problemas de descoberta em dispositivos com posturas de segurança mais rígidas.
Reinicie o serviço ktranslate para aplicar as alterações ao arquivo snmp-base.yaml :
bash
```
$sudo systemctl restart ktranslate
```
Investigue os dados de desempenho da sua rede na interface New Relic .

Instalação opcional para Traps SNMP

Em algumas circunstâncias, é benéfico isolar a coleção de mensagens trap SNMP em um contêiner dedicado. Isso é útil para controlar a escala em ambientes grandes, bem como para criar uma área de monitoramento distribuída com menor risco de interrupções completas se um contêiner falhar. Este processo não é suportado com a instalação do serviço Linux.

Observação: não é possível monitor traps v2c e v3 com o mesmo contêiner. Se quiser monitor ambas as versões de trap, você precisará lançar um contêiner secundário dedicado e configurar suas mensagens de trap para serem enviadas em uma porta não padrão. Por exemplo, se você tiver v2c traps já configurados na porta 162:

Configure suas armadilhas v3 para serem enviadas por outra porta, como 163.
Altere um pouco os argumentos do contêiner Docker, de -p 162:1620/udp para -p $src:1620/udp onde $src é a porta em que suas armadilhas v3 estão chegando.

Em um host Linux com Docker instalado, crie o arquivo de configuração que você usará para executar o contêiner:
bash
```
$tee "./traps-base.yaml" > /dev/null <<'EOF'
$devices: {}
$trap:
$  listen: '0.0.0.0:1620'
$discovery: {}
$global:
$  poll_time_sec: 300
$  timeout_ms: 30000
$EOF
```
Por padrão, o contêiner usará o endereço IP de origem como nomes de dispositivos no New Relic. Você pode controlar isso mapeando dispositivos manualmente em seu arquivo de configuração:
```
devices:
  # This key and the corresponding 'device_name'
  # need to be unique for each device
  trap_device1:
    device_name: trap_device1
    device_ip: x.x.x.x/yy
    provider: kentik-trap-device
trap:
  listen: '0.0.0.0:1620'
discovery: {}
global:
  poll_time_sec: 300
  timeout_ms: 30000
```
Dica
Você também pode controlar nomes de dispositivos fornecendo um argumento de contêiner -dns em tempo de execução. Isso permitirá que o contêiner execute uma pesquisa no endereço IP de origem e tente a resolução de nomes.

Inicie o agente Monitoramento de rede para escutar mensagens de interceptação SNMP recebidas. Substitua $CONTAINER_SERVICE por um nome exclusivo para o contêiner e substitua$YOUR_NR_LICENSE_KEY e $YOUR_NR_ACCOUNT_ID pelos seus valores:

bash

$docker run -d --name ktranslate-$CONTAINER_SERVICE --restart unless-stopped --pull=always -p 162:1620/udp \
>-v `pwd`/traps-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=$CONTAINER_SERVICE \
>  nr1.snmp

Isso iniciará um contêiner que escutará mensagens de trap SNMP na porta 162/udp.

Investigue seus resultados no New Relic consultando o tipo de evento KSnmpTrap :
```
FROM KSnmpTrap SELECT *
```
Dica
É importante lembrar que as mensagens trap SNMP são geradas pelo dispositivo de origem. Se você não estiver vendo mensagens no New Relic, certifique-se de que seus dispositivos realmente criaram mensagens. A documentação do fornecedor sobre o envio de mensagens de amostra varia, mas você pode usar o snmptrap no seu host Docker para enviar uma mensagem de teste como esta:
bash
```
$snmptrap -v 2c -c public localhost '' 1.3.6.1.4.1.8072.2.3.0.1 1.3.6.1.4.1.8072.2.3.2.1 i 123456
```

Em um host Linux com Docker instalado, crie o arquivo de configuração que você usará para executar o contêiner:
bash
```
$tee "./traps-base.yaml" > /dev/null <<'EOF'
$devices: {}
$trap:
$  listen: '0.0.0.0:1620'
$discovery: {}
$global:
$  poll_time_sec: 300
$  timeout_ms: 30000
$EOF
```
Por padrão, o contêiner usará o endereço IP de origem como nomes de dispositivos no New Relic. Você pode controlar isso mapeando dispositivos manualmente em seu arquivo de configuração:
```
devices:
  # This key and the corresponding 'device_name'
  # need to be unique for each device
  trap_device1:
    device_name: trap_device1
    device_ip: x.x.x.x/yy
    provider: kentik-trap-device
trap:
  listen: '0.0.0.0:1620'
discovery: {}
global:
  poll_time_sec: 300
  timeout_ms: 30000
```
Dica
Você também pode controlar nomes de dispositivos fornecendo um argumento de contêiner -dns em tempo de execução. Isso permitirá que o contêiner execute uma pesquisa no endereço IP de origem e tente a resolução de nomes.
O contêiner Rootless Podman não consegue se vincular a portas abaixo de 1024. Para lidar com o redirecionamento de pacotes para mensagens trap, você precisará criar uma regra iptables para que os pacotes de destino cheguem na porta UDP 162:
bash
```
$sudo iptables -t nat -A PREROUTING -p udp --dport 162 -j REDIRECT --to-port 1620
```

bash

$podman run -d --name ktranslate-$CONTAINER_SERVICE --userns=keep-id --restart unless-stopped --pull=always --net=host \
>-v `pwd`/traps-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=$CONTAINER_SERVICE \
>  nr1.snmp

Investigue seus resultados no New Relic consultando o tipo de evento KSnmpTrap :
```
FROM KSnmpTrap SELECT *
```
Dica
É importante lembrar que as mensagens trap SNMP são geradas pelo dispositivo de origem. Se você não estiver vendo mensagens no New Relic, certifique-se de que seus dispositivos realmente criaram mensagens. A documentação do fornecedor sobre o envio de mensagens de amostra varia, mas você pode usar o snmptrap no seu host Docker para enviar uma mensagem de teste como esta:
bash
```
$snmptrap -v 2c -c public localhost '' 1.3.6.1.4.1.8072.2.3.0.1 1.3.6.1.4.1.8072.2.3.2.1 i 123456
```

Qual é o próximo

Você pode configurar mais agentes para complementar seus dados SNMP:

Para obter melhor visibilidade sobre como sua rede é usada, configure o monitoramento de dados de fluxo de rede.
Para obter insights sobre mensagens do sistema dos seus dispositivos, configure a coleta de syslog de rede.

Esta tradução de máquina é fornecida para sua comodidade.

Configurar o monitoramento de dados SNMP

Pré-requisitos

Pré-requisitos de instalação Docker

Pré-requisitos de instalação do Podman

Pré-requisitos de instalação do serviço Baremetal Linux

Importante

Pré-requisitos de dispositivos SNMP

Pré-requisitos de segurança de rede

Versões SNMP suportadas

Opções de SNMP v3

Dica

Configure o monitoramento de dados SNMP no New Relic

Configuração de instalação guiada

Configuração manual do contêiner

Dica

Dica

Dica

Dica

Dica

Instalação opcional para Traps SNMP

Configuração manual de contêiner para traps SNMP

Dica

Dica

Dica

Dica

Qual é o próximo

Este documento ajudou você na instalação?

Esta tradução de máquina é fornecida para sua comodidade.

Configurar o monitoramento de dados SNMP

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Pré-requisitos de instalação do Podman

Pré-requisitos de instalação do serviço Baremetal Linux

Pré-requisitos de dispositivos SNMP

Pré-requisitos de segurança de rede

Versões SNMP suportadas

Opções de SNMP v3

Configure o monitoramento de dados SNMP no New Relic

Configuração de instalação guiada

Configuração manual do contêiner

Instalação opcional para Traps SNMP

Configuração manual de contêiner para traps SNMP

Qual é o próximo

Este documento ajudou você na instalação?

Pré-requisitos