La OpenTelemetry APM UI es una experiencia seleccionada disponible para la entidad de servicio. Si no configuró su servicio con New Relic y OpenTelemetry, consulte MonitoreoOpenTelemetry APM .
Las OpenTelemetry APM UI páginas de están diseñadas para ayudar a identificar y diagnosticar problemas rápidamente. Muchos requieren que los datos se ajusten a varias convenciones semánticas de OpenTelemetry, pero algunos son de propósito general. Consulte la información detallada y los requisitos para cada página a continuación:
- Página de resumen
- Distribución de la página de seguimiento
- Página del mapa de servicios
- Página de transacciones
- Pagina base de datos
- Página de servicios externos
- Página de tiempo de ejecución de JVM
- Página de tiempo de ejecución Go
- Página de logs
- Página Errors Inbox
- Página del explorador métrica
Los siguientes conceptos de New Relic se repiten o se superponen en todas las páginas:
Encuentre servicios OpenTelemetry APM
Para encontrar los servicios OpenTelemetry APM , navegue a All entities > Services > OpenTelemetry o APM & Services. Haga clic en un servicio para navegar a la página de resumen del servicio.
Dentro del explorador de entidades, puedes filtrar por etiqueta de entidad. Para obtener detalles sobre cómo se calculan las etiquetas de entidad, consulte los recursosOpenTelemetry en New Relic.
Página: Resumen
La página de resumen proporciona una descripción general del estado de su servicio, que incluye:
- Señales doradas: tiempo de respuesta, rendimiento y tasa de errores. Consulte señales doradas para obtener detalles sobre cómo se calculan.
- Entidad relacionada: otros servicios que se comunican con este servicio e infraestructura relacionada. Consulte el mapa de servicios para obtener una vista detallada.
- Actividad: estado de cualquier alerta activa para este servicio.
- Rastreo distribuido información valiosa: descubra si la entidad downstream o upstream podría estar contribuyendo a la degradación del rendimiento. Consulte las señales de traza entidad relacionadas para obtener más detalles.
- Instancia: desglose de señales doradas por instancia cuando un servicio se escala horizontalmente. Depende del atributo de recurso
service.instance.id(ver atributo de entidad de servicio para más detalles).
Página: rastreo distribuido
La página de rastreo distribuido proporciona información detallada y valiosa sobre los datos de traza OpenTelemetry . Consulte rastreo distribuido para obtener información sobre el uso de la página. Consulte OpenTelemetry traza en New Relic para obtener detalles sobre cómo se incorporan los datos de OpenTelemetry traza en New Relic.
Al igual que con las señales doradas, los intervalos se clasifican como errores si el estado del intervalo se establece en ERROR (por ejemplo, otel.status_code = ERROR). Si el intervalo es un error, la descripción del estado del intervalo (por ejemplo, otel.status_description) se muestra en los detalles del error.
OpenTelemetry span evento adjunta información de contexto de evento adicional a un lapso en individuo. Se emplean más comúnmente para capturar información de excepciones. Si está disponible, puedes ver el evento de un tramo en los detalles de la traza. Tenga en cuenta que la presencia de un evento de excepción de intervalo no considera que el intervalo sea un error por sí solo. Sólo los intervalos con estado de intervalo establecido en ERROR se clasifican como errores.
Página: Mapa de servicios
La página del mapa de servicios proporciona una representación visual de toda su arquitectura. Consulte el mapa de servicios para obtener más información.
Página: transacción
La página de transacciones proporciona herramientas para identificar problemas y analizar la transacción de un servicio.
Para métrica, la consulta asume que los datos se ajustan a las convenciones semánticas http métrica o rpc métrica. Los atributos http.route y rpc.method se emplean para listar y filtrar por transacción.
Para los tramos, las consultas son genéricas y emplean únicamente el modelo de datos de tramos de nivel superior. Los intervalos se cuentan para el rendimiento de la transacción y el tiempo de respuesta, como se describe en las señales doradas. El campo de nombre de tramo se emplea para enumerar y filtrar por transacción.
Página: base de datos
La página de base de datos proporciona herramientas para identificar problemas y analizar las operaciones del cliente de base de datos de un servicio.
No existe una vista basada en métricas de la base de datos ya que actualmente no hay convenciones semánticas disponibles.
Para los intervalos, la consulta asume que los datos se ajustan a las convenciones semánticas del intervalo de base de datos. El nombre del intervalo y los atributos db.system, db.sql.table y db.operation se emplean para enumerar y filtrar operaciones de base de datos.
Página: Servicios externos
La página de externos proporciona herramientas para identificar problemas y analizar las llamadas externas de un servicio, incluidas las llamadas de entidad (servicios ascendentes) y las llamadas de entidad (servicios descendentes).
No existe una vista basada en métricas de la página de servicios externos.
Para los tramos, las consultas son genéricas y emplean únicamente el modelo de datos de tramos de nivel superior. Los intervalos se cuentan para el rendimiento del servicio externo y el tiempo de respuesta si salen de un servicio, se calcula empleando una heurística de WHERE span.kind = client OR span.kind = producer. La base de datos abarcada por el cliente se filtra usando WHERE db.system is null (consulte la página de base de datos). Al igual que con las señales doradas, los intervalos son errores si tienen un código de estado de ERROR (por ejemplo, otel.status_code = ERROR). Si están disponibles, los datos de las convenciones semánticas http span y rpc span se emplean para clasificar las llamadas a servicios externos.
Página: tiempo de ejecución de JVM
La página de tiempo de ejecución de JVM proporciona herramientas para identificar problemas y analizar la JVM de un servicio Java. La página solo se muestra para servicios que emplean OpenTelemetry java. Para diferenciar entre distintas instancias de servicio, la página requiere que se establezca el atributo de recurso service.instance.id (consulte atributo de entidad de servicio para obtener más detalles).
La página de tiempo de ejecución JVM muestra señales doradas junto con la métrica de tiempo de ejecución JVM para correlacionar los problemas de tiempo de ejecución con el uso del servicio. La palanca span-métrica dicta si las señales doradas son impulsadas por datos span o métricos. No existe una vista basada en intervalos para el tiempo de ejecución JVM métrica.
Para métrica, la consulta asume que los datos se ajustan a las convenciones semánticas métricasJVM . Tenga en cuenta que estas convenciones están incorporadas en la biblioteca de instrumentación de tiempo de ejecución deOpenTelemetry Java, que se incluye automáticamente con el agente de Java de OpenTelemetry.
Página: Ir al tiempo de ejecución
La página de tiempo de ejecución de Go proporciona herramientas para identificar problemas y analizar el tiempo de ejecución de un servicio Go. La página solo se muestra para servicios que emplean OpenTelemetry Go. Para diferenciar entre distintas instancias de servicio, la página requiere que se establezca el atributo de recurso service.instance.id (consulte atributo de entidad de servicio para obtener más detalles).
La página de tiempo de ejecución de Go muestra señales doradas junto con la métrica de tiempo de ejecución de Go para correlacionar los problemas de tiempo de ejecución con el uso del servicio. La palanca span-métrica dicta si las señales doradas son impulsadas por datos span o métricos. No existe una vista basada en tramos para Go runtime métrica.
Para métrica, la consulta asume que los datos son producidos por la biblioteca de instrumentación en tiempo de ejecución OpenTelemetry Go. Tenga en cuenta que actualmente no existen convenciones semánticas para Go runtime métrica.
Página: logs
La página de logs proporciona herramientas para identificar problemas y analizar el log de un servicio. Consulte UI de logs para obtener más información.
Página: Errors Inbox
La página Errors Inbox proporciona herramientas para detectar y clasificar los errores de un servicio. Consulte Bandeja de entrada de errores para obtener más detalles.
La página errors inbox está controlada por detalles de traza. Al igual que con las señales doradas, los intervalos se clasifican como errores si el estado del intervalo se establece en ERROR (por ejemplo, otel.status_code = ERROR).
Los intervalos de error se agrupan por su huella digital de error, y se calculan normalizando valores de identificación como UUID, valores hexadecimales, direcciones de email, etc. Cada intervalo de error distinto es una instancia individual dentro del grupo de errores. El mensaje del grupo de errores se determina de la siguiente manera:
- Descripción del estado del intervalo (por ejemplo,
otel.status_description) rpc.grpc.status_codede rpc abarca convenciones semánticashttp.status_codedesde http abarcan convenciones semánticashttp.response.status_codedesde http abarcan convenciones semánticasundefinedsi ninguno de los anteriores está presente
Página: explorador métrica
El explorador de métricas proporciona herramientas para explorar la métrica de un servicio de manera genérica. Consulte explorar sus datos para obtener más información.
Señales doradas
Las señales doradas de rendimiento, tiempo de respuesta y tasa de errores aparecen en varios lugares de la OpenTelemetry APM UI. Cuando se emplean, se calculan de la siguiente manera:
Para métrica, la consulta asume que los datos se ajustan a las convenciones semánticas http métrica o rpc métrica.
Para los tramos, las consultas son genéricas y emplean únicamente el modelo de datos de tramos de nivel superior. Los intervalos se cuentan para el rendimiento y el tiempo de respuesta si son intervalos de entrada raíz en un servicio, se calculan empleando una heurística de WHERE span.kind = server OR span.kind = consumer. Los intervalos son errores si tienen un código de estado de ERROR (por ejemplo, otel.status_code = ERROR).
Limitar datos con filtros
Varias páginas incluyen una barra de filtros, con opciones como Restringir datos a.... Esto le permite filtrar consultas en la página para que coincidan con los criterios. Por ejemplo, puede restringir el despliegue a un canario en individuo filtrando por service.version='1.2.3-canary'. Los filtros se conservan al navegar entre páginas.
Alternar métrica o tramos
Varias páginas incluyen un interruptor métrico o de tramos. Esto le permite alternar si las consultas se basan en datos de extensión o métricas según los requisitos de análisis y la disponibilidad de datos.
Las métricas no están sujetas a ejemplificación y, por lo tanto, son más precisas, especialmente cuando se calculan tasas como el rendimiento. Sin embargo, las métricas están sujetas a restricciones de cardinalidad y pueden carecer de ciertos atributos importantes para el análisis. Por el contrario, los tramos están muestreados y, por lo tanto, están sujetos a problemas de precisión, pero tienen atributos más ricos ya que no están sujetos a restricciones de cardinalidad.
Históricamente, OpenTelemetry API/SDK del lenguaje y la instrumentación priorizaron la instrumentación de traza. Sin embargo, el proyecto avanzó mucho y métrica está disponible en casi todos los idiomas. Consulte la documentación del idioma y la instrumentación relevantes para obtener más detalles.