Configurações do tracer de transação do agente Java

O tracer de transação está habilitado por padrão. Defina como false para desligá-lo.

Determina se o agente irá capturar o plano EXPLAIN para consulta lenta. Compatível apenas com MySQL e PostgreSQL.

Limite em segundos para o tempo de execução da consulta abaixo do qual a consulta lenta e o plano EXPLAIN (se compatível) não serão capturados. Relevante para consulta lenta somente quando record_sql está definido como raw ou obfuscated. Relevante para planos EXPLAIN somente quando explain_enabled está definido como true.

Para instruções SQL extensas, a execução das expressões regulares que tentam analisar as instruções exec e call pode levar um tempo considerável. Definir essa opção como verdadeira desativará a execução dessas expressões regulares complexas.

Essa configuração existe no agente Java versão 8.25.0+.

O limite de caracteres para a cadeia de consulta SQL. Se você tiver muitas consultas SQL lentas com grandes quantidades de informações, isso poderá afetar negativamente o desempenho ou a rapidez com que você vê seus dados no New Relic. Aumente o valor gradualmente até encontrar o equilíbrio certo entre informação e desempenho.

Defina como true para ativar o registro de consulta ao arquivo de log do agente em vez de fazer upload para o New Relic. consulta são logados usando o modo record_sql .

Quando o tracer de transação está ativado, as instruções de consulta podem ser gravadas opcionalmente. O gravador possui três modos:

• off: Não envie nenhuma consulta.
• raw: Envie a instrução de consulta em seu formato original.
• obfuscated: remove literais numéricos e de string.

Controla a adição de comentários ao início de instruções SQL executadas, a serem utilizados pelo produto New Relic Query Performance Monitoring para vinculação de entidades. O padrão é falso.

Um comentário resultante seria semelhante a este: /nr_service_guid=MTE3NDc2MDB8QVBNfAAAAAxJQEEEEE9OfDI4MTc5NDEIEA/

Esta opção é apenas para Play 2.x+. A instrumentação Play/Scala pode usar Thread.getStackTrace() para melhorar a nomenclatura tracer , mas ao custo de maior sobrecarga.

Define um limite (em segundos) para coletar rastreamento de pilha de uma chamada SQL. Quando as instruções SQL excederem esse limite, o agente capturará o stack trace atual. Isso é útil para identificar a origem das longas chamadas SQL.

Use esta configuração para controlar a variedade do seu rastreamento de transação. top_n é um número inteiro que representa o número de transações lentas e exclusivas para as quais o rastreamento será criado.

• Se você deseja que o trace da transação reflita com mais precisão as transações reais mais lentas em seu aplicativo, torne esse valor menor.

• Se você deseja amostrar uma matriz mais diversificada de transações, torne o valor mais alto.

  Um valor de 0 significaria que apenas a transação mais lenta sempre gera um trace. No entanto, isso não é considerado ideal, porque pode haver uma ou duas transações que são sempre as mais lentas, e ver repetidamente esse mesmo trace da transação provavelmente não trará muito valor.

  Se a mesma transação for frequentemente a mais lenta, a configuração top_n permitirá que o agente Java (ao longo do tempo) obtenha amostras das transações n mais lentas. Isso oferece maior variedade e mais insights sobre seu aplicativo.

O limite de tempo usado para determinar quando uma transação é elegível para ser rastreada. Quando o tempo de resposta da transação excede esse limite, a transação se torna elegível para um rastreamento de transação. Se amostrado, esse rastreamento de transação será registrado e enviado para New Relic.

O padrão é apdex_f (padrão), que define o limite como o nível de Apdex "Frustrated" (quatro vezes o apdex_t valor ). Você também pode definir um limite de tempo específico inserindo um valor float que representa um número de segundos.

Por padrão, o modo de alta segurança não permite que o agente colete consulta lenta. Habilite esta opção para coletar consultas Cassandra do driver DataStax, mesmo com alta segurança habilitada. Caso não utilize alta segurança, o agente coleta a consulta lenta automaticamente.

Para o driver DataStax 2.1.2, adicione esta regra à sua lista de permissões:

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Para o driver DataStax 3.0.0, adicione esta regra à sua lista de permissões:

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

Por padrão, o modo de alta segurança não permite que o agente colete consulta lenta. Habilite esta opção para coletar consultas Cassandra do driver DataStax, mesmo com alta segurança habilitada. Caso não utilize alta segurança, o agente coleta a consulta lenta automaticamente.

Para o driver DataStax 2.1.2, adicione esta regra à sua lista de permissões:

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Para o driver DataStax 3.0.0, adicione esta regra à sua lista de permissões:

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

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

Se os atributo estiverem habilitados para rastreamento da transação, todas as chaves de atributo encontradas nesta lista serão enviadas para a New Relic no rastreamento da transação. 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 à New Relic no rastreamento da transação. Para mais informações, consulte as regras de atribuição de agentes.

Limita o número de tokens que podem ser criados por transação. Aumentar esse valor pode afetar o desempenho, pois aumenta a quantidade de memória que o agente usa e a quantidade de dados enviados para o New Relic.

Limita o número de segmentos que podem ser criados por transação. Aumentar esse valor pode afetar o desempenho, pois aumenta a quantidade de memória que o agente usa e a quantidade de dados enviados para o New Relic.

Habilite o serviço de evento de transação.

O número máximo de eventos de transação amostrados relatados a cada 60 segundos.

Uma lista de mapas com as chaves emparelhadas header_name e o opcional header_alias. Escolha um ou mais cabeçalhos de solicitação HTTP personalizados para adicionar como atributo de transação.

Você pode listar a configuração de vários cabeçalhos:

transaction_events:
  custom_request_headers:
    -
      header_name: "X-Custom-Header-1"
    -
      header_name: "X-Custom-Header-2"
      header_alias: "CustomHeader2alias"

No primeiro conjunto de mapas, X-Custom-Header-1 é capturado e relatado pelo agente como o nome do cabeçalho para um valor correspondente do objeto de solicitação. O header_name também será o nome do atributo enviado para New Relic.

No segundo conjunto de mapas, o cabeçalho da solicitação é X-Custom-Header-2, mas CustomHeader2alias é o nome enviado para New Relic.

Esta configuração pode ser usada para ativar ou desativar todos os atributos do evento de transação. Se attributes.enabled for false no nível raiz, nenhum atributo será enviado para o evento de transação, independentemente de como essa propriedade estiver configurada em transaction_events.

Se o atributo estiver habilitado para evento de transação, todas as chaves de atributo encontradas nesta lista serão enviadas para a New Relic no evento de transação. 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 a New Relic em evento de transação. Para mais informações, consulte as regras de atribuição de agentes.

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

Se atributo estiver habilitado para segmentos de transação, todas as chaves de atributo encontradas nesta lista serão enviadas para a New Relic em segmentos de transação. 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 a New Relic em segmentos de transação. Para mais informações, consulte as regras de atribuição de agentes.

Adiciona propriedades de mensagem ao atributo tracer . Defina como false para desligá-lo.