Instale o agente New Relic Ruby

Nosso agente Ruby instrumenta automaticamente seu código para que você possa iniciar o monitoramento do aplicativo. Você pode usar nosso inicializador ou seguir as instruções neste documento para concluir a instalação básica do agente Ruby.

Instale a joia

1. A gema do agente Ruby está disponível em rubygems.org como newrelic_rpm. Para aplicativos usando Bundler, adicione esta jóia ao Gemfile:

   gem 'newrelic_rpm'

   Copiar

2. Para usar o Infinite Tracing, a gema Infinite Tracing também está disponível em rubygems.org como newrelic-infinite_tracing. Para aplicativos que usam Bundler, inclua adicionalmente a gema Infinite Tracing no Gemfile:

   gem 'newrelic-infinite_tracing'

   Copiar

3. A próxima etapa varia dependendo se você estiver usando Rails, Roda ou Sinatra:

   Ruby installation	Comments
   Se estiver usando Rails, Roda ou Sinatra	Rails: Rails chamará automaticamente Bundler.require e fará com que newrelic_rpm seja necessário durante a inicialização do seu aplicativo. Roda, Sinatra: se estiver usando Roda, Sinatra ou outro framework, você deverá chamar manualmente require 'newrelic_rpm'. Além disso, se você estiver usando o Rastreamento Infinito, chame manualmente require 'newrelic/infinite_tracing'. Como alternativa, chame manualmente Bundler.require, que também ativa o rastreamento infinito.
   Se não estiver usando Rails, Roda ou Sinatra	Para usar o monitoramento automático de aplicativos de browser em um aplicativo Rack que não usa Roda, Sinatra ou Rails, você deve incluir manualmente middlewares Rack adicionais fornecidos pelo agente. Coloque a gema New Relic o mais baixo possível na lista, permitindo que a estrutura acima dela seja instrumentada quando a gema for inicializada.

Instale o arquivo de configuração

Depois de instalar o agente, você precisará instalar o arquivo de configuração newrelic.yml e nomear seu aplicativo:

1. Baixe uma cópia de newrelic.yml do nosso repositório GitHub.
2. Copie o arquivo newrelic.yml no subdiretório config do seu aplicativo.
3. Edite o valor license_key para incluir seu chave de licença.
4. Edite o valor app_name para um nome significativo.

Alternativamente, você pode gerar um arquivo newrelic.yml manualmente com o seguinte comando:

$
newrelic install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"

Você também pode usar a opção --force com este comando se precisar substituir um newrelic.yml existente.

Visualize o log do seu APM e dados de infraestrutura

Você também pode reunir os dados do seu log e da aplicação para tornar a resolução de problemas mais fácil e rápida. Com os logs contextualizados, você pode ver a mensagem do log relacionada aos seus erros e rastrear diretamente na interface do seu aplicativo. Você também pode ver o logs contextualizados dos dados da sua infraestrutura, como cluster do Kubernetes. Não há necessidade de mudar para outra página de interface.

Atualizar o agente

Consulte Atualizar versões do agente Ruby.

Instalar agente fora do ambiente de produção

Normalmente você instalará o agente Ruby em seu ambiente de produção. Se você quiser testar o agente Ruby em um ambiente de desenvolvimento ou localhost, verifique no bloco environment: relevante do arquivo newrelic.yml se o valor de configuração monitor_mode foi definido como true.

Por exemplo, para implantar o New Relic em seu ambiente de desenvolvimento e ainda poder visualizar a métrica de desempenho do seu aplicativo: No bloco development: , defina o valor de configuração monitor_mode como true.

Desinstale a gem do agente Ruby

Para desinstalar o agente Ruby usando Bundler, remova gem 'newrelic_rpm' do seu Gemfile. Se você não estiver usando o Bundler, remova todas as referências a newrelic_rpm do arquivo environment.rb .