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.
Dica
Seu aplicativo está rodando em um cluster do Kubernetes? Experimente nosso método de instalação usando o operador agenteKubernetes .
Instale a joia
Importante
Se você estiver usando o agente em um contêiner Docker , instale o contêiner do agente within each.
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'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'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 quenewrelic_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 manualmenterequire '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:
Baixe uma cópia de
newrelic.yml
do nosso repositório GitHub.Copie o arquivo
newrelic.yml
no subdiretórioconfig
do seu aplicativo.Edite o valor
license_key
para incluir seu.
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.
Este documento ajudou você na instalação?
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
.