El agente Python logs en el contexto

Este es el enfoque más simple y es una excelente opción para desarrolladores que quizás no tengan acceso o interés en configurar un reenviador de registros, o para cuentas que quieran ver el poder de los registros y otros metadatos de enlace en el contexto de sus aplicaciones. sin muchos gastos generales.

Al utilizar esta opción, el agente agrega span.id, trace.id, hostname, entity.guid y entity.name. Obtenga más información sobre las limitaciones del reenvío de registros.

Todo lo que necesita hacer es instalar una versión del agente con capacidades de reenvío de registros (Python agente 7.12.0.176 o superior). Si el reenvío está deshabilitado, puede usar esta configuración:

newrelic.ini:

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

Variable ambiental:

NEW_RELIC_APPLICATION_LOGGING_ENABLED=true
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

Esta opción está activada de forma predeterminada a partir de la versión 7.16.0.178 del agente.

Optional adjustments:

Una vez que esto esté habilitado, también tendrá control sobre la cantidad máxima de registros enviados a New Relic cada minuto. El valor predeterminado es 10.000. Si se reciben más de 10 000 registros en un período de 60 segundos, se comenzará a muestrear su registro.

Configúrelo en un número más alto para recibir más registros. Configúrelo en un número más bajo para recibir menos registros. Cualquier número entero hasta 100.000 es válido.

newrelic.ini:

event_harvest_config.harvest_limits.log_event_data=10000

Variable ambiental:

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED=10000

Si ya tiene una solución de reenvío de logs y está actualizando su agente para usar el logs en el contexto automático, asegúrese de disable your manual log forwarder. De lo contrario, su aplicación enviará líneas log dobles. Dependiendo de su cuenta, esto podría resultar en una doble facturación. Para obtener más información, siga los procedimientos para desactivar su reenviador de logs específico.

¿Ya tienes un reenviador de logs que te gusta? ¡Te tenemos cubierto! Language Agent puede decorar su registro con los metadatos de enlace necesarios para proporcionar acceso a la característica de contexto de inicio de sesión automático.

Esta opción no debe usarse con el reenvío dentro del agente. El uso de un reenviador de registros externo para enviar registros a New Relic mientras el reenvío en el agente está habilitado hará que su registro se envíe dos veces a New Relic. Dependiendo de su cuenta, esto puede resultar en una facturación doble.

Esta opción tampoco debe usarse con el formateador de decoración log manual. Si tiene referencias al formateador manual en su base de código, elimínelas antes de habilitar esta opción.

1. Si desea utilizar esta opción, asegúrese de tener desactivada la opción de configuración de reenvío en el agente.

   newrelic.ini:

   application_logging.forwarding.enabled=false

   Copia

2. Habilite la decoración log en su configuración, luego reinicie el agente para comenzar a decorar su tronco.

   newrelic.ini:

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

   Copia

   Variable ambiental:

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

   Copia

   Nuestro decorador agrega cinco atributos a cada mensaje de registro: entity.guid, entity.name, hostname, trace.id y span.id. Ejemplo:

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

   Copia

   Si el mensaje de log está vacío o en blanco, el mensaje de salida también estará vacío. Ejemplo:

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

   Copia

   El mensaje de log de salida será una cadena vacía.

   Algunos atributos pueden estar vacíos si el log ocurrió fuera de una transacción o si no son aplicables al contexto de su aplicación.

   Recomendamos esta opción en lugar del formateador de decoración manual, NewRelicContextFormatter.

También puede utilizar nuestra opción de instalación manual para habilitar el logs en el contexto para el monitor de aplicaciones APMmediante Python.

1. Asegúrate de haber configurado el inicio de sesión en New Relic. Esto incluye la configuración de un reenviador de registros compatible que recopile su registro de aplicación y extienda los metadatos que se reenvían a New Relic.

2. Instale o actualice a la última versión de Python agente y habilite rastreo distribuido. Utilice Python agente versión 5.4.0 o superior para logs en el contexto.

3. Configure el logs en el contexto para su controlador log . Antes de que language agente tuviera la capacidad de reenviar y decorar registros, podía habilitar el logs en el contexto creando una instancia de un formateador log y agregándolo a su controlador log . Este ejemplo utiliza un StreamHandler que de forma predeterminada escribe el registro en sys.stderr, pero se puede utilizar cualquier controlador. Para obtener más información sobre la configuración de controladores log , consulte la documentación de 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)

   Copia

4. Para verificar que haya configurado el agregador log correctamente, ejecute su aplicación, luego verifique sus datos de registro en New Relic usando el operador de consulta has:span.id has:trace.id.

   Si todo está configurado correctamente y sus datos se reenvían a New Relic con los metadatos enriquecidos, su registro ahora debería emitirse como JSON y contener los campos trace.id y span.id. Si no ve los datos log en la UI, siga los procedimientos de resolución de problemas.