Você pode configurar o agente New Relic Ruby com configurações em um arquivo de configuração, variáveis de ambiente ou programaticamente com Configuração no lado do servidor. Este documento resume as opções de configuração disponíveis para o agente Ruby.
Se o valor padrão para uma opção de configuração for (Dynamic)
, isso significa que o agente Ruby calcula o padrão em tempo de execução. O valor da configuração padrão é o valor de outra configuração, conforme apropriado.
Métodos de configuração e precedência
O método principal (padrão) para configurar o agente Ruby é por meio do arquivo de configuração (newrelic.yml
) no subdiretório config
. Para definir valores de configuração usando variáveis de ambiente:
- Adicione o prefixo
NEW_RELIC_
ao nome da configuração. - Substitua quaisquer pontos
.
por sublinhados_
.
Você também pode configurar alguns valores na interface via configuração no lado do servidor.
O agente Ruby segue esta ordem de precedência para configuração:
- Variáveis ambientais
- Configuração no lado do servidor
- Arquivo de configuração (
newrelic.yml
) - Configurações de configuração padrão
Em outras palavras, as variáveis de ambiente substituem todas as outras definições e informações de configuração, a configuração no lado do servidor substitui o arquivo de configuração e as definições de configuração padrão e assim por diante.
Visualizar e editar opções do arquivo de configuração
O newrelic.yml
do agente Ruby é um arquivo de configuração YAML padrão. Normalmente inclui uma seção Defaults
na parte superior, além de seções abaixo para cada ambiente de aplicativo (Development
, Test
, Staging
e Production
).
O agente Ruby determina qual seção do arquivo de configuração newrelic.yml
ler, observando determinadas variáveis de ambiente para derivar o ambiente do aplicativo. Isso pode ser útil quando você deseja usar info
para a configuração log_level
em seu ambiente de produção e deseja configurações de log_level
mais detalhadas (como debug
) em seu ambiente de desenvolvimento.
Aqui está um exemplo de arquivo de configuração newrelic.yml
:
common: &default_settings license_key: 'YOUR_LICENSE_KEY' app_name: 'My Application Name'production: <<: *default_settings log_level: infodevelopment: <<: *default_settings log_level: debug
O agente Ruby procura as seguintes variáveis de ambiente, nesta ordem, para localizar o ambiente do aplicativo:
NEW_RELIC_ENV
RUBY_ENV
RAILS_ENV
APP_ENV
RACK_ENV
Se o agente Ruby não detectar valores para nenhuma dessas variáveis de ambiente, ele padronizará o ambiente do aplicativo como development
e lerá a seção development
do arquivo de configuração newrelic.yml
.
Ao executar o agente Ruby em um aplicativo Rails, o agente primeiro procura a variável de ambiente NEW_RELIC_ENV
para encontrar o ambiente do aplicativo e qual seção do newrelic.yml
usar. Se NEW_RELIC_ENV
não estiver presente, o agente usa o ambiente Rails (RAILS_ENV
).
Ao editar o arquivo de configuração, certifique-se de:
- Recuar apenas com dois espaços.
- Recue apenas quando relevante, em seções como
error_collector
.
Se você não recuar corretamente, o agente poderá gerar um erro Unable to parse configuration file
na inicialização.
Para visualizar a lista mais atual de opções de configuração do agente Ruby disponíveis, use o comando rake newrelic:config:docs
. Este documento descreve as opções mais comuns.
Atualize o arquivo de configuração
Esta documentação se aplica à versão mais recente do agente Ruby. Para obter detalhes sobre versões anteriores, consulte os comentários no próprio newrelic.yml
.
Para atualizar o arquivo newrelic.yml
após uma nova versão, use o modelo no diretório base do gem do agente. Ao atualizar para novas versões do gem, examine ou diferencie config/newrelic.yml
e newrelic.yml
no diretório de instalação para aproveitar as novas opções de configuração.
Importante
Atualizar a gem não atualiza automaticamente config/newrelic.yml
.
Em geral
Essas configurações estão disponíveis para configuração do agente. Algumas configurações dependem do nível de assinatura do seu New Relic.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, permite que o agente Ruby seja executado.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique o nome do aplicativo usado para agregar dados na interface do New Relic. Para relatar dados para vários aplicativos ao mesmo tempo, especifique uma lista de nomes separados por ponto e vírgula ;
. Por exemplo, MyApp
ou MyStagingApp;Instance1
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Sua New Relic .
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define o nível de detalhe da mensagem do log. Os possíveis níveis de log, em detalhamento crescente, são: error
, warn
, info
ou debug
.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Uma variedade de nomes de eventos personalizados do ActiveSupport para assinatura e instrumento. Por exemplo,
- one.custom.event
- another.event
- a.third.event
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Sua New Relic . Obrigatório ao usar a API REST v2 do New Relic para registrar a implantação usando o comando newrelic deployments
.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Backporta a pesquisa de conexão ActiveRecord mais rápida introduzida no Rails 6, que melhora o desempenho do agente quando instrumentado ActiveRecord. Observe que esta configuração pode não ser compatível com outras gemas que corrigem o ActiveRecord.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Substituição manual do caminho para seu pacote de CA local. Este pacote CA será usado para validar o certificado SSL apresentado pelo serviço de coleta de dados da New Relic.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Habilite ou desabilite a captura de chaves do memcache do rastreamento da transação.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Quando true
, o agente captura parâmetros de solicitação HTTP e os anexa ao rastreamento da transação, erros de rastreamento e eventoTransactionError
.
Cuidado
Ao usar a configuração capture_params
, o agente Ruby não tentará filtrar informações secretas. Recommendation:
Para filtrar informações secretas do parâmetro de solicitação, use a configuraçãoattributes.include
. Para mais informações, veja os exemplos de atributo Ruby .
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente liberará Tracer::State
em Agent.drop_buffered_data
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Caminho para newrelic.yml
. Se indefinido, o agente verifica os seguintes diretórios (em ordem):
config/newrelic.yml
newrelic.yml
$HOME/.newrelic/newrelic.yml
$HOME/newrelic.yml
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Permite que cabeçalhos distributed tracing newrelic sejam suprimidos em solicitações de saída.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
O manipulador de saída que envia todos os dados armazenados em cache para o coletor antes do encerramento é instalado à força. Isto é verdade mesmo quando detecta cenários onde geralmente não deveria estar. O caso de uso conhecido para esta opção é quando o Sinatra é executado como um serviço incorporado em outra framework. O agente detecta o aplicativo Sinatra e, como resultado, ignora o gerenciador at_exit
. Sinatra normalmente executa o aplicativo inteiro em um bloco at_exit
e, de outra forma, se comportaria mal se o manipulador at_exit
do agente também fosse instalado nessas circunstâncias. Nota: send_data_on_exit
também deve ser definido como true
junto com esta configuração.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, ativa o modo de alta segurança. Certifique-se de compreender as implicações do modo de alta segurança antes de ativar esta configuração.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Um dicionário de nomes e valores de rótulos que serão aplicados aos dados enviados deste agente. Também pode ser expresso como uma sequência ;
delimitada por ponto e vírgula de pares :
separados por dois pontos. Por exemplo, Server:One;Data Center:Primary
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define um nome para o arquivo de log.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define um caminho para o arquivo de log do agente, excluindo o nome do arquivo.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Especifica um empacotador para transmitir dados ao coletor New Relic. Atualmente json
é o único valor válido para esta configuração.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Quando true
, o agente transmite dados sobre seu aplicativo para o coletor New Relic .
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, usará Module#prepend
em vez de alias_method
para instrumentação ActiveRecord.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define um host para comunicação com o coletor New Relic por meio de um servidor proxy.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define uma senha para comunicação com o coletor New Relic por meio de um servidor proxy.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define uma porta para comunicação com o coletor New Relic por meio de um servidor proxy.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define um usuário para comunicação com o coletor New Relic por meio de um servidor proxy.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Aplica configurações de política de segurança do agente de idioma.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita o manipulador de saída que envia dados para o coletor New Relic antes de encerrar.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Quando definido como true
, força uma conexão síncrona com o coletor New Relic durante a inicialização do aplicativo. Para processos de curta duração, isso ajuda a garantir que o agente da New Relic tenha tempo para reportar.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o armazenamento do estado tracer for thread-local, caso contrário fiber-local
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define o número máximo de segundos que o agente deve gastar tentando se conectar ao coletor.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, permite a captura de todos os cabeçalhos de solicitação HTTP para todos os destinos.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, quando o agente estiver em um aplicativo usando Ruby on Rails, ele será iniciado após a execução de config/initializers
.
Cuidado
Esta opção só pode ser definida por variável de ambiente.
Tracerde transação
O recurso trace da transação coleta informações detalhadas de uma seleção de transações, incluindo um resumo da sequência de chamada, um detalhamento do tempo gasto e uma lista de consultas SQL e seus planos de consulta (em MySQL e postgresql). Os recursos disponíveis dependem do nível de assinatura do seu New Relic.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a coleta de rastreamento da transação.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a coleta de planos explicativos no rastreamento da transação. Essa configuração também será aplicada para explicar planos em rastreamento SQL lento se slow_sql.explain_enabled
não for definido separadamente.
Tipo | Float |
---|---|
Padrão |
|
Variável ambiental |
|
Limite (em segundos) acima do qual o agente coletará planos explicativos. Relevante apenas quando explain_enabled
for verdadeiro.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Número máximo de nós de rastreamento de transação a serem registrados em um único rastreamento de transação.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente registra os argumentos do comando Redis no rastreamento da transação.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Nível de ofuscação para consulta SQL reportado em nós de rastreamento da transação.
Por padrão, isso é definido como obfuscated
, que elimina os literais numéricos e de string.
- Se você não quiser que o agente capture informações de consulta, defina como
none
. - Se quiser que o agente capture todas as informações da consulta em seu formato original, defina como
raw
. - Quando você ativa o modo de alta segurança, ele é automaticamente definido como
obfuscated
.
Tipo | Float |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique um limite em segundos. O agente inclui rastreamento de pilha nos nós de rastreamento da transação quando a duração stack trace excede esse limite.
Tipo | Float |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique um limite em segundos. transações com duração superior a esse limite são elegíveis para rastreamento da transação. Especifique um valor float ou a sequência apdex_f
.
Erro no coletor
O agente coleta e relata todas as exceções não detectadas por padrão. Essas opções de configuração permitem personalizar a coleta de erros.
Para obter informações sobre erros ignorados e esperados, consulte esta página em Error Analytics no APM. Para definir erro esperado através do NewRelic::Agent.notice_error
Ruby método , consulte a Ruby API do agente.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Uma lista de classes de erros que o agente deve ignorar.
Cuidado
Esta opção não pode ser definida por meio de variável de ambiente.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente coleta TransactionError
evento.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura erros de rastreamento e métrica de contagem de erros.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Uma lista de classes de erros que o agente deve tratar conforme esperado.
Cuidado
Esta opção não pode ser definida por meio de variável de ambiente.
Tipo | Hash |
---|---|
Padrão |
|
Variável ambiental |
|
Um mapa de classes de erro para uma lista de mensagens. Quando ocorrer um erro de uma das classes especificadas aqui, se sua mensagem de erro contiver uma das strings correspondentes aqui, esse erro será tratado conforme o esperado.
Cuidado
Esta opção não pode ser definida por meio de variável de ambiente.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Uma lista separada por vírgulas de códigos de status, possivelmente incluindo intervalos. Erros associados a esses códigos de status, quando aplicável, serão tratados conforme esperado.
Tipo | Hash |
---|---|
Padrão |
|
Variável ambiental |
|
Um mapa de classes de erro para uma lista de mensagens. Quando ocorrer um erro de uma das classes aqui especificadas, se sua mensagem de erro contiver uma das strings correspondentes aqui, esse erro será ignorado.
Cuidado
Esta opção não pode ser definida por meio de variável de ambiente.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Uma lista separada por vírgulas de códigos de status, possivelmente incluindo intervalos. Os erros associados a estes códigos de status, quando aplicável, serão ignorados.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define o número máximo de quadros em um backtrace de erro. Os backtraces acima desse valor são truncados no meio, preservando o início e o fim do stack trace.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define o número máximo de TransactionError
eventos reportados por ciclo de coleta.
Monitoramento de browser
O recursode tempo de carregamento de página (às vezes chamado de monitoramento de usuário real ou RUM) fornece informações sobre o desempenho que o usuário real está obtendo em seu website. Isso é feito medindo o tempo que o browser do seu usuário leva para baixar e renderizar suas páginas da web, injetando uma pequena quantidade de código JavaScript no cabeçalho e rodapé de cada página.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a injeção automática do cabeçalho JavaScript para tempo de carregamento da página (às vezes chamado de monitoramento de usuário real ou RUM).
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a autoinjeção do Content Security Policy Nonce no script de monitoramento do Browser. Por enquanto, a injeção automática só funciona com Rails 5.2+.
Evento de transação
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a amostragem de eventos de transação.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define o número máximo de eventos de transação reportados de uma única colheita.
Registro do aplicativo
O agente Ruby oferece suporte ao logs contextualizados APM. Para obter algumas dicas sobre como configurar o log para o agente Ruby, consulte Configurar logs contextualizados Ruby.
As opções de configuração relacionadas ao registro disponíveis incluem:
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a decoração de log e a coleta de evento de log e métrica.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura registros de log emitidos pelo seu aplicativo.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define o nível mínimo que um evento de log deve ter para ser encaminhado ao New Relic.
Isso é baseado nos valores inteiros das constantes Logger::Severity
do Ruby: https://github.com/ruby/ruby/blob/master/lib/logger/severity.rb
A intenção é encaminhar o log com o nível dado à configuração, bem como qualquer log com maior nível de severidade.
Por exemplo, definir esse valor como "debug" encaminhará todos os eventos de log para o New Relic. Definir este valor como "erro" apenas encaminhará eventos de log com os níveis "erro", "fatal" e "desconhecido".
Valores válidos (ordenados do menor para o maior):
- "depurar"
- "informações"
- "avisar"
- "erro"
- "fatal"
- "desconhecido"
Tipo | Hash |
---|---|
Padrão |
|
Variável ambiental |
|
Aplica hash com pares de valores principais para adicionar como atributo personalizado a todos os eventos de log encaminhados para New Relic. Se enviar usando uma variável de ambiente, o valor deve ser formatado como: "key1=value1,key2=value2"
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define o número máximo de registros de log para armazenar em buffer na memória por vez.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente decora o log com metadados para vincular entidade, hosts, rastreamento e spans.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura métricas relacionadas à geração de registros para seu aplicativo.
AI Monitoring
Esta seção inclui configuração do agente Ruby para configurar AI Monitoring.
Importante
Você precisa habilitar distributed tracing para capturar dados trace e feedback. Ele está ativado por padrão no agente Ruby 8.0.0 e superior.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se false
, toda a instrumentação LLM (apenas OpenAI por enquanto) será desativada e nenhuma métrica, evento ou intervalo será enviado. O AI Monitoring será desativado automaticamente se o modo high_security
estiver ativado.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se false
, a instrumentação LLM (apenas OpenAI por enquanto) não capturará conteúdo de entrada e saída em evento LLM específico.
Os atributos excluídos incluem:
content
do evento LlmChatCompletionMessageinput
do evento LlmEmbeddingEsta é uma configuração de segurança opcional para evitar a gravação de dados confidenciais enviados e recebidos de seus LLMs.
Atributo
atributo são pares de valores principais contendo informações que determinam as propriedades de um evento ou transação. Esses pares de valor principal podem ser visualizados no rastreamento da transação no APM, rastreamento de erros no APM, evento de transação no painel e visualizações de página no painel. Você pode personalizar exatamente qual atributo será enviado para cada um desses destinos
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a captura de atributo para todos os destinos.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo de atributo para excluir de todos os destinos. Permite *
como curinga no final.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo de atributo a incluir em todos os destinos. Permite *
como curinga no final.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura o atributo do monitoramento do Browser.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo de atributo para excluir do monitoramento de Browser. Permite *
como curinga no final.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo de atributo a incluir no monitoramento de Browser. Permite *
como curinga no final.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura um atributo da coleta de erros.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo de atributo para excluir da coleta de erros. Permite *
como curinga no final.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo do atributo a ser incluído na coleta de erros. Permite *
como curinga no final.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura o atributo no evento span.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo do atributo para excluir do evento span. Permite *
como curinga no final.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo do atributo a incluir no evento span. Permite *
como curinga no final.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura o atributo do evento de transação.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo do atributo para excluir do evento de transação. Permite *
como curinga no final.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo do atributo a ser incluído no evento da transação. Permite *
como curinga no final.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura atributo em segmentos de transação.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo de atributo para excluir dos segmentos de transação. Permite *
como curinga no final.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo do atributo a ser incluído nos segmentos da transação. Permite *
como curinga no final.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura o atributo do rastreamento da transação.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo de atributo para excluir do rastreamento da transação. Permite *
como curinga no final.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Prefixo do atributo a incluir no rastreamento da transação. Permite *
como curinga no final.
Log de auditoria
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, ativa um log de auditoria que registra comunicações com o coletor New Relic .
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Lista de endpoints permitidos para inclusão no log de auditoria.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Especifica um caminho para o arquivo de log de auditoria (incluindo o nome do arquivo).
Começo automático
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique uma lista de constantes que devem impedir que o agente seja iniciado automaticamente. Separe as constantes individuais com uma vírgula ,
. Por exemplo, "Rails::Console,UninstrumentedBackgroundJob"
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define uma lista delimitada por vírgulas de executáveis que o agente não deve utilizar. Por exemplo, "rake,my_ruby_script.rb"
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define uma lista delimitada por vírgulas de tarefas Rake que o agente não deve utilizar. Por exemplo, "assets:precompile,db:migrate"
.
Nível do código métrico
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente reportará a métrica de nível de código-fonte para métodos de rastreamento. Consulte: https://docs.newrelic.com/docs/apm/agents/ruby-agent/features/ruby-codestream-integration/
Tracer multiaplicativo
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
DEPRECATED Consulte: distributed_tracing.enabled.
Se true
, habilita o rastreamento multiaplicativo quando distributed_tracing.enabled
estiver configurado como false
.
Atributo personalizado
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se false
, o atributo personalizado não será enviado no evento.
Evento personalizado
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura o evento personalizado.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
- Especifique um número máximo de eventos personalizados para armazenar em buffer na memória por vez.
- Ao configurar o agente para AI Monitoring, defina o valor máximo
100000
. Isso garante que o agente capture a quantidade máxima de eventos LLM.
Tracer de armazenamento de dados
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se false
, o agente não adicionará o parâmetro database_name
à transação ou ao rastreamento SQL lento.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se false
, o agente não reportará métrica da instância do datastore, nem adicionará parâmetro host
ou port_path_or_id
para operação ou rastreamento SQL lento.
Desativando
Use essas configurações para alternar os tipos de instrumentação durante a inicialização do agente.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação do Action Cable.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação do Action Controller.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação da Action Mailbox.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação do Action Mailer.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação do Active Job.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação do Active Storage.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação do Active Support.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desabilita a instrumentação do Active Record.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação para Active Record 4+
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente não fará uma amostragem do uso da CPU do processo host.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente não medirá a profundidade das filas de trabalhos atrasados.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa o uso de GC::Profiler
para medir o tempo gasto na coleta de lixo
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente não fará uma amostra do uso de memória do processo host.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente não agrupará middlewares de terceiros na instrumentação (independentemente de serem instalados via Rack::Builder
ou Rails).
Importante
Quando a instrumentação de middleware estiver desabilitada, se um aplicativo estiver usando middleware que possa alterar o código de resposta, o código de status HTTP relatado na transação poderá não refletir o valor alterado.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desabilita a coleta de métricas do amostrador. Métricas de amostra são métricas que não são baseadas em eventos (como tempo de CPU ou uso de memória).
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação Sequel.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação do Sidekiq.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desabilita o middleware do agente para Roda. Este middleware é responsável pelo suporte avançado a recursos, como tempo de carregamento de página e coleta de erros.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desabilita o middleware do agente para Sinatra. Este middleware é responsável pelo suporte avançado a recursos como rastreamento multiaplicativo, tempo de carregamento de página e coleta de erros.
Importante
O rastreamento multiaplicativo foi descontinuado em favor do distributed tracing. distributed tracing está ativado por padrão para o agente Ruby versões 8.0.0 e superiores. Middlewares não são necessários para suportar distributed tracing.
Para continuar usando o rastreamento multiaplicativo, atualize as seguintes opções no arquivo de configuração newrelic.yml
:
# newrelic.yml
cross_application_tracer: enabled: true distributed_tracing: enabled: false
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, desativa a instrumentação de visualização.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente não coletará amostras de medidas de desempenho da VM Ruby.
Distributed tracing
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Distributed tracing permite ver o caminho que uma solicitação percorre em seus sistemas distribuídos. Habilitar distributed tracing altera o comportamento de alguns recursos do New Relic, portanto consulte cuidadosamente o guia de transição antes de habilitar este recurso.
Elasticsearch
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura a consulta do Elasticsearch no rastreamento da transação.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente ofusca a consulta do Elasticsearch no rastreamento da transação.
Heroku
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente usará nomes dinâmicos Heroku como nome do host.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Normalmente, o agente relata nomes dinâmicos com um ponto final e um ID de processo (por exemplo, worker.3
). Você pode remover esses dados finais especificando os prefixos que deseja relatar sem dados finais (por exemplo, worker
).
Rastreamento infinito
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Configura o nome do host para o host observador trace . Quando configurado, permite amostras baseadas na cauda, enviando todos os intervalos registrados para um observador trace para decisões de amostragem adicionais, independentemente de qualquer decisão usual de amostragem do agente.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Configura a porta TCP/IP para o host observador trace
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
(o padrão), os dados enviados ao observador trace serão agrupados em lote em vez de enviar cada intervalo individualmente.
Tipo | Símbolo |
---|---|
Padrão |
|
Variável ambiental |
|
Configure o nível de compactação dos dados enviados ao observador trace .
Pode ser um dos seguintes: :none
, :low
, :medium
, :high
.
Defina o nível como :none
para desativar a compactação.
Instrumentação
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de ActiveSupport::BroadcastLogger
na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
. Usado em versões Rails >= 7.1.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de ActiveSupport::Logger
na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
. Usado em versões Rails abaixo de 7.1.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de Async::HTTP na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do bunny na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da biblioteca opensearch-ruby na inicialização. Pode ser um de auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da biblioteca aws-sdk-sqs na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da biblioteca aws-sdk-dynamodb na inicialização. Pode ser um de auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da classe Fiber na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da biblioteca Ruby simultânea na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Curb na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do trabalho atrasado na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da biblioteca elasticsearch na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do ethon na inicialização. Pode ser um de auto
, prepend
, chain
, disabled
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Excon na inicialização. Pode ser um dos seguintes: enabled
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Grape na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de clientes gRPC na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Especifica uma lista de padrões de nome do host separados por vírgulas que corresponderão ao nome do host gRPC para o qual o tráfego deve ser ignorado pelo New Relic. A instrumentação do cliente gRPC da New Relic ignorará o tráfego transmitido para um host que corresponda a qualquer um desses padrões, e a instrumentação do servidor gRPC da New Relic ignorará o tráfego para um servidor em execução em um host cujo nome do host corresponda a qualquer um desses padrões. Por padrão, nenhum tráfego é ignorado quando a instrumentação gRPC está habilitada. Por exemplo, "private.com$,exception.*"
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de servidores gRPC na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do HTTPClient na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da gem http.rb na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de httpx na inicialização. Pode ser um de auto
, prepend
, chain
, disabled
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do agente da biblioteca padrão Ruby na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da biblioteca LogStasher na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do dalli gem para Memcache na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do gem memcached para Memcache na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da gema do cliente memcache para Memcache na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Mongo na inicialização. Pode ser um dos seguintes: enabled
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de Net::HTTP
na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da gema ruby-openai na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
. O padrão é disabled
no modo de alta segurança.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de Puma::Rack
. Quando ativado, o agente se conecta ao método to_app
em Puma::Rack::Builder
para encontrar gemas para o instrumento durante a inicialização do aplicativo. Pode ser um dos: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de Puma::Rack::URLMap
na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Rack. Quando ativado, o agente se conecta ao método to_app
em Rack::Builder
para encontrar gemas para o instrumento durante a inicialização do aplicativo. Pode ser um dos: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de Rack::URLMap
na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do rake na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Redis na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática de resque na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Roda na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Sinatra na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Stripe na inicialização. Pode ser um dos seguintes: enabled
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do ViewComponent na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da classe Thread na inicialização para permitir que o agente aninhe corretamente os spans dentro de uma transação assíncrona. Isso não permite que o agente trace automaticamente todos os threads criados (consulte instrumentation.thread.tracing
). Pode ser um de: auto
, prepend
, chain
, disabled
.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da classe Thread na inicialização para adicionar automaticamente rastreamento a todos os Threads criados no aplicativo.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática da biblioteca de renderização de modelos Tilt na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Controla a instrumentação automática do Typhoeus na inicialização. Pode ser um dos seguintes: auto
, prepend
, chain
, disabled
.
Tracer de mensagens
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente coletará metadados sobre mensagens e os anexará como parâmetro de segmento.
Mongo
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura a consulta Mongo no rastreamento da transação.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente ofusca a consulta do Mongo no rastreamento da transação.
Opensearch
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente captura a consulta do OpenSearch no rastreamento da transação.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente ofusca a consulta do OpenSearch no rastreamento da transação.
Anfitrião do processo
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique um nome de host personalizado para exibição na interface do New Relic.
Ancinho
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique uma matriz de tarefas Rake para serem instrumentadas automaticamente. Esta opção de configuração converte a matriz em uma lista RegEx. Se quiser permitir todas as tarefas por padrão, use rake.tasks: [.+]
. Nenhuma tarefa de rake será instrumentada a menos que seja adicionada a esta lista. Para obter mais informações, visite a documentação sobre instrumentação do New Relic Rake.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Tempo limite para esperar a conclusão da conexão antes de uma tarefa rake
Regras
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Defina a transação que você deseja que o agente ignore, especificando uma lista de padrões que correspondem ao URI que você deseja ignorar. Para obter mais detalhes, consulte a documentação sobre como ignorar transações específicas.
Segurança
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente de segurança é carregado (um Ruby 'require' é executado)
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente de segurança será iniciado (o agente é executado em seu loop de eventos)
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define o modo em que o agente de segurança operará. Atualmente apenas IAST
é compatível
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define o URL do endpoint para postar dados relacionados à segurança
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a detecção de RCI (injeção remota de código)
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a detecção de RXSS (script entre sites refletidos)
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a detecção de desserialização
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
A porta em que o aplicativo está escutando. Esta configuração é obrigatória para servidores de passageiros. Outros servidores devem ser detectados por padrão.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define o limite do corpo da solicitação a ser processado no evento de segurança (em KB). O valor padrão é 300, para 300 KB.
Modo sem servidor
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente operará em um modo simplificado adequado para uso com função serverless de curta duração. NOTA: Somente a função do AWS Lambda é suportada atualmente e esta opção não se destina ao uso sem a oferta da camada Ruby Lambda da New Relic.
Auxiliar
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Uma matriz de strings que servirá coletivamente como uma lista de permissões para filtrar quais argumentos de trabalho do Sidekiq serão relatados ao New Relic. Para capturar quaisquer argumentos do Sidekiq, 'job.sidekiq.args.*' deve ser adicionado à opção de configuração :'attributes.include'
separada. Cada string nesta matriz será transformada em uma expressão regular por meio de Regexp.new
para permitir correspondência avançada. Para argumento de trabalho aplique hash, se uma chave ou valor corresponder, o par será incluído. Todos os elementos da matriz de argumentos de trabalho e escalares de argumentos de trabalho correspondentes serão incluídos.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Uma matriz de strings que servirá coletivamente como uma lista de bloqueios para filtrar quais argumentos de trabalho do Sidekiq serão relatados ao New Relic. Para capturar quaisquer argumentos do Sidekiq, 'job.sidekiq.args.*' deve ser adicionado à opção de configuração :'attributes.include'
separada. Cada string nesta matriz será transformada em uma expressão regular por meio de Regexp.new
para permitir correspondência avançada. Para argumento de trabalho aplique hash, se uma chave ou valor corresponder, o par será excluído. Todos os elementos da matriz de argumentos de trabalho e escalares de argumentos de trabalho correspondentes serão excluídos.
SQL lento
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente coleta consultas SQL lentas.
Tipo | Float |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique um limite em segundos. O agente coleta consultas SQL lentas e explica os planos que excedem esse limite.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente coleta planos explicativos em consulta SQL lenta. Se esta configuração for omitida, a configuração transaction_tracer.explain_enabled
também será aplicada como configuração padrão para planos de explicação em SQL lento.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Define um nível de ofuscação para consultas SQL lentas. As opções válidas são obfuscated
, raw
ou none
.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Gere um sql_id
mais longo para rastreamento SQL lento. sql_id
é usado para agregação de consultas semelhantes.
Evento de extensão
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita a amostragem de eventos de extensão.
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
Define o número máximo de eventos de span para buffer durante o streaming para o observador trace .
Tipo | Inteiro |
---|---|
Padrão |
|
Variável ambiental |
|
- Define o número máximo de eventos de span relatados de uma única coleta. Qualquer número inteiro entre
1
e10000
é válido.' - Ao configurar o agente para AI Monitoring, defina o valor máximo
10000
. Isso garante que o agente capture a quantidade máxima de rastreamento distribuído.
Remover mensagens de exceção
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se for verdade, o agente remove mensagens de todas as exceções, exceto aquelas na lista de permissões. Ativado automaticamente no modo de alta segurança.
Tipo | Corda |
---|---|
Padrão |
|
Variável ambiental |
|
Especifique uma lista de exceções que você não deseja que o agente remova quando strip_exception_messages for true
. Separe as exceções com vírgula. Por exemplo, "ImportantException,PreserveMessageException"
.
Stripe
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Uma matriz de strings para especificar quais chaves dentro do hash aplicar user_data
de um evento Stripe deve ser relatada ao New Relic. Cada string nesta matriz será transformada em uma expressão regular por meio de Regexp.new
para permitir correspondência avançada. Definir o valor como ["."]
reportará todos user_data
.
Tipo | Matriz |
---|---|
Padrão |
|
Variável ambiental |
|
Uma matriz de strings para especificar quais chaves e/ou valores dentro do hash de aplicação user_data
de um evento Stripe não devem ser relatados ao New Relic. Cada string nesta matriz será transformada em uma expressão regular por meio de Regexp.new
para permitir correspondência avançada. Para cada par de hash aplicado, se a chave ou o valor corresponderem, o par não será relatado. Por padrão, nenhum user_data
é relatado, portanto esta opção só deverá ser usada se a opção stripe.user_data.include
estiver sendo usada.
Profiler de thread
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, habilita o uso do thread profiler.
Utilização
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente detectará automaticamente que está em execução em um ambiente AWS.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente detecta automaticamente que está em execução em um ambiente do Azure.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente detecta automaticamente que está em execução no Docker.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente detectará automaticamente que está em execução em um ambiente do Google Cloud Platform.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente detectará automaticamente que está em execução no Kubernetes.
Tipo | Boleano |
---|---|
Padrão |
|
Variável ambiental |
|
Se true
, o agente detectará automaticamente que está em execução em um ambiente Pivotal Cloud Foundry.