Logs en contexte de l'agent Python

Il s'agit de l'approche la plus simple et constitue un excellent choix pour les développeurs qui n'ont peut-être pas l'accès ou l'intérêt de configurer un redirecteur de log , ou pour les comptes qui souhaitent voir la puissance des logs et autres liens métadonnées dans le contexte de leurs applications, sans beaucoup de frais généraux.

En utilisant cette option, l'agent ajoute span.id, trace.id, hostname, entity.guid et entity.name. Renseignez-vous sur les limites du transfert de log .

Il vous suffit d'installer une version d'agent avec des capacités de transfert de log (agent Python 7.12.0.176 ou supérieur). Si le transfert est désactivé, vous pouvez utiliser cette configuration :

newrelic.ini:

application_logging.enabled=true
application_logging.forwarding.enabled=true

Variable d'environnement :

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

Cette option est activée par défaut à partir de la version de l'agent 7.16.0.178.

Optional adjustments:

Une fois cette option activée, vous avez également le contrôle sur le nombre maximum de logs envoyés à New Relic chaque minute. La valeur par défaut est 10 000. Si plus de 10 000 logs sont reçus dans une fenêtre de 60 secondes, votre log commencera à être échantillonné.

Réglez-le sur un nombre plus élevé pour recevoir plus de logs. Réglez-le sur un nombre inférieur pour recevoir moins de logs. Tout entier jusqu'à 100 000 est valide.

newrelic.ini:

event_harvest_config.harvest_limits.log_event_data=10000

Variable d'environnement :

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000

Si vous disposez déjà d'une solution de transfert de loget que vous mettez à jour votre agent pour utiliser les logs automatiques dans ce contexte, assurez-vous de disable your manual log forwarder. Sinon, votre application enverra des lignes log en double. Selon votre compte, cela peut entraîner une double facturation. Pour plus d'informations, suivez les procédures pour désactiver votre redirecteur de logspécifique.

Vous avez déjà un redirecteur de logqui vous plaît ? Nous sommes là pour vous ! Les agents linguistiques peuvent décorer votre log avec les liens métadonnées nécessaires pour fournir l'accès aux logs automatiques en contexte de fonctionnalité.

Cette option ne doit pas être utilisée avec le transfert interne à l'agent. L'utilisation d'un redirecteur de logexterne pour envoyer le log à New Relic alors que le transfert interne à l'agent est activé entraînera l'envoi de votre log deux fois à New Relic. Selon votre compte, cela peut entraîner une double facturation.

Cette option ne doit pas non plus être utilisée avec le formateur de décoration log manuel. Si vous avez des références au formateur manuel dans votre base de code, veuillez les supprimer avant d'activer cette option.

1. Si vous souhaitez utiliser cette option, assurez-vous que l’option de configuration de transfert dans l’agent est désactivée.

   newrelic.ini:

   application_logging.forwarding.enabled=false

   Copier

2. Activez la décoration log dans votre configuration, puis relancez l'agent pour commencer à décorer votre log.

   newrelic.ini:

   application_logging.enabled=true
   application_logging.forwarding.enabled=false
   application_logging.local_decorating.enabled=true

   Copier

   Variable d'environnement :

   NEW_RELIC_APPLICATION_LOGGING_ENABLED: "true"
   NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED: "false"
   NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED: "true"

   Copier

   Notre décorateur ajoute cinq attributs à chaque message de log: entity.guid, entity.name, hostname, trace.id et span.id. Exemple:

   This is my log message. NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}|

   Copier

   Si le message de log est vide ou vierge, le message de sortie sera également vide. Exemple:

   NR-LINKING|{entity.guid}|{hostname}|{trace.id}|{span.id}|{entity.name}|.

   Copier

   Le message de sortie du log sera une chaîne vide.

   Certains attributs peuvent être vides si le log s'est produit en dehors d'une transaction ou s'ils ne sont pas applicables au contexte de votre application.

   Nous recommandons cette option plutôt que le formateur de décoration manuel, NewRelicContextFormatter.

Vous pouvez également utiliser notre option d'installation manuelle pour activer les logs en contexte pour APMapps monitorer par Python.

1. Assurez-vous d'avoir déjà configuré le logging dans New Relic. Cela inclut la configuration d'un redirecteur de logpris en charge qui collecte votre log d'application et étend les métadonnées qui sont transmises à New Relic.

2. Installez ou mettez à jour la dernière version de l'agent Python et activez le tracing distribué. Utilisez l'agent Python version 5.4.0 ou supérieure pour les logs en contexte.

3. Configurez les logs en contexte pour votre gestionnaire log . Avant que les agents linguistiques n'aient la capacité de transmettre et de décorer les logs, vous pouviez activer les logs en contexte en instanciant un formateur log et en l'ajoutant à votre gestionnaire log . Cet exemple utilise un StreamHandler qui par défaut écrit le log dans sys.stderr, mais n'importe quel gestionnaire peut être utilisé. Pour plus d'informations sur la configuration des gestionnaires log , consultez la documentation Python.org.

   # Import the logging module and the New Relic log formatter
   import logging
   from newrelic.agent import NewRelicContextFormatter
   
   # Instantiate a new log handler
   handler = logging.StreamHandler()
   
   # Instantiate the log formatter and add it to the log handler
   formatter = NewRelicContextFormatter()
   handler.setFormatter(formatter)
   
   # Get the root logger and add the handler to it
   root_logger = logging.getLogger()
   root_logger.addHandler(handler)

   Copier

4. Pour vérifier que vous avez correctement configuré l'appender log , exécutez votre application, puis vérifiez vos données de log dans New Relic à l'aide de l'opérateur de requête has:span.id has:trace.id.

   Si tout est configuré correctement et que vos données sont transmises à New Relic avec la métadonnées enrichie, votre log devrait maintenant être émistre en JSON et contenir les champs trace.id et span.id . Si vous ne voyez pas les données du log dans l'interface utilisateur, suivez les procédures de dépannage.