• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Rastreamento multiaplicativo em Ruby

|View as Markdown (English)

Importante

A partir da versão 8.0.0 do agente Ruby, distributed tracing está ativado por padrão. distributed tracing melhora o rastreamento multiaplicativo e é recomendado para sistemas distribuídos grandes.

O rastreamento multiaplicativo foi removido na versão 10.0.0 do agente Ruby. Use distributed tracing em vez disso. O restante desta página se aplica apenas a versões do agente anteriores a 10.0.0.

Requisitos

Siga estes requisitos para usar o rastreamento multiaplicativo com o agente Ruby:

  1. Certifique-se de que as solicitações que estão sendo instrumentadas usem uma biblioteca cliente HTTP suportada.
  2. Instale ou atualize para o agente Ruby mais recente (versão 3.5.5.38 ou superior).
  3. Siga os requisitos para instalação de middleware.

Instalação de middleware

O rastreamento multiaplicativo funciona com Rack, e portanto requer Rails 2.3 ou superior, ou outro framework compatível.

  • Se você usa Rails, o agente Ruby instalará o middleware automaticamente.
  • Se você usar uma framework baseada em Rack diferente, adicione manualmente o middleware NewRelic::Rack::AgentHooks à sua stack.

Configuração

Em versões do agente anteriores a 10.0.0, o rastreamento multiaplicativo pode ser controlado por um sinalizador de configuração. A partir da versão 8.0.0 do agente Ruby, o padrão para cross_application_tracer.enabled é false, mesmo quando não especificado. Para ativar o rastreamento multiaplicativo nas versões 8.x e 9.x, você deve definir esse sinalizador como true e definir distributed_tracing.enabled como false.

cross_application_tracer:
enabled: true
distributed_tracing:
enabled: false

Para versões inferiores a 8.0.0, o multiaplicativo pode ser configurado utilizando a seguinte configuração.

cross_application_tracer:
enabled: true

Medições trace multiaplicativo

A medida external (do aplicativo chamador) sempre será maior que a medida internal (do aplicativo chamado). A medição externa é coletada pela instrumentação da biblioteca cliente HTTP da New Relic (como Net::HTTP). A medição interna é feita pela instrumentação do framework web da New Relic (como Rails) no aplicativo chamado.

Aqui estão alguns dos principais componentes incluídos na medição externa que não estão incluídos na medição interna:

Alguns desses componentes são mais fáceis de controlar do que outros. Por exemplo, para capturar os tempos dos Receiving host itens acima, certifique-se de ter o monitoramento da fila de solicitações configurado no aplicativo receptor.

Obtenha distributed tracing

A partir da versão 8.0.0 do agente Ruby, distributed tracing está ativado por padrão. distributed tracing é uma melhoria no rastreamento multiaplicativo e é recomendado para sistemas distribuídos grandes.

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.