Estas instruções são para instalar o agente Ruby como um plug-in Rails. Para a maioria dos casos de uso, você deve instalar o agente gem.
Instale o plug-in New Relic Rails
Importante
Recomendamos fortemente instalar o agente Ruby como uma gem para ter melhor controle sobre versões e dependências.
Para instalar o plug-in Rails do Github, use os seguintes comandos para Rails versões 2 ou superior:
script/plugin install git://github.com/newrelic/newrelic-ruby-agent.gitmv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agent
Isso exportará o plug-in Rails para o diretório vendor/plugins
do seu aplicativo. Se você não puder instalar o plug-in Rails diretamente da URL do git, você pode clonar o repositório no diretório vendor/plug-in.
Este documento ajudou você na instalação?
Atualizar o arquivo de configuração
Após instalar o agente, copie o arquivo newrelic.yml
no subdiretório config
do seu aplicativo. Você pode baixar um novo newrelic.yml
que inclui seu do Account settings ao fazer login no New Relic.
Importante
Como parte do processo de instalação, altere o nome padrão do aplicativo para um nome significativo.
Atualize o arquivo newrelic.yml
Sempre que você atualizar o agente, confirme se o arquivo de configuração do agente Ruby (config/newrelic.yml
) está atualizado:
- Abra o arquivo
newrelic.yml
padrão que reside na pasta de plug-in do agente Ruby (vendor/plugins/newrelic-ruby-agent/newrelic.yml
). - Procure novas opções de configuração que não estejam no arquivo
config/newrelic.yml
.
Dica
Você pode fazer referência a segredos armazenados nas credenciais do Rails em seu arquivo newrelic.yml
usando interpolação YAML:
# When you have a key that exists in config/credentials.yml.enc like 'newrelic_license_key'... license_key: <%= Rails.application.credentials.newrelic_license_key %>
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 Ruby
Ao usar o Subversion com o plug-in Rails, certifique-se de remover o plug-in do agente antigo antes de reinstalar.
Dica
Use a gema, se possível.
svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins -m "removing old version of newrelic"
Em seguida, para instalar o plug-in do agente Ruby mais recente:
script/rails plugin install git://github.com/newrelic/newrelic-ruby-agent.git vendor/plugins/newrelic-ruby-agentmv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agentsvn add vendor/plugins/newrelic-ruby-agentsvn commit vendor/plugins -m "upgrading newrelic to version X.X.X"
Desinstale o plug-in Rails
Para desinstalar o plug-in Rails:
svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins