Logs en el contexto del agente Node.js

Con nuestro agente APM de Node.js, puede obtener APMlog in context, lo que le permite ver el registro de su aplicación en el contexto de sus otros datos New Relic . Para obtener información general sobre esta característica, consulte logs en el contextoAPM .

Opciones de logs en el contexto automático

Con el registro de aplicaciones, su agente APM recopila y contextualiza automáticamente su registro.

Si está utilizando un framework compatible, tiene tres opciones para configurar el logs en el contexto 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:

• Winston 3.0.0 o mas alto.
• Pino 7.0.0 o superior.
• Bunyan 1.8.12 o superior (desde la versión del agente 9.3.0)

Si no está utilizando un framework compatible, puede utilizar el método API de reenvío de registros del agente para realizar su propia instrumentación. Para obtener más información, consulte los documentos de la API del agente de Node.js.

application_logging: {
  forwarding: {
    enabled: true
  }
}

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED=true

application_logging: {
  forwarding: {
    max_samples_stored: 10000
  }
}

NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED: 10000

Asegure sus datos

Su registro puede incluir información confidencial protegida por HIPAA u otros protocolos de cumplimiento. De forma predeterminada, ofuscamos los patrones numéricos que parecen corresponder a elementos como tarjetas de crédito o números de Seguro Social, pero es posible que deba aplicar hash o enmascarar información adicional.

Para más información, consulta nuestra documentación sobre expresión de ofuscación y reglas. Puede hash o enmascarar sus log datos utilizando la New Relic UI o utilizando NerdGraph, nuestra GraphQL.API

Explora tus datos

Para aprovechar al máximo sus datos de registro:

• En la páginaAPM Summary , haga clic en su gráfico Web transaction time para ver el registro asociado con un momento específico.
• Verifique Errors inbox de su aplicación para ver el registro asociado con sus errores.
• Utilice rastreo distribuido para ver el registro asociado a la traza individual.
• Explore más datos de registro en su plataforma con nuestra UI de logs.
• Configure alertas basadas en la salida log y la gravedad.
• consulte sus datos utilizando nuestra UI especializada para registrar datos y cree un panel con los resultados.

Consejos de resolución de problemas

Normalmente, su registro comenzará a aparecer menos de un minuto después de habilitar el inicio de APMlogs en el contexto. Consulta la sección Triage > Logs de tu aplicación. Allí también comenzará a ver patrones de registros relacionados con el error.

Si no ve ningún registro de errores o traza, es posible que no haya ninguno para su aplicación. Intente actualizar la página UI o cambie el período de tiempo seleccionado.

Deshabilitar el registro automático

El logs en el contexto APM reenvía automáticamente los datos log de APM del agente. Está habilitado de forma predeterminada. Si habilita el registro de aplicaciones, puede tener un impacto negativo en su seguridad, cumplimiento, facturación o rendimiento del sistema. Para obtener más información, o si necesita ajustar la configuración predeterminada, siga los procedimientos para desactivar el registro automático.

Opción de logs en el contexto manual

Para habilitar el logs en el contexto para el monitor de aplicaciones APMde Node.js, puede utilizar nuestra opción de instalación manual.

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 Node.js agente y habilite rastreo distribuido. Utilice Node.js agente versión 6.2.0 o superior para logs en el contexto.

3. Instale un framework compatible para enriquecer sus datos log o utilice directamente la API de reenvío de registros del agente.

4. En la configuración de su agente, establezca application_config.enabled en false. (De lo contrario, el agente automáticamente instrumentará su logger y llamar a estos enriquecedores usted mismo no hará nada).

5. Configure el logs en el contexto para Node.js utilizando la extensión log adecuada.

   Configuración de Node.js con Winston

   1. Para instalar el enriquecedor log de Winston, ingrese el siguiente comando en su terminal o interfaz de línea de comando:

      bash

      Copia

      $
      npm install @newrelic/winston-enricher

   2. En el código de su aplicación, actualice su configuración de registro para agregar newrelicFormatter:

      // index.js
      require('newrelic')
      const winston = require('winston')
      const newrelicFormatter = require('@newrelic/winston-enricher')(winston)

      Copia

      El Formateador de New Relic se puede utilizar individualmente o combinado con otros formateadores como formato final.

      format: winston.format.combine(
        winston.format.label({label: 'test'}),
        newrelicFormatter()
      )

      Copia

   Configuración de Node.js con Pino

   1. Para instalar Pino log enricher, ingrese el siguiente comando en su terminal o interfaz de línea de comando:

      bash

      Copia

      $
      npm install @newrelic/pino-enricher

   2. En el código de su aplicación, actualice su configuración de registro para agregar el complemento New Relic Pino:

      // index.js
      require('newrelic')
      const nrPino = require('@newrelic/pino-enricher')
      const pino = require('pino')
      const logger = pino(nrPino())

      Copia

      El Formateador de New Relic se puede utilizar individualmente o combinado con otros formateadores como formato final.

6. 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. Si desea ver un ejemplo funcional de logs en el contexto, eche un vistazo a nuestra aplicación de ejemplo.

¿Que sigue?

Después de configurar el inicio de APMlogs en el contexto, aproveche al máximo sus datos de registro:

• Explore los datos de registro en su plataforma con nuestra UI de logs.
• Vea su logs en el contexto del rendimiento de su aplicación en la APM UI. Solucionar errores con rastreo distribuido, rastreo del stack, registro de aplicación y más.
• Obtenga una visibilidad más profunda de los datos de rendimiento de su aplicación y de su plataforma enviando sus logs a nuestro agente de infraestructura. Revise su log de infraestructura en la UI.
• Configurar alerta.
• Consulta tus datos y crea un panel.