Importante
A partir de la versión 8.0.0 del agente Ruby, rastreo distribuido está activado de forma predeterminada. rastreo distribuido mejora el rastreo multiaplicación y se recomienda para sistemas distribuidos grandes.
El rastreo de aplicaciones múltiples está obsoleto en favor de distributed tracing y se eliminará en una futura versión de agente. Si necesita continuar usando el rastreo de múltiples aplicaciones, como para un framework de middleware no estándar, consulte la información de configuración en este documento.
Requisitos
Siga estos requisitos para utilizar el rastreo multiaplicación con el agente Ruby:
- Asegúrese de que las solicitudes instrumentadas utilicen una biblioteca de cliente HTTP compatible.
- Instale o actualice al último agente Ruby (versión 3.5.5.38 o superior).
- Siga los requisitos para la instalación de middleware.
Instalación de middleware
El rastreo de aplicaciones múltiples funciona con Rack y, por lo tanto, requiere Rails 2.3 o superior, u otro framework compatible.
- Si usa Rails, el agente Ruby instalará el middleware automáticamente.
- Si utiliza un framework diferente basado en Rack, agregue manualmente el middleware
NewRelic::Rack::AgentHooks
a su stack.
Configuración
El rastreo multiaplicación se puede controlar mediante un flag de configuración. A partir de la versión 8.0.0 del agente Ruby, el valor predeterminado para cross_application_tracer.enabled
es false
, incluso cuando no se especifica. Para habilitar el seguimiento de aplicaciones múltiples, debe establecer este indicador en true
y establecer distributed_tracing.enabled
en false
.
cross_application_tracer: enabled: truedistributed_tracing: enabled: false
Para versiones inferiores a 8.0.0, la multiaplicación se puede configurar usando la siguiente configuración.
cross_application_tracer: enabled: true
Multiaplicación traza mediciones
La medida external (de la aplicación que llama) siempre será mayor que la medida internal (de la aplicación llamada). La medición externa se recopila mediante la instrumentación de New Relic de la biblioteca del cliente HTTP (como Net::HTTP). La medición interna la toma la instrumentación de New Relic del framework web (como Rails) en la aplicación llamada.
Estos son algunos de los componentes principales incluidos en la medición externa que no están incluidos en la medición interna:
Algunos de estos componentes son más fáciles de controlar que otros. Por ejemplo, para capturar tiempos para los Receiving host elementos anteriores, asegúrese de tener configurado el monitoreo de la cola de solicitudes en la aplicación receptora.
Obtener rastreo distribuido
A partir de la versión 8.0.0 del agente Ruby, rastreo distribuido está activado de forma predeterminada. rastreo distribuido es una mejora del rastreo multiaplicación y se recomienda para sistemas distribuidos grandes.