Instalação do agente Ruby: plug-in Rails

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

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.git
mv 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.

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 chave de licençado Account settings ao fazer login no New Relic.

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 .

# 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.

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-agent
mv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agent
svn add vendor/plugins/newrelic-ruby-agent
svn 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