Générer un log pour le dépannage de l'agent infrastructure

Problème

Lors du dépannage de votre agent infrastructure , générez un log debug pendant quelques minutes pour rechercher et étudier les erreurs. Cela peut être utile pour votre propre dépannage ou lorsque vous travaillez avec le support New Relic.

Important

Le logging détaillé génère beaucoup de données très rapidement. Une fois la génération du log terminée, assurez-vous de définir level: info (ou moins) pour réduire la consommation d'espace disque et l'ingestion de données lors du transfert du log vers New Relic.

Vous pouvez automatiser ce processus en utilisant la commande newrelic-infra-ctl . Pour plus d'informations, consultez la documentation binaire de dépannage.

Solution

La génération du fichier log debug nécessite la modification de votre fichier configuration . Pour un exemple de fichier de configuration qui inclut tous les paramètres applicables, consultez l' exemple de modèle. Pour générer un log détaillé :

Étape	Procédures
	Modifiez votre fichier `newrelic-infra.yml` avec les paramètres de logging : `log: level: debug file: /path/to/logfile.log` Activer le logging de débogage : `level: debug`. (Si vous utilisez un agent d’infrastructure conteneurisé sur CoreOS, consultez les notes spécifiques au système.) Définissez `file` sur un emplacement de fichier de log pratique. Redémarrez l'agent afin qu'il remarque les nouveaux paramètres.
	Laissez votre hôte fonctionner à charge normale pendant environ trois minutes pour générer suffisamment de données de logging.
	Rétablir les paramètres par défaut : Désactivez le logging détaillé en définissant `level: info` dans `newrelic-infra.yml`. Facultatif : désactivez le logging dans un fichier personnalisé en supprimant la ligne `file` de la section `log` dans `newrelic-infra.yml`. Redémarrez l'agent afin qu'il remarque les nouveaux paramètres.
	Examinez le fichier de log pour détecter les erreurs. Si vous devez envoyer votre fichier de log au support New Relic : Incluez la ligne dans votre fichier de log qui contient la version de l'agent : `New Relic infrastructure agent version X.YY.ZZZ` Joignez le fichier de log à votre ticket d'assistance, accompagné de votre `newrelic-infra.yml`.

Mode verbeux intelligent

Parfois, les erreurs ne se produisent qu’après un certain temps. Cela rend le débogage difficile, car généralement les logs détaillés ne sont activés que pendant une courte période ; sinon, il y aura de nombreux logs de débogage. Par exemple, si une erreur se produit une heure après le démarrage de l’agent infrastructure , obtenir le log de débogage au moment de l’erreur peut être délicat ou peu pratique.

À partir de l'agent infrastructure v1.9.0 ou supérieur, vous pouvez utiliser le mode verbeux intelligent pour le log. Le mode verbeux intelligent enregistre uniquement les messages de débogage les plus récents après qu'une erreur a été enregistrée. Cela vous permet de laisser le mode verbeux intelligent s'exécuter jusqu'à ce qu'une erreur se produise, sans enregistrer de nombreux messages de débogage non pertinents, et en enregistrant uniquement les messages de débogage les plus récents. (Le nombre de messages est déterminé par votre configuration.)

Pour plus d'informations sur le mode verbeux intelligent, consultez la documentation sur le comportement du logging de l'agent d'infrastructure et utilisez la documentation sur les paramètres de configuration de l'infrastructure pour plus de détails sur l'activation du mode verbeux intelligent.

Transférer le log de l'agent vers New Relic

L'agent infrastructure peut être configuré pour envoyer son propre log à New Relic. Cela peut être utile pour les problèmes de dépannage avec le transfert de log , l'agent infrastructure ou lors de la prise de contact avec le support.

Pour plus de détails sur la façon d'activer le transfert de logpour l'agent infrastructure , voir Résoudre les problèmes de transfert de log.

Notes pour un système spécifique

Voici quelques notes et exigences supplémentaires pour un système spécifique, utilisées pour compléter les instructions générales de logging:

Si vous utilisez un agent d’infrastructure conteneurisé :

Choisissez l'une de ces options pour modifier le niveau de log en verbeux :
- Recommandé : définissez la variable d’environnement NRIA_LOG_LEVEL sur debug. L'exécution de ceci sur la ligne de commande ressemblerait à :
  bash
```
$-e NRIA_LOG_LEVEL=debug
```
  OU
- Modifiez le fichier de configuration pour définir level: debug dans la section log . (La modification du fichier de configuration dans un conteneur n'est pas recommandée, car elle nécessite de reconstruire l'image deux fois : une fois pour ajouter un logging détaillé et une fois pour le supprimer.)

Utilisez journalctl pour collecter le log :

bash

$journalctl -u newrelic-infra > newrelic-infra.log

Remettez le niveau de logging sur info ou warn après avoir collecté le log pendant quelques minutes.

Cette traduction automatique est fournie pour votre commodité.

Générer un log pour le dépannage de l'agent infrastructure

Problème

Important

Solution

Mode verbeux intelligent

Transférer le log de l'agent vers New Relic

Notes pour un système spécifique

Agent conteneurisé

Cette traduction automatique est fournie pour votre commodité.

Générer un log pour le dépannage de l'agent infrastructure

Problème.css-21sua1{background:none;border:none;width:0;padding:0;}

Important

Solution

Mode verbeux intelligent

Transférer le log de l'agent vers New Relic

Notes pour un système spécifique

Problème