Log puede representar registro de aplicación, evento generado por máquina o registro del sistema. OpenTelemetry ha definido un modelo de datoslog para representar datos log .
Puede enviar registros utilizando las herramientas OpenTelemetry, correlacionarlos con la aplicación y verlos en New Relic.
Enviar registro a New Relic
El recolector de OpenTelemetry y el repositorio Contrib del recolector de OpenTelemetry contienen varios componentes para consumir datos log . El patrón general es configurar el recolector para:
- Reciba registros de cualquiera de los receptores log . Algunas de las opciones del receptor incluyen Filelog Receiver, Fluent Forward Receiver y Syslog Receiver.
- Registro de procesos, potencialmente anotándolos con información de recursos. Algunas de las opciones de procesador incluyen Procesador de detección de recursos y Procesador de recursos.
- Exporte el registro a New Relic a través del exportador OTLP.
Correlaciona tu registro de aplicación
Log de aplicación son más útiles si están correlacionados con otros telemetry data producidos por la aplicación. La convención semántica de OpenTelemetry para servicios especifica service.name como campo obligatorio. Todos los datos de métrica, traza y log de aplicaciones enviados a New Relic con el mismo service.name están asociados con la misma entidad.
Los detalles específicos de cómo se anota el registro con el atributo de recurso service.name dependen del entorno de la aplicación:
- La aplicación puede generar un registro JSON estructurado, que puede configurar para incluir
service.namecomo otro campo. - Puede implementar la aplicación junto con una instancia de agente recolector dedicado, que puede configurar con un procesador de recursos para anotar el registro con el atributo
service.name.
Opcionalmente, se puede propagar un contexto de traza de aplicación adicional (a veces llamado contexto de ejecución) al mensaje de registro. La configuración y disponibilidad de esto depende del lenguaje y framework de registro utilizado por la aplicación. La estrategia general es configurar la aplicación para escribir un registro JSON estructurado y configurarla para extraer el contexto de traza en campos de contexto de traza específicos en el mensaje de registro disponible. Para obtener más detalles, consulte OpenTelemetry en la UI: página de registro.
El ejemplo de logs en el contexto con Log4j2 en GitHub muestra un ejemplo de trabajo de un extremo a otro para una aplicación Java simple que utiliza Log4j2.
Ver registro de OpenTelemetry
Aquí hay dos formas de ver el registro:
- Busque en nuestra UIusuario de registros.
- Si su registro está correlacionado con una aplicación, véalo en el contexto de la aplicación.
El campo de tiempo
El campo timeUnixNano es opcional según la especificación de OpenTelemetry para datos log . Cuando timeUnixNano no esté presente, New Relic utilizará la hora en que se recibieron los datos para la timestamp de los registros de New Relic.