de Docker l'état du conteneur de KTranslate monitoring

Lors de l'exécution du conteneur Docker KTranslate pour le réseau monitoring New Relic, vous pouvez monitorer l'état du conteneur pour détecter de manière proactive les problèmes potentiels.

L'image conteneur KTranslate dispose des paramètres -tee_logs=true et -metrics=jchf disponibles pendant l'exécution, ce qui lui permet d'envoyer des mesures de santé directement à New Relic. Ceux-ci sont activés par défaut lors de l'installation du réseau monitoring via le guide d'installation de New Relic. Nous vous recommandons de les configurer lors de l'installation manuelle du réseau monitoring .

Logs de KTranslate

Conseil

Si vous souhaitez vérifier le log localement depuis l'hôte Docker , exécutez docker logs $CONTAINER_NAME. Par exemple, docker logs ktranslate-snmp.

Conseil

Si vous souhaitez vérifier le log localement à partir du package Linux, exécutez journalctl -u ktranslate.

L'option -tee_logs=true envoie le log à New Relic lors de l'interrogation des périphériques. Pour les voir, procédez comme suit :

Allez à one.newrelic.com > All capabilities > Logs.
Dans Find logs where, entrez collector.name:"ktranslate" et cliquez sur Query logs.

Recherches courantes log

Vous trouverez ci-dessous quelques recherches courantes qui peuvent être utilisées lors du dépannage pour collecter des données à des fins d'assistance :

interface utilisateur du log :

bash

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

NRQL:

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

Résultats attendus :

bash

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

interface utilisateur du log :

bash

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

NRQL:

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

Résultats attendus :

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]

Sans une règle d'analyse appliquée à votre log

interface utilisateur du log :

bash

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

NRQL:

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

Avec une règle d'analyse appliquée à votre log

interface utilisateur du log :

bash

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

NRQL:

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

Résultats attendus :

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).

Conseil

KTranslate a les niveaux de gravité log suivants : Info, Warn et Error.

interface utilisateur du log :

bash

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

NRQL:

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

Résultats attendus :

bash

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

Tous les appareils doivent avoir au moins 1 attribut de correspondance hérité de la configuration par défaut monitor_admin_shut: true . Vous devez vous attendre à ce qu'une valeur de 2 s'affiche pour un périphérique auquel vous avez ajouté un seul attribut de correspondance.

Conseil

Vous pouvez filtrer davantage ces résultats en ajoutant le nom de l'appareil à votre requête : collector.name:"ktranslate" message:"*$DEVICE_NAME*Match Attribute*".

Métriques de KTranslate

L'option -metrics capture les mesures de performances suivantes lors de l'interrogation des périphériques :

métrique	Granularité	Description
`baseserver_healthcheck_execution_total`	Niveau supérieur	Taux de contrôles de santé internes. Montre principalement que les choses ne sont pas bloquées et doivent toujours être supérieures à 0.
`inputq`	Niveau supérieur	Messages par seconde (msg/sec) reçus au cours des 60 dernières secondes à partir de toutes les entrées SNMP, Flow et VPC combinées.
`jchfq`	Niveau supérieur	Taux de jauge avec nombre de tampons pré-alloués disponibles. Il devrait y en avoir environ 8 000.
`delivery_metrics_nr`	Livraison à New Relic	Lots par seconde (lots/sec) envoyés au cours des 60 dernières secondes pour toutes les métriques à New Relic.
`delivery_logs_nr`	Livraison à New Relic	Logs par seconde (logs/sec) envoyé au cours des 60 dernières secondes pour tous les logs vers New Relic.
`delivery_wins_nr`	Livraison à New Relic	Gains par seconde (wins/sec) de 200 codes HTTP reçus au cours des 60 dernières secondes depuis l'envoi de métriques et d'événements à New Relic.
`device_metrics`	SNMP	Interrogations par seconde (polls/sec) d'interrogation SNMP au cours des 60 dernières secondes pour les métriques au niveau du périphérique.
`interface_metrics`	SNMP	Sondages par seconde (polls/sec) d'interrogation SNMP au cours des 60 dernières secondes pour les métriques au niveau de l'interface.
`snmp_fail`	SNMP	Jauge pour monitorer si l'interrogation SNMP fonctionne à facettes par `device_name`. Où 1 signifie bon et 2 signifie échec.
`netflow.flows`	Netflow	Débits par seconde (fps) reçus au cours des 60 dernières secondes pour toutes les données de flux de périphériques : IPFIX, NetFlow ou sFlow.
`syslog_queue`	Syslog	Jauge des messages syslog en attente de traitement.
`syslog_errors`	Syslog	Erreurs par seconde (erreurs/sec) au cours des 60 dernières secondes lors du traitement des messages syslog.
`syslog_messages`	Syslog	Messages par seconde (msg/sec) reçus au cours des 60 dernières secondes pour toutes les données syslog.

Recherches de métriques courantes

Pour voir ces métriques dans New Relic :

Allez à one.newrelic.com > All capabilities > Query your data.
Saisissez l’une des requêtes NRQL suivantes :

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'

Cette traduction automatique est fournie pour votre commodité.

de Docker l'état du conteneur de KTranslate monitoring

Logs de KTranslate

Conseil

Conseil

Recherches courantes log

Quelle version de KTranslate est-ce que j’utilise ?

Quels arguments ont été transmis à Docker lors de l’exécution ?

Quelles erreurs rencontre-je ?

Conseil

Mon filtre match_attributes fonctionne-t-il sur mon appareil ?

Conseil

Métriques de KTranslate

Recherches de métriques courantes

Quelles sont les versions actuelles de mes applications KTranslate ?

Quel est l’état de santé de mon application KTranslate ?

Quel est l'état de santé de mes livraisons à New Relic ?

Quel est l’état de santé global de ma collection SNMP ?

Quels appareils échouent à la collecte SNMP ?

Quel est l’état de santé de ma collecte de données de flux ?

Quel est l’état de santé de ma collection syslog ?

Cette traduction automatique est fournie pour votre commodité.

de Docker l'état du conteneur de KTranslate monitoring

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

Conseil

Conseil

Recherches courantes log

Quels arguments ont été transmis à Docker lors de l’exécution ?

Quelles erreurs rencontre-je ?

Mon filtre match_attributes fonctionne-t-il sur mon appareil ?

Métriques de KTranslate

Recherches de métriques courantes

Quelles sont les versions actuelles de mes applications KTranslate ?

Quel est l’état de santé de mon application KTranslate ?

Quel est l'état de santé de mes livraisons à New Relic ?

Quel est l’état de santé global de ma collection SNMP ?

Quels appareils échouent à la collecte SNMP ?

Quel est l’état de santé de ma collecte de données de flux ?

Quel est l’état de santé de ma collection syslog ?

Logs de KTranslate