O agente Ruby instrumenta automaticamente seu código para que você possa iniciar o monitoramento de aplicativos.
Dica
Em execução no Kubernetes? Consulte a anexação automática do Kubernetes APM.
Pré-requisitos
Verifique estes requisitos antes de começar.
Requerimento | Detalhes |
|---|---|
Conta New Relic | Você precisa de uma conta New Relic e do seu . Tenha em mãos antes de começar. |
Versão do Ruby | Consulte os requisitos do agente Ruby e frameworks suportados para ver as versões suportadas do Ruby. |
Sistema operacional | Sistemas operacionais do tipo UNIX: Linux, Solaris, FreeBSD e macOS. Consulte os requisitos do agente Ruby e frameworks suportados para obter detalhes. |
Instale a joia
Adicione a gem do agente Ruby ao seu Gemfile:
gem 'newrelic_rpm'Em seguida, execute:
$bundle installImportante
Se você estiver usando o agente em um contêiner Docker, instale o agente dentro de cada contêiner. Consulte Instalar no ambiente flexível do GAE para ver um exemplo de implantação baseada em Docker.
Notas específicas do framework:
- Rails: o Rails chama automaticamente
Bundler.require, portanto,newrelic_rpmé necessário durante a inicialização sem etapas adicionais. - Roda ou Sinatra: você deve chamar manualmente
require 'newrelic_rpm'em seu aplicativo. - Outros aplicativos Rack: para usar o monitoramento de Browser automático, inclua manualmente os middlewares Rack fornecidos pelo agente.
Configurar o agente
Faça o download de newrelic.yml do repositório da New Relic no GitHub e copie-o para o diretório config do seu aplicativo.
As únicas duas configurações que você deve alterar antes de entrar em produção:
- Defina
license_keycomo seu . - Defina
app_namecomo um nome significativo para seu aplicativo.
Como alternativa, gere o arquivo de configuração com a CLI:
$newrelic install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"Verifique se os dados estão fluindo
Reinicie seu servidor web.
Envie pelo menos dois requests para o seu aplicativo.
Aguarde 2–3 minutos, depois abra one.newrelic.com > APM e procure seu aplicativo pelo nome.
Dica
O aplicativo não aparece? Consulte Nenhum dado aparece (Ruby).
Artigos relacionados
- Requisitos do agente Ruby e frameworks suportados — Versões do Ruby, sistemas operacionais e frameworks suportados.
- Configuração do agente Ruby — Todas as opções de configuração disponíveis.
- Atualizar o agente Ruby — Como atualizar para uma versão mais recente.
- Agente Ruby no Heroku — Etapas de instalação específicas para o Heroku.