Esta documentación se centra en cómo New Relic procesa el registro OpenTelemetry recibido a través de su extremo OTLP dedicado.
Hay dos flujos de trabajo típicos para enviar registros OpenTelemetry a New Relic:
- La aplicación puede enviar el registro directamente al New Relic OTLP endpoint.
- Consulte la documentación del lenguaje OpenTelemetry relevante para obtener detalles de implementación específicos y el monitoreo de OpenTelemetry APM para obtener detalles sobre los servicios de monitoreo con New Relic.
Este método implica extraer el registro de aplicación escrito en archivos o salida estándar (
stdout).El recolector OpenTelemetry se emplea normalmente para esta tarea. Luego, los logs raspados se envían al extremo OTLP New Relic .
Puede encontrar información de configuración detallada en los siguientes recursos de OpenTelemetry:
Independientemente del método de recopilación elegido, una integración exitosa requiere configurar su fuente log para exportar registros a este extremo. Cerciorar de revisar los requisitos de configuración extrema antes de continuar.
Mapeo de registro log OTLP
New Relic asigna log de OTLP al tipo de datos Log. La siguiente tabla describe cómo los campos del mensaje protoLogRecord se asignan a New Relic Log:
Campo OTLP | Campo New Relic |
|---|---|
| Cada valor principal es un atributo en el campo |
|
|
|
|
| Cada valor principal es un atributo en el campo |
|
|
|
|
|
|
|
|
| Cada valor principal es un atributo en el campo |
|
|
|
|
|
|
|
|
Notas a pie de tabla
[1] En caso de conflicto en el atributo de recurso, el atributo de alcance, el atributo de registro log , los campos de registro log de nivel superior y el atributo analizado de LogRecord.body [3], el orden del precedente (de mayor a menor) es: atributo analizado de LogRecord.body -> campos de nivel superior LogRecord.* > LogRecord.attributes > ScopeLogs.InstrumentationScope.attributes > ResourceLogs.Resource.attributes.
Consulta los tipos de atributos OTLP para obtener detalles sobre los tipos de atributos compatibles con OTLP extremo New Relic .
[2] Si LogRecord.time_unix_nanos no está presente, timestamp se establece en la hora en que New Relic recibió los datos.
[3] El análisis de registros se aplica a LogRecord.body para intentar extraer el atributo del texto log sin formato. Por ejemplo, si se emplea un formato log estructurado JSON, el valor principal se convierte en atributo en el log resultante. Esto es particularmente útil cuando se recopilan registros de archivos o stdout. En este caso, es común no tener ningún atributo de recurso asociado con el log (requerido para la correlación del servicioAPM ) y ningún valor para LogRecord.trace_id / LogRecord.span_id (requerido para la correlación de traza). La correlación funcionará según lo previsto si los campos obligatorios se pueden analizar correctamente.
Correlación con el servicio OpenTelemetry APM
log se correlacionan con una entidad de servicio si incluyen el atributo requerido. Normalmente, estos provienen del atributo de recurso del log, como ResourceLogs.Resource.attributes, pero también se pueden analizar desde LogRecord.body como se describe en la nota al pie n.° 3 del mapeo de OTLP.
Para ver el registro de un servicio, navegue hasta la página de registro de ese servicio.
Correlación con trazas
Log se correlacionan con una traza si trace.id y span.id atributo se pueden resolver. Normalmente, estos provienen de los campos LogRecord.trace_id y LogRecord.span_id , pero también se pueden analizar desde LogRecord.body como se describe en la nota al pie 3 del mapeo OTLP.
Para ver el registro registrado en el contexto de una traza particular, tiene dos opciones:
- Navegue a la pestaña de Logs dentro de la página de detalles de la traza.
- Navegue a la página de registro de un servicio y haga clic en un log para abrir los detalles log. Si está asociado a una traza, podrás navegar desde los Log details hasta los Trace details.