Configure as definições principais do agente Ruby, incluindo nome do aplicativo, chave de licença, proxy, logging e comportamento geral do agente.
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 das mensagens do log. Os níveis de log possíveis, em ordem crescente de verbosidade, são: fatal, error, warn, info ou debug.
Tipo | Matriz |
|---|---|
Padrão |
|
Variável ambiental |
|
Uma matriz de nomes de eventos personalizados do ActiveSupport para assinar e instrumentar. Por exemplo: [one.custom.event, another.event, a.third.event]
Tipo | Boleano |
|---|---|
Padrão |
|
Variável ambiental |
|
Se true, o agente usará o nome da tabela do modelo ActiveRecord em vez do nome da classe ao nomear métricas, spans e segmentos de trace da transação do ActiveRecord. Isso pode reduzir a cardinalidade quando vários modelos compartilham uma tabela de banco de dados. O padrão é false.
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 de CA valida o certificado SSL apresentado pelo serviço de coleta de dados da New Relic.
Tipo | Boleano |
|---|---|
Padrão |
|
Variável ambiental |
|
Se true, o agente captura chaves do memcache no trace 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 |
|
Se true, suprime o cabeçalho de distributed tracing newrelic em requests de saída.
Tipo | Boleano |
|---|---|
Padrão |
|
Variável ambiental |
|
Se true, força o agente a instalar seu manipulador de saída (que envia todos os dados em cache para o coletor antes de encerrar), mesmo em casos em que o agente normalmente o ignoraria, como quando detecta o Sinatra sendo executado como um serviço embutido dentro de outro framework. O Sinatra executa todo o aplicativo dentro de seu próprio bloco at_exit, portanto, o agente ignora seu próprio manipulador at_exit por padrão para evitar conflitos. Esta configuração substitui isso. Observação: send_data_on_exit também deve ser true para que esta configuração tenha algum efeito.
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. Se desejar enviar os logs do agente para a saída padrão, defina isso como STDOUT.
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 | 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 | Matriz |
|---|---|
Padrão |
|
Variável ambiental |
|
Uma matriz de strings CLASS#METHOD (para métodos de instância) e/ou CLASS.METHOD (para métodos de classe) representando métodos Ruby aos quais o agente pode adicionar automaticamente instrumentação personalizada. Isso não requer nenhuma modificação no código-fonte que define os métodos.
Use nomes de classe totalmente qualificados (usando o delimitador :: ) que incluam qualquer namespace de módulo ou classe.
Aqui está um código-fonte Ruby que define um método de instância render_png para uma classe Image e um método de classe notify para uma classe User , ambos dentro de um namespace de módulo MyCompany :
module MyCompany class Image def render_png # code to render a PNG end end
class User def self.notify # code to notify users end end endDado esse código-fonte, o arquivo de configuração newrelic.yml pode solicitar instrumentação para ambos os métodos, assim:
automatic_custom_instrumentation_method_list: - MyCompany::Image#render_png - MyCompany::User.notifyEsse exemplo de configuração usa a sintaxe de matriz YAML para especificar ambos os métodos. Como alternativa, você pode usar uma string delimitada por vírgulas:
automatic_custom_instrumentation_method_list: 'MyCompany::Image#render_png, MyCompany::User.notify'O espaço em branco ao redor da(s) vírgula(s) na lista é opcional. Ao configurar o agente com uma lista de métodos por meio da variável de ambiente NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST , use este formato de string delimitada por vírgulas:
$export NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST='MyCompany::Image#render_png, MyCompany::User.notify'Tipo | Boleano |
|---|---|
Padrão |
|
Variável ambiental |
|
Se true, as métricas para chamadas de transmissão do Action Cable não incluirão o valor broadcasting para uma determinada transmissão. O padrão é false. O padrão pode mudar em um futuro lançamento de versão principal.
Tipo | Matriz |
|---|---|
Padrão |
|
Variável ambiental |
|
Uma lista de nomes de classes ou módulos de middleware que o agente deve ignorar. Exemplo: ["Rack::Cors", "ActionDispatch::Reloader"]
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.