Nuestra traza API se utiliza para enviar datos de rastreo distribuido a New Relic: ya sea en nuestro propio formato genérico o en el formato de datos Zipkin . Esta API también es la forma en que los datos de traza de algunos de nuestros integradores y exportadores se informan a New Relic.
¿Quieres probar la traza API? Asegúrate de haber creado una cuenta gratuita de New Relic. No se requiere tarjeta de crédito.
Para omitir parte del contenido introductorio y comenzar rápidamente, vaya a Comenzar a generar informes de datos.
¿Qué es la traza API?
La traza API es una forma en que New Relic recopila datos de rastreo distribuido. Tenemos algunas herramientas de seguimiento que informan datos a través de esta API (Infinite Tracing, nuestra integración de código abierto y nuestros SDK de telemetría), o puede usar la API directamente para crear su propia implementación de seguimiento.
Razones para utilizar la traza API:
- Tienes tu propia herramienta personalizada de distribución de rastreo y quieres ver esos datos en New Relic sin cambiar tu instrumentación.
- Tienes una herramienta que emite datos de rastreo pero que requiere un backend para el almacenamiento de trazas.
- Quiere reportar datos de rastreo distribuido a New Relic sin el uso de nuestras soluciones instaladas.
- Utiliza Zipkin y desea ver los datos de la traza en New Relic sin cambiar su instrumentación.
¿Quiere comprender cómo se relacionan los datos de Traza con otros datos de New Relic? Lea acerca de nuestros tipos de datos.
Requisitos
Para obtener detalles sobre qué datos puede enviar y cómo se manejan, consulte Reglas y límites.
Consideraciones de muestreo
Al utilizar la API de traza, tiene la opción de habilitar Infinite Tracing. El uso de Infinite Tracing tiene implicaciones en la forma de configurar el muestreo:
Use your own sampling (no Infinite Tracing):
Si no utiliza Infinite Tracing, se supone que desea utilizar su propia implementación de muestreo para muestrear las trazas antes de enviárnoslas. (Si los datos de su traza exceden nuestros límites de datos, implementamos muestreo).
Use Infinite Tracing:
Si desea utilizar Infinite Tracing, un enfoque típico es enviarnos el 100% de sus datos de traza y confiar en el muestreo de Infinite Tracing. (Cuando siga las instrucciones para comenzar a informar datos , a continuación, tendrá una opción para habilitar Infinite Tracing).
Empezar a informar datos
La API de traza acepta datos de traza en estos dos formatos JSON:
zipkin: el formato de datos de traza Zipkin JSON v2 (aprenda qué es Zipkin). Comience a enviar datos Zipkin.newrelic: nuestro formato general. Si no tiene datos en formato Zipkin, utilice esto. Comience a enviar datos en formato New Relic.
¿Tiene problemas para obtener datos para informar? Ver resolución de problemas.
Encontrar datos
Puedes encontrar los datos enviados a través de la API de traza, o de integraciones que utilizan esta API, en estas ubicaciones:
- En nuestro rastreo UIdistribuido.
- Mediante consulta: Para obtener detalles sobre cómo consultar y crear gráficos personalizados, consulte Consulta de datos de rastreo distribuido.
Próximos pasos
Aquí hay algunos pasos adicionales a considerar:
- Conoce más sobre cómo funciona rastreo distribuido y la estructura de datos.
- Decora los datos del tramo con un atributo personalizado.
- Utilice nuestra API NerdGraph basada en GraphQL para consultar mediante programación sus datos de traza.