KTranslate Docker contêiner monitoramento de saúde

Ao executar o contêiner Docker KTranslate para Monitoramento de rede New Relic , você pode monitor a integridade do contêiner para detectar proativamente possíveis problemas.

A imagem do contêiner do KTranslate possui as configurações -tee_logs=true e -metrics=jchf disponíveis durante a execução, que permitem enviar métricas de saúde diretamente para New Relic. Eles são habilitados por padrão ao instalar o Monitoramento de rede por meio da instalação guiada New Relic . Recomendamos que você os configure ao instalar o Monitoramento de rede manualmente.

Log do KTranslate

Dica

Se quiser verificar o log localmente no host Docker , execute docker logs $CONTAINER_NAME. Por exemplo, docker logs ktranslate-snmp.

A opção -tee_logs=true envia log para New Relic ao pesquisar dispositivos. Para vê-los, faça o seguinte:

Vá para one.newrelic.com > All capabilities > Logs.
Em Find logs where, insira collector.name:"ktranslate" e clique em Query logs.

Pesquisas de log comuns

Abaixo estão algumas pesquisas comuns que podem ser usadas durante a resolução de problemas para coletar dados para suporte:

Interface de registro:

bash

$collector.name:"ktranslate" message:"*KTranslate Running -- Version*"

NRQL:

FROM Log SELECT * WHERE `collector.name` = 'ktranslate' AND `message` LIKE '%KTranslate Running -- Version%'

Resultados esperados:

bash

$KTranslate Running -- Version kt-2021-12-06-1546870234; Build Mon Dec  6 22:22:56 UTC 2021

Interface de registro:

bash

$collector.name:"ktranslate" message:"*KTranslate CLI:*"

NRQL:

FROM Log SELECT * WHERE `collector.name` = 'ktranslate' AND `message` LIKE '%KTranslate CLI:%'

Resultados esperados:

bash

$KTranslate CLI: [ktranslate -listen off -mapping /etc/ktranslate/config.json -geo /etc/ktranslate/GeoLite2-Country.mmdb -udrs /etc/ktranslate/udr.csv -api_devices /etc/ktranslate/devices.json -asn /etc/ktranslate/GeoLite2-ASN.mmdb -log_level info -snmp /snmp-base.yaml -nr_account_id=2583772 -log_level=info -metrics=jchf -tee_logs=true -service_name=snmp nr1.snmp]

Sem uma regra de análise aplicada ao seu log

Interface de registro:

bash

$collector.name:"ktranslate" message:-*\[Info\]*

NRQL:

FROM Log SELECT * WHERE `collector.name` = 'ktranslate' AND `message` NOT LIKE '%[Info]%'

Com uma regra de análise aplicada ao seu log

Interface de registro:

bash

$collector.name:"ktranslate" severity:-"Info"

NRQL:

FROM Log SELECT * WHERE `collector.name` = 'ktranslate' AND `severity` != 'Info'

Resultados esperados:

bash

$KTranslate>cisco-7513 There was an SNMP polling error with the CustomDeviceMetrics walking OID .1.3.6.1.2.1.4.31.1.1.21 after 0 retries: request timeout (after 0 retries).

Dica

O KTranslate tem os seguintes níveis de gravidade de log: Info, Warn e Error.

Interface de registro:

bash

$collector.name:"ktranslate" message:"*Match Attribute*"

NRQL:

FROM Log SELECT * WHERE `collector.name` = 'ktranslate' AND `message` LIKE '%Match Attribute%'

Resultados esperados:

bash

$KTranslate>cisco-7513 Added 1 Match Attribute(s)

Espera-se que todos os dispositivos tenham pelo menos um atributo de correspondência herdado da configuração monitor_admin_shut: true padrão. Você deve esperar que um valor 2 seja mostrado para um dispositivo ao qual você adicionou um único atributo de correspondência.

Dica

Você pode filtrar ainda mais esses resultados adicionando o nome do dispositivo à sua consulta: collector.name:"ktranslate" message:"*$DEVICE_NAME*Match Attribute*".

Métrica do KTranslate

A opção -metrics captura a seguinte métrica de desempenho ao pesquisar dispositivos:

Métrica	Granularidade	Descrição
`baseserver_healthcheck_execution_total`	Nível superior	Taxa de verificações de saúde internas. Mostra principalmente que as coisas não estão em conflito e devem sempre ser maiores que 0.
`inputq`	Nível superior	Mensagens por segundo (msg/s) recebidas nos últimos 60 segundos de todas as entradas SNMP, Flow e VPC combinadas.
`jchfq`	Nível superior	Taxa do medidor com número de buffers pré-alocados disponíveis. Deveria ser cerca de 8.000.
`delivery_metrics_nr`	Entrega para New Relic	Lotes por segundo (lotes/s) enviados nos últimos 60 segundos de todas as métricas para o New Relic.
`delivery_logs_nr`	Entrega para New Relic	Log por segundo (log/s) enviado nos últimos 60 segundos para todos os logs para New Relic.
`delivery_wins_nr`	Entrega para New Relic	Vitórias por segundo (vitórias/seg) de 200 códigos HTTP recebidos nos últimos 60 segundos do envio de métricas e eventos para New Relic.
`device_metrics`	SNMP	Pesquisas por segundo (pesquisas/s) de pesquisa SNMP nos últimos 60 segundos para métrica de nível de dispositivo.
`interface_metrics`	SNMP	Pesquisas por segundo (pesquisas/s) de pesquisa SNMP nos últimos 60 segundos para métrica de nível de interface.
`snmp_fail`	SNMP	Medidor para monitor se a pesquisa SNMP está funcionando faceada por `device_name`. Onde 1 significa bom e 2 significa fracasso.
`netflow.flows`	Netflow	Fluxos por segundo (fps) recebidos nos últimos 60 segundos para todos os dados de fluxo do dispositivo: IPFIX, NetFlow ou sFlow.
`syslog_queue`	Registro de sistema	Medidor de mensagens syslog aguardando para serem processadas.
`syslog_errors`	Registro de sistema	Erros por segundo (erros/s) nos últimos 60 segundos durante o processamento de mensagens syslog.
`syslog_messages`	Registro de sistema	Mensagens por segundo (msg/seg) recebidas nos últimos 60 segundos para todos os dados do syslog.

Pesquisas métricas comuns

Para ver essas métricas no New Relic:

Vá para one.newrelic.com > All capabilities > Query your data.
Insira uma das seguintes consultas NRQL :

FROM Metric
SELECT
latest(kentik.ktranslate.chf.kkc.baseserver_healthcheck_execution_total) AS 'healthcheck_total',
latest(kentik.ktranslate.chf.kkc.inputq) AS 'input_per_second',
latest(kentik.ktranslate.chf.kkc.jchfq) AS 'buffer'
FACET host AS 'docker_host', svc AS 'container_service'
WHERE provider = 'kentik-agent'
AND instrumentation.name = 'heartbeat'

FROM Metric
SELECT
latest(kentik.ktranslate.chf.kkc.delivery_metrics_nr) AS 'delivery_metric_batches_per_second',
latest(kentik.ktranslate.chf.kkc.delivery_logs_nr) AS 'delivery_logs_per_second',
latest(kentik.ktranslate.chf.kkc.delivery_wins_nr) AS 'delivery_wins_per_second'
FACET host AS 'docker_host', svc AS 'container_service'
WHERE provider = 'kentik-agent'
AND instrumentation.name = 'heartbeat'

FROM Metric
SELECT
latest(kentik.ktranslate.chf.kkc.device_metrics) AS 'device_polls_per_second',
latest(kentik.ktranslate.chf.kkc.interface_metrics) AS 'interface_polls_per_second'
FACET host AS 'docker_host', svc AS 'container_service'
WHERE provider = 'kentik-agent'
AND instrumentation.name = 'heartbeat'

SELECT
max(snmp_fail)
FROM (
  FROM Metric
  SELECT
  latest(kentik.ktranslate.chf.kkc.snmp_fail) AS 'snmp_fail'
  FACET host AS 'docker_host', svc AS 'container_service', device_name AS 'snmp_device'
  WHERE provider = 'kentik-agent'
  AND instrumentation.name = 'heartbeat'
)
FACET docker_host, container_service, snmp_device
WHERE snmp_fail = 2

FROM Metric
SELECT
max(kentik.ktranslate.chf.kkc.netflow) AS 'flows_per_second'
FACET host AS 'docker_host', svc AS 'container_service', device_name AS 'flow_device'
WHERE provider = 'kentik-agent'
AND instrumentation.name = 'heartbeat'

FROM Metric
SELECT
latest(kentik.ktranslate.chf.kkc.syslog_queue) AS 'syslog_queue_total',
latest(kentik.ktranslate.chf.kkc.syslog_errors) AS 'syslog_errors_per_second',
latest(kentik.ktranslate.chf.kkc.syslog_messages) AS 'syslog_messages_per_second'
FACET host AS 'docker_host', svc AS 'container_service'
WHERE provider = 'kentik-agent'
AND instrumentation.name = 'heartbeat'

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

KTranslate Docker contêiner monitoramento de saúde

Log do KTranslate

Dica

Pesquisas de log comuns

Qual versão do KTranslate estou executando?

Quais argumentos foram passados para Docker em tempo de execução?

Que erros estou enfrentando?

Dica

Meu filtro match_attributes está funcionando no meu dispositivo?

Dica

Métrica do KTranslate

Pesquisas métricas comuns

Quais são as versões atuais do meu aplicativo KTranslate?

Qual é a integridade do meu aplicativo KTranslate?

Qual é a saúde das minhas entregas na New Relic?

Qual é a integridade geral da minha coleção SNMP?

Quais dispositivos estão falhando na coleta de SNMP?

Qual é a integridade da minha coleta de dados de fluxo?

Qual é a integridade da minha coleção de syslog?

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

KTranslate Docker contêiner monitoramento de saúde

Log do KTranslate .css-21sua1{background:none;border:none;width:0;padding:0;}

Dica

Pesquisas de log comuns

Quais argumentos foram passados para Docker em tempo de execução?

Que erros estou enfrentando?

Meu filtro match_attributes está funcionando no meu dispositivo?

Métrica do KTranslate

Pesquisas métricas comuns

Quais são as versões atuais do meu aplicativo KTranslate?

Qual é a integridade do meu aplicativo KTranslate?

Qual é a saúde das minhas entregas na New Relic?

Qual é a integridade geral da minha coleção SNMP?

Quais dispositivos estão falhando na coleta de SNMP?

Qual é a integridade da minha coleta de dados de fluxo?

Qual é a integridade da minha coleção de syslog?

Log do KTranslate