Agente PHP logs en el contexto

Si está utilizando un framework compatible, puede configurar el agente APM para enviar el registro de su aplicación y vincular metadatos automáticamente a New Relic. El marco soportado para el inicio de logs en el contexto automático incluye:

• Monólogo (versión 2 o 3)

  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.

  Importante

  A partir de la versión 10.3.0 del agente, la característica logging métrica y agente reenvío de logs están habilitadas de forma predeterminada.

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

  Archivo de configuración (newrelic.ini):

  newrelic.application_logging.enabled = true
  newrelic.application_logging.metrics.enabled = true
  newrelic.application_logging.forwarding.enabled = true

  Copia

  Los documentos de configuración de PHP del agente explican en detalle cómo configurar su agente, pero aquí revisaremos y vincularemos algunos de los aspectos más importantes de la configuración del registro de PHP.

  Existe una única opción para controlar si la característica de registro principal está activa:

• newrelic.application_logging.enabled

  Si está utilizando un framework de registro compatible, el agente puede enviar métricas que miden la cantidad de mensajes de registro que genera su aplicación. Puede habilitar esta característica usando la configuración newrelic.application_logging.metrics.enabled .

  Si está utilizando un framework de registro compatible y desea utilizar el agente para enviar su registro de aplicación a New Relic, puede controlarlo a través de la configuración newrelic.application_logging.forwarding configuración INI con prefijo. Las opciones disponibles son:

• enabled

• max_samples_stored

• log_level

  Si está utilizando la biblioteca de registro de Monolog (versión 2 o 3), también puede habilitar el atributo de contexto log . Esto convierte los datos de contexto de registro pasados a Monolog en el atributo New Relic . Puede controlar esta característica a través de la configuración newrelic.application_logging.forwarding.context_data configuración INI con prefijo. Las opciones disponibles son:

• enabled

• include

• exclude

  Importante

  Si ya tiene una solución de reenvío de registros 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á el doble de datos log . Dependiendo de su cuenta, esto podría resultar en una doble facturación. Para obtener más información, aprenda cómo desactivar su reenviador de registros 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.

Este método requiere que instale un reenviador de registros externo antes de habilitar el logs en el contexto. Si no tiene un reenviador de registros, la New Relic UI le indicará que utilice nuestro agente de infraestructura.

Si decide utilizar su solución de reenvío de registros existente y luego decide actualizar 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 registros específico.

Si elige utilizar la decoración log para activar el logs en el contexto para PHP, primero configure su aplicación PHP.

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 los reenvíe a New Relic.

2. Instale o actualice a la última versión de agente PHP y habilite rastreo distribuido. Utilice agente PHP versión 10.13.0.1 o superior para admitir la decoración de registros.

3. Instale Monolog versión 2 o 3.

4. Configure la decoración de registros para PHP usando la extensión Monolog.

   Para habilitar la decoración log locales:

   1. Desactivar el reenvío automático de registros:

      newrelic.application_logging.forwarding.enabled = false

      Copia

   2. Habilite la decoración log locales por parte del agente PHP:

      newrelic.application_logging.local_decorating.enabled = true

      Copia

   3. El agente PHP ahora agregará metadatos de enlace a cada log de Monolog. Para que esta información aparezca en el mensaje de registro real, es necesario configurar un formateador de Monolog para cada controlador de Monolog que incluya la especificación de formato %extra.NR-LINKING% al final del mensaje. Estos son los datos de enlace necesarios para que funcione el logs en el contexto.

      Por ejemplo:

      <?php
      use Monolog\Logger;
      use Monolog\Formatter\LineFormatter;
      use Monolog\Handler\StreamHandler;
      
      $logger = new Logger('log');
      $handler = new StreamHandler('php://stderr');
      $logfmt = "%channel%.%level_name%: %message% %extra.NR-LINKING%\n";
      $formatter = new LineFormatter($logfmt);
      $handler->setFormatter($formatter);
      $logger->pushHandler($handler);

      Copia

      Nuestro decorador agrega cinco atributos a cada log message (texto sin formato): 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.

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