New Relic admitió la ingesta nativa de OTLP durante años, durante los cuales identificamos problemas comunes que enfrentan los usuarios al ingerir datos. Trabajar en un caso de soporte puede llevar mucho tiempo y, a veces, resultar frustrante para los clientes (y para New Relic). Elaboramos esta guía de resolución de problemas para ayudar a establecer un entendimiento compartido y brindar herramientas para autodiagnosticar y solucionar problemas cuando sea posible.
Primero, revise los requisitos y recomendaciones de configuración de New Relic OTLP. Contiene consejos y contexto esenciales que cualquiera que desee emplear OTLP con New Relic debe conocer.
A continuación, consulte las secciones siguientes:
- Resolución general de problemas: resolución de problemas para cuestiones generales de OTLP
- Catálogo de problemas: problemas comunes de los clientes y medidas de mitigación
Resolución general de problemas
Cuando tenga un problema con el extremo OTLP New Relic , primero siga estos pasos básicos de resolución de problemas. Si terminas abriendo un de ticket soporte, estas son las primeras cosas que te preguntamos:
- Habilite logs de diagnóstico. Cerciorar de que su cliente OTLP tenga habilitado el logging de modo que pueda ver detalles sobre cualquier error que pueda estar ocurriendo. El mecanismo para habilitar el log varía según la implementación. Consulte los documentos relevantes.
- Pruebe que el extremo OTLP de New Relic sea accesible. Un simple comando de shell
curl http://otlp.nr-data.netde la máquina en cuestión puede ayudar a determinar si hay algún problema de configuración de la red local (es decir, restricción del firewall) impide la conectividad con New Relic. - Busque
NrIntegrationErrorevento. La ingesta de New Relic OTLP realiza una validación mínima sincrónicamente antes de devolver un código de estado exitoso. Si no ve indicaciones de errores de exportación en su log de aplicación, pero no ve datos en New Relic, intente consultarNrIntegrationError. Puede haber problemas con tus datos que fueron detectados durante la validación asincrónica. - Determine si el problema está localizado. A menudo, los errores se localizan en una aplicación o entorno específico. En estos casos, es útil evaluar las diferencias entre las áreas que son problemáticas y funcionan correctamente.
- Busque signos de clave de API no válida. El endoint OTLP de New Relic requiere configurar un encabezado
api-key. La clave de API no válida o faltante es un problema común que se presenta con códigos de estado HTTP 403 o 401, o códigos de estado gRPC no autenticado o licencia denegada. Si ve estos, verifique que su clave de API sea válida y esté configurada correctamente. - Compruebe si la exportación se realizó correctamente luego de volver a intentarlo. Recomendamos que el reintento esté habilitado y esperamos que los intentos de exportación ocasionalmente fallen inicialmente con errores transitorios, pero tengan éxito luego de volver a intentarlo. Sin embargo, tenemos un SLA. Si sospecha que los errores transitorios son lo suficientemente frecuentes como para exceder nuestro SLA, abra un caso de soporte.
- Compruebe si hay señales de que no se están reintentando los errores transitorios. A pesar de nuestros mejores esfuerzos, puede haber casos extremos en los que el extremo OTLP de New Relic devuelva códigos de estado no recuperables para errores transitorios. Si cree que se encontró con esta situación, abra un caso de soporte.
Catálogo de ediciones
La siguiente tabla cataloga los problemas que vimos que los clientes encontraron con el extremo OTLP de New Relic . Muchos son fáciles de resolver con la configuración adecuada. La columna Fingerprint muestra un log típico cuando una aplicación encuentra una clase particular de problema. Consulte las columnas Known resolution y Notes para conocer los pasos de mitigación.
| Versión del protocolo OTLP | Tipo | Idioma/ecosistema | Huella digital | Resolución conocida | Notas | | --------------------- | ------------------------------------------ | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | HTTP | 401 - No autorizado | Java | io.opentelemetry.exporter.internal.http.HttpExporter - Failed to export spans. Server responded with HTTP status code 401. | Incluir clave de API | Encabezado api-key faltante | | HTTP | 401 - No autorizado | recolector | Exporting failed. The error is not retryable. Dropping data. {"kind": "exporter", "data_type": "traces", "name": "otlphttp", "error": "Permanent error: error exporting items, request to https://otlp.nr-data.net/v1/traces responded with HTTP Status Code 401, Message=, Details=[]", "dropped_items": 4} | Incluir clave de API | Encabezado api-key faltante | | HTTP | 401 - No autorizado | Go | failed to upload metrics: failed to send metrics to https://otlp.nr-data.net/v1/metrics: 401 Unauthorized | Incluir clave de API | Encabezado api-key faltante | | HTTP | 403 - Prohibido | Java | io.opentelemetry.exporter.internal.http.HttpExporter - Failed to export spans. Server responded with HTTP status code 403. | Verificar clave de API | Encabezado api-key no válido | | HTTP | 403 - Prohibido | Java | Exporting failed. The error is not retryable. Dropping data. {"kind": "exporter", "data_type": "traces", "name": "otlphttp", "error": "Permanent error: error exporting items, request to https://otlp.nr-data.net/v1/traces responded with HTTP Status Code 403, Message=, Details=[]", "dropped_items": 14} | Verificar clave de API | Encabezado api-key no válido | | HTTP | 403 - Prohibido | Ir | traces export: failed to send to https://otlp.nr-data.net/v1/traces: 403 Forbidden | Verificar clave de API | Encabezado api-key no válido | | HTTP | 403 - Prohibido | .NET | Exporter failed send data to Collector to {0} endpoint. Data will not be sent. Exception: {1}{https://otlp.nr-data.net:4317/v1/traces}{System.Net.Http.HttpRequestException: Response status code does not indicate success: 403 (Forbidden). | Verificar clave de API | Encabezado api-key no válido | | HTTP | Tiempo de espera | Java | io.opentelemetry.exporter.internal.http.HttpExporter - Failed to export spans. The request could not be executed. Full error message: timeout | Ajustar procesamiento por lotes / tiempo de espera | Se produce después de que se agota el tiempo de espera de la exportación. Verifique la configuración de tiempo de espera y el estado de la red del cliente.
Si descartó la red y la configuración del lado del cliente, abra un caso de soporte. | | HTTP | Tiempo de espera | recolector | max elapsed time expired failed to make an HTTP request: Post \"https://otlp.nr-data.net/v1/traces\": context deadline exceeded (Client.Timeout exceeded while awaiting headers) | Ajuste de procesamiento por lotes / tiempo de espera | Generalmente ocurre después de que los reintentos fallan y se agota el tiempo de espera de la exportación. Puede estar relacionado con la red del cliente, la configuración de tiempo de espera/reintento del cliente o la red/servidores de New Relic.
Si descartó la red y la configuración del lado del cliente, abra un caso de soporte. | | HTTP | Tiempo de espera | Ir | failed to upload metrics: context deadline exceeded: retry-able request failure | Ajustar procesamiento por lotes / tiempo de espera | Se produce después de que se agota el tiempo de espera de la exportación. Verifique la configuración de tiempo de espera y el estado de la red del cliente.
Si descartó la red y la configuración del lado del cliente, abra un caso de soporte. | | HTTP | Límite de velocidad | recolector | Exporting failed. Will retry the request after interval. {"kind": "exporter", "data_type": "metrics", "name": "otlphttp", "error": "Throttle (29s), error: error exporting items, request to https://otlp.nr-data.net:443/v1/metrics responded with HTTP Status Code 429", "interval": "29s"} | Ajuste de lotes | Límite de velocidad excedido.
Ajuste la configuración de procesamiento por lotes para reducir la tasa de solicitudes. | | gRPC | Código 2 - Desconocido
Tiempo de espera | Java | io.opentelemetry.exporter.internal.grpc.GrpcExporter - Failed to export spans. Server responded with gRPC status code 2. Error message: timeout | Ajustar procesamiento por lotes / tiempo de espera | Se produce después de que se agota el tiempo de espera de la exportación. Verifique la configuración de tiempo de espera y el estado de la red del cliente.
Si descartó la red y la configuración del lado del cliente, abra un caso de soporte. | | gRPC | Código 2 - Desconocido
HTTP 500 | recolector | rpc error: code = Unknown desc = unexpected HTTP status code received from server: 500 (Internal Server Error); malformed header: missing HTTP content-type | | El proveedor de redes New Relic produjo un código de estado no recuperable para un error transitorio.
Si esto sucede repetidamente, abra un caso de soporte. | | gRPC | Código 2 - Desconocido
HTTP 530 | recolector | rpc error: code = Unknown desc = unexpected HTTP status code received from server: 530 (); transport: received unexpected content-type \"text/html; charset=UTF-8\" | | El proveedor de redes New Relic produjo un código de estado no recuperable para un error transitorio.
Si esto sucede repetidamente, abra un caso de soporte. | | gRPC | Código 4 - Fecha límite excedida | recolector | rpc error: code = DeadlineExceeded desc = context deadline exceeded | Ajuste de procesamiento por lotes / tiempo de espera | Generalmente ocurre después de que los reintentos fallan y se agota el tiempo de espera de la exportación. Puede estar relacionado con la red del cliente, la configuración de tiempo de espera/reintento del cliente o la red/servidores de New Relic.
Si descartó la red y la configuración del lado del cliente, abra un caso de soporte. | | gRPC | Código 7 - No autenticado | Java | io.opentelemetry.exporter.internal.grpc.GrpcExporter - Failed to export spans. Server responded with gRPC status code 7. | Incluir clave de API | Falta el encabezado api-key | | gRPC | Código 7 - No autenticado | .NET | Exporter failed send data to Collector to {0} endpoint. Data will not be sent. Exception: {1}{https://otlp.nr-data.net:4317/}{Grpc.Core.RpcException: Status(StatusCode="Unauthenticated", Detail="") | Incluir clave de API | Falta el encabezado api-key | | gRPC | Código 8 - ResourceExhausted | recolector | rpc error: code = ResourceExhausted desc = Too many requests", "dropped_items": 1024 | Ajuste de procesamiento por lotes | Límite de velocidad excedido.
Ajuste la configuración de procesamiento por lotes para reducir la tasa de solicitudes. | | gRPC | Código 13 - Interno | Java | io.opentelemetry.exporter.internal.grpc.GrpcExporter - Failed to export spans. Server responded with gRPC status code 13. | | No hay suficiente información para diagnosticar. Podría ser que el proveedor de red New Relic generó un código de estado no recuperable para un error transitorio.
Si esto sucede repetidamente, abra un caso de soporte. | | gRPC | Código 13 - Interno
HTTP 400 | recolector | rpc error: code = Internal desc = unexpected HTTP status code received from server: 400 (Bad Request) | | El proveedor de redes New Relic produjo un código de estado no recuperable para un error transitorio.
Si esto sucede repetidamente, abra un caso de soporte. | | gRPC | Código 14 - No disponible
Restablecimiento de conexión | recolector | rpc error: code = Unavailable desc = error reading from server: read tcp 100.127.0.171:47470->162.247.241.110:4317: read: connection reset by peer | Reintentar sintonizar | Debería resolver con reintento. Cerciorar de que el recolector tenga recursos suficientes para manejar la contrapresión de reintento. | | gRPC | Código 14 - No disponible
HTTP 502 | recolector | rpc error: code = Unavailable desc = unexpected HTTP status code received from server: 502 (Bad Gateway); transport: received unexpected content-type "text/html" | Reintento de ajuste | Debería resolver con reintento. Cerciorar de que el recolector tenga recursos suficientes para manejar la contrapresión de reintento. | | gRPC | Código 14 - No disponible
HTTP 503 | recolector | rpc error: code = Unavailable desc = unexpected HTTP status code received from server: 503 (Service Unavailable) | Reintentar ajuste | Debería resolver con reintento. Cerciorar de que el recolector tenga recursos suficientes para manejar la contrapresión de reintento. | | gRPC | Código 16 - Licencia denegada | Java | io.opentelemetry.exporter.internal.grpc.GrpcExporter - Failed to export spans. Server responded with gRPC status code 16. | Verificar clave de API | Encabezado api-key no válido | | gRPC | Código 16 - Licencia denegada | .NET | Exporter failed send data to Collector to {0} endpoint. Data will not be sent. Exception: {1}{https://otlp.nr-data.net:4317/}{Grpc.Core.RpcException: Status(StatusCode="PermissionDenied", Detail="") | Verificar clave de API | Encabezado api-key no válido |