La característica de servicios externos está disponible para New Relic APM agente y OpenTelemetry.
Si desea comenzar a funcionar lo más rápido posible, le recomendamos utilizar nuestro agente APM.
Al hacer clic en un logotipo, accederá a la plataforma New Relic, donde se le guiará durante la instalación y configuración del agente.
Configurar servicios externos
Las siguientes instrucciones lo guiarán a través de la configuración de servicios externos.
Empezar a enviar datos
La configuración de servicios externos cambia según si está utilizando agente APM u OpenTelemetry. Seleccione la pestaña de la opción de instalación que se adapte a su sistema:
Complete lo siguiente para cada servicio que desee ver en servicios externos:
Si aún no lo ha hecho, instale el agente New Relic APM adecuado.
Asegúrese de que rastreo distribuido esté activado en el agente:
- Si instaló un nuevo agente, el rastreo distribuido estándar está activado de forma predeterminada. Si su servicio se comunica con otros servicios que utilizan Infinite Tracing, consulte la documentación de su agente para obtener ayuda con Infinite Tracing.
- Si tiene un agente anterior, siga los pasos de configuración para habilitar el rastreo distribuido estándar o el rastreo infinito. Cuando habilita el rastreo distribuido, anula el antiguo rastreo de aplicaciones múltiples.
Vea si su agente requiere pasos de configuración adicionales:
Agente
Versión mínima
Configuración
Go
3.6.0
Consulte la documentación sobre el uso de
NewRoundTripper()
.Java
5.13.0
Consulte la documentación sobre el uso de la API del agente de Java para realizar llamadas externas.
.NET
8.29.0
El agente .NET y el agente .NET en Azure automáticamente realizan llamadas externas, pero no utilizan métodos de transacción. Para ver la transacción, necesita usar una combinación de lo siguiente:
Node.js
6.9.0
Consulte la documentación sobre el uso de la API del agente Node.js.
PHP
9.12.0.268
Consulte la documentación sobre el uso de la API del agente PHP para instrumentar llamadas externas.
Python
5.14.0.142
No son necesarios pasos adicionales: Las llamadas externas se instrumentan automáticamente.
Ruby
6.12.0.367
Consulte la documentación sobre el uso de la API del agente Ruby para realizar llamadas externas.
Sugerencia
La versión clásica de servicios externos todavía está disponible si necesita agregar un nuevo servicio a una cadena de agentes que ya utilizan servicios externos clásicos. Para instalar servicios externos clásicos, habilita el rastreo multiaplicación en lugar del rastreo distribuido en los pasos siguientes.
La UI de New Relic muestra detalles de los servicios externos una vez que completa los pasos para configurar la instrumentación de OpenTelemetry para su servicio y las llamadas que realiza a otros servicios. La característica de servicios externos muestra las llamadas entre tus servicios, desglosadas por extremo de transacción en cada servicio. El nombre de cada transacción se deriva del intervalo de entrada del proceso (span.kind = "server"
).
Si su servicio APM está conectado a un servicio OpenTelemetry (ascendente o descendente), ese servicio OpenTelemetry no aparecerá en la vista de ese servicio APM. Esto se debe a que, al visualizar un servicio APM, esta característica utiliza métricas que solo son reportadas por el agente APM. Al ver un servicio OpenTelemetry, el servicio APM aparecerá como una conexión.
La calidad de la información que ve depende de la estrategia de muestreo que esté utilizando en el recolector. Consulte la siguiente sección sobre el uso del muestreo para controlar lo que ve en la UI.
Sugerencia
Si envía el 100% de sus datos de OpenTelemetry a nuestra traza API, almacenamos el 100% de esos datos, a menos que tenga un límite de tarifa específico para su organización, o si envía suficientes datos para activar nuestro límite de tarifa predeterminado.
Ajuste el muestreo para ver más datos UI
Si está utilizando un agente APM y ve pocos o ningún dato cuando comienza a perforar más allá de la página inicial del mapa, es posible que necesite ajustar el yacimiento de extensión para muestrear más datos. Esto se debe a que los datos a nivel de transacción se completan con datos de traza muestreados.
Para OpenTelemetry, tanto la página inicial como todas las páginas de profundización se completan con datos de muestra, por lo que es posible que deba realizar algunos ajustes en el muestreo para obtener los datos que necesita.
Aquí hay información sobre las diferentes rutinas para ajustar el depósito para agente APM, así como consejos para ajustar el muestreo para OpenTelemetry:
Todos los agentes APM tienen un depósito que almacena tramos y la mayoría de estos depósitos de agente son configurables. El tamaño de este depósito afecta la probabilidad de que un agente pueda enviar todos los tramos que crea. Ver traza fragmentada para más detalles.
Los datos para esta característica se derivan de tramos de clientes y servidores adyacentes donde se realizan llamadas externas de un servicio a otro. Cuando un agente alcanza su límite de depósito de intervalos, existe la posibilidad de que elimine algunos intervalos que representan estas llamadas.
El valor de configuración predeterminado del agente de 2000 define la cantidad máxima de eventos que el agente recopila por minuto. Si hay más tramos que este número, el agente recopila un muestreo estadístico, esencialmente degradando la cantidad de datos que se utilizan en el mapa de servicios externos.
Si no ve el tipo de detalle que desea en la UI, puede aumentar el tamaño del depósito hasta 10 000. Revise lo siguiente para ajustar los depósitos de agente:
Agente APM | Documentación |
---|---|
Go | El depósito no es configurable actualmente |
Java | |
.NET | |
Node.js | |
PHP | El depósito no es configurable actualmente |
Python | Configuración de Python (Ver |
Ruby |
Sugerencia
Esta sección solo se aplica si sus servicios envían datos a New Relic a través de un recolector OpenTelemetry. Esto se debe a que los datos no se muestrean en un recolector de OpenTelemetry.
Para OpenTelemetry, todas las vistas de servicios externos se completan con trazas de muestra, lo que significa que es posible que no vea suficientes datos útiles. Para resolver esto, puede cambiar el muestreo en el recolector para permitir que entren más datos en New Relic.
Consulte Muestreo para obtener sugerencias sobre la configuración.
¿Que sigue?
- Aprenda a utilizar servicios externos para solucionar problemas de API
- Obtenga más información sobre cómo navegar por la UIde servicios externos.
- Si tiene preguntas sobre cómo entender la UI, consulte nuestros consejos.