Configurações de distributed tracing do agente Java

Defina como false para desativar distributed tracing. Por exemplo, no arquivo de configuração, você usaria:

distributed_tracing:
  enabled: false

Aqui estão outras opções para desativar distributed tracing:

Propriedade do sistema:

-Dnewrelic.config.distributed_tracing.enabled=false

Variável de ambiente:

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=false

Por padrão, as versões suportadas do agente utilizam o cabeçalho newrelic e os cabeçalhos W3C Trace Context para distributed tracing. O cabeçalho distributed tracing newrelic permite interoperabilidade com agentes mais antigos que não suportam cabeçalhos W3C Trace Context . As versões do agente que suportam cabeçalhos W3C Trace Context os priorizarão em relação a newrelic cabeçalhos para distributed tracing.

Se você não quiser utilizar o cabeçalho newrelic, defini-lo como true fará com que o agente exclua o cabeçalho newrelic e use apenas cabeçalhos W3C Trace Context para distributed tracing.

Por exemplo, para excluir cabeçalhos newrelic no arquivo de configuração, você usaria:

distributed_tracing:
  exclude_newrelic_header: true

Para excluir cabeçalhos newrelic usando uma propriedade do sistema, você usaria:

-Dnewrelic.config.distributed_tracing.exclude_newrelic_header=true

Define o destino de amostragem adaptativa global, compartilhado pelos contextos root, remote_parent_sampled e remote_parent_not_sampled. Este destino controla o número de trace por minuto que o amostrador adaptativo tenta capturar. Um contexto pode sobrescrever esse padrão global com seu próprio adaptive.sampling_target específico do contexto.

distributed_tracing:
  sampler:
    adaptive_sampling_target: 30  # Applied to all contexts without an explicit override

Para obter mais informações, consulte Configurar amostragem: destinos de amostragem adaptável.

Configura o amostrador usado para o contexto raiz (distributed trace que se origina do serviço atual). Os valores possíveis são:

• adaptive: use o Adaptive Sampler padrão da New Relic.

  • Parâmetro opcional: sampler.root.adaptive.sampling_target

• trace_id_ratio_based: amostrar uma porcentagem fixa de trace com base no ID do trace

  • Parâmetro obrigatório: sampler.root.trace_id_ratio_based.ratio

• always_on: amostre todos os trace raiz.

• always_off: Não amostra nenhum trace raiz.

  distributed_tracing:
    sampler:
      root: adaptive

  Copiar

  root.adaptive.sampling_target

  Tipo	Inteiro, entre 1 (inclusive) e 120 (inclusive)
  Padrão	sampler.adaptive_sampling_target
  Obrigatório	Não

  Substitui o adaptive_sampling_target global apenas para o contexto root, definindo o número de traces raiz por minuto que o amostrador adaptativo tenta capturar.

  distributed_tracing:
    sampler:
      adaptive_sampling_target: 120  # Global default
      root:
        adaptive:
          sampling_target: 5  # Overrides global default to capture 5 traces/min for the root context

  Copiar

  root.trace_id_ratio_based.ratio

  Tipo	float, entre 0,0 (exclusivo) e 1,0 (inclusivo)
  Padrão	Nenhum
  Obrigatório	Sim

  Especifica a porcentagem de trace raiz a ser capturada, com base no ID do trace. Consulte Configurar amostragem: amostrador baseado na proporção de trace ID.

  Importante

  A propriedade ratio é obrigatória ao usar o amostrador trace_id_ratio_based. Se uma proporção não for definida, o Adaptive Sampler padrão será usado para este contexto em vez disso.

  distributed_tracing:
    sampler:
      root:
        trace_id_ratio_based:
          ratio: 0.2  # 20% of root traces

  Copiar

Configura o amostrador usado para o contexto amostrado do pai remoto. Os valores possíveis são:

• adaptive: use o Adaptive Sampler padrão da New Relic.

  • Parâmetro opcional: sampler.remote_parent_sampled.adaptive.sampling_target

• trace_id_ratio_based: amostrar uma porcentagem fixa de trace com base no ID do trace

  • Parâmetro obrigatório: sampler.remote_parent_sampled.trace_id_ratio_based.ratio

• always_on: Amostre todos os remote_parent_sampled trace.

• always_off: não amostrar remote_parent_sampled trace.

  distributed_tracing:
    sampler:
      remote_parent_sampled: always_on

  Copiar

  remote_parent_sampled.adaptive.sampling_target

  Tipo	Inteiro, entre 1 (inclusive) e 120 (inclusive)
  Padrão	sampler.adaptive_sampling_target
  Obrigatório	Não

  Sobrescreve o adaptive_sampling_target global apenas para o contexto remote_parent_sampled.

  Como o Adaptive Sampler geralmente coleta amostras de trace com amostragem upstream (e não os contabiliza para o destino de amostragem), essa configuração geralmente não tem efeito. Para coletar amostras de apenas alguns trace remote_parent_sampled, prefira o amostrador trace_id_ratio_based.

  remote_parent_sampled.trace_id_ratio_based.ratio

  Tipo	float, entre 0,0 (exclusivo) e 1,0 (inclusivo)
  Padrão	Nenhum
  Obrigatório	Sim

  Especifica a porcentagem de traces amostrados upstream a serem capturados, com base no ID do trace. Consulte Configurar amostragem: amostrador baseado na proporção de Trace ID.

  Importante

  A propriedade ratio é obrigatória ao usar o amostrador trace_id_ratio_based. Se uma proporção não for definida, o Adaptive Sampler padrão será usado para este contexto em vez disso.

  distributed_tracing:
    sampler:
      remote_parent_sampled:
        trace_id_ratio_based:
          ratio: 0.2  # Sample 20% of traces sampled by upstream

  Copiar

Configura o amostrador usado para o contexto de pai remoto não amostrado (um serviço upstream decidiu NÃO amostrar este trace). Os valores possíveis são:

• adaptive: use o Adaptive Sampler padrão da New Relic.

  • Parâmetro opcional: sampler.remote_parent_not_sampled.adaptive.sampling_target

• trace_id_ratio_based: amostrar uma porcentagem fixa de trace com base no ID do trace

  • Parâmetro obrigatório: sampler.remote_parent_not_sampled.trace_id_ratio_based.ratio

• always_on: Amostre todos os remote_parent_not_sampled trace.

• always_off: não amostrar remote_parent_not_sampled trace.

  distributed_tracing:
    sampler:
      remote_parent_not_sampled: always_off

  Copiar

  remote_parent_not_sampled.adaptive.sampling_target

  Tipo	Inteiro, entre 1 (inclusive) e 120 (inclusive)
  Padrão	sampler.adaptive_sampling_target
  Obrigatório	Não

  Sobrescreve o adaptive_sampling_target global apenas para o contexto remote_parent_not_sampled.

  Como o Adaptive Sampler geralmente não amostra trace que não foram amostrados por um serviço upstream, essa configuração geralmente não tem efeito. Para garantir a captura de alguns trace remote_parent_not_sampled, prefira o amostrador trace_id_ratio_based.

  remote_parent_not_sampled.trace_id_ratio_based.ratio

  Tipo	float, entre 0,0 (exclusivo) e 1,0 (inclusivo)
  Padrão	Nenhum
  Obrigatório	Sim

  Especifica a porcentagem de trace a capturar, com base no ID do trace. Consulte Configurar amostragem: amostrador baseado na proporção de trace ID.

  Importante

  A propriedade ratio é obrigatória ao usar o amostrador trace_id_ratio_based. Se uma proporção não for definida, o Adaptive Sampler padrão será usado para este contexto em vez disso.

  distributed_tracing:
    sampler:
      remote_parent_not_sampled:
        trace_id_ratio_based:
          ratio: 0.05  # Sample 5% even if upstream said not to

  Copiar

  Cuidado

  Substituir as decisões upstream de "não amostrado" pode criar trace fragmentados onde apenas alguns serviços estão presentes. Use este padrão apenas quando tiver uma necessidade específica de ver a atividade em um serviço downstream, mesmo quando o upstream não a amostrou.

Para obter ajuda para obter uma entrada válida de host do observador trace do Infinite Tracing, consulte localizar ou criar um Trace Observer.

Você pode configurar isso via YAML:

infinite_tracing:
  trace_observer:
    host: YOUR_TRACE_OBSERVER_HOST

Você também pode usar a propriedade do sistema newrelic.config.infinite_tracing.trace_observer.host ou a variável de ambiente NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST.

Usado para ativar/desativar relatórios de eventos de extensão.

• Determina o número de eventos de span que podem ser capturados durante um ciclo de coleta de agente. Disponível no agente Java 7.4.0 e superior.

• Ao configurar o agente para AI Monitoring, defina o valor máximo 10000. Garante que a quantidade máxima de rastreamento seja capturada.

  Importante

  Aumentar o número de eventos de span pode levar a sobrecarga adicional do agente.

Esta configuração pode ser usada para ativar ou desativar todos os atributos do evento span. Se attributes.enabled no nível raiz for false, nenhum atributo será enviado para span evento, independentemente de como esta propriedade (span_events.attributes.enabled) estiver definida.

Se atributo estiver habilitado para span evento, todas as chaves de atributo encontradas nesta lista serão enviadas para New Relic em span_events. Para mais informações, consulte as regras de atribuição de agentes.

Todas as chaves de atributo encontradas nesta lista não serão enviadas para New Relic no evento span. Para mais informações, consulte as regras de atribuição de agentes.

o rastreamento multiaplicativo está habilitado por padrão. Defina isso como falso para desligá-lo.