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

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

Criar um problema

Configuração do agente Ruby

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:

  1. Adicione o prefixo NEW_RELIC_ ao nome da configuração.
  2. 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:

  1. Variáveis ambientais
  2. Configuração no lado do servidor
  3. Arquivo de configuração (newrelic.yml)
  4. 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. Geralmente inclui uma seção Defaults na parte superior, além de seções abaixo para cada ambiente de aplicativo; por exemplo, Development, Testing 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, por exemplo, quando você deseja usar info para a configuração log_level em seu ambiente de produção e deseja configurações 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: info
development:
<<: *default_settings
log_level: debug

Para aplicativos não Rails, o agente Ruby procura as seguintes variáveis de ambiente, nesta ordem, para determinar o ambiente do aplicativo:

  1. NEW_RELIC_ENV
  2. RUBY_ENV
  3. RAILS_ENV
  4. APP_ENV
  5. 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 determinar 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 ou RAILS.env, dependendo da versão do Rails).

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.

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.

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 método Ruby NewRelic::Agent.notice_error , consulte a API Ruby do agente.

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.

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.

Evento de transação

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:

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.

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

Log de auditoria

Começo automático

Nível do código métrico

Configuração Errors Inbox

Definir uma das tags a seguir ajudará você a identificar quais versões do seu software estão produzindo erros.

  • NEW_RELIC_METADATA_SERVICE_VERSION irá criar tag.service.version nos dados do evento contendo a versão do seu código que está implantada, em muitos casos uma versão semântica como 1.2.3, mas nem sempre.
  • NEW_RELIC_METADATA_RELEASE_TAG criará tags.releaseTag nos dados do evento contendo a tag de lançamento (como v0.1.209 ou release-209).
  • NEW_RELIC_METADATA_COMMIT criará tag.commit nos dados do evento contendo o commit sha. O sha inteiro pode ser usado ou apenas os primeiros sete caracteres (por exemplo, 734713b).

Uma próxima versão da Errors Inbox rastreará automaticamente quais versões do seu software estão produzindo erros. Quaisquer dados de versão também serão exibidos no CodeStream.

Tracer multiaplicativo

Atributo personalizado

Evento personalizado

Tracer de armazenamento de dados

Desativando

Use essas configurações para alternar os tipos de instrumentação durante a inicialização do agente.

Distributed tracing

Elasticsearch

Heroku

Rastreamento infinito

Instrumentação

Tracer de mensagens

Mongo

Anfitrião do processo

Ancinho

Regras

Modo sem servidor

Auxiliar

SQL lento

Evento de extensão

Remover mensagens de exceção

Stripe

Profiler de thread

Utilização

Copyright © 2024 New Relic Inc.

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