Ces instructions concernent l'installation de l'agent Ruby en tant que plugin Rails. Pour la plupart des cas d’utilisation, vous devez plutôt installer l’agent gem.
Installer le plugin New Relic Rails
Important
Nous recommandons fortement d'installer l'agent Ruby en tant que gem pour avoir un meilleur contrôle sur les versions et les dépendances.
Pour installer le plugin Rails depuis Github, utilisez les commandes suivantes pour les versions Rails 2 ou supérieures :
$script/plugin install git://github.com/newrelic/newrelic-ruby-agent.git$mv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agentCela exportera le plugin Rails dans le répertoire vendor/plugins de votre application. Si vous ne pouvez pas installer le plugin Rails directement depuis l'URL git, vous pouvez cloner le référentiel dans le répertoire vendor/plugins.
Ce document vous a-t-il aidé lors de votre installation ?
Mettre à jour le fichier de configuration
Après avoir installé l'agent, copiez le fichier newrelic.yml dans le sous-répertoire config de votre application. Vous pouvez télécharger un nouveau newrelic.yml qui inclut votre à partir du Account settings lorsque vous vous connectez à New Relic.
Important
Dans le cadre du processus d’installation, remplacez le nom par défaut de l’application par un nom significatif.
Mettre à jour le fichier newrelic.yml
Chaque fois que vous mettez à jour l'agent, confirmez que votre fichier de configuration d'agent Ruby (config/newrelic.yml) est mis à jour :
- Ouvrez le fichier
newrelic.ymlpar défaut qui se trouve dans le dossier du plug-in de l'agent Ruby (vendor/plugins/newrelic-ruby-agent/newrelic.yml). - Recherchez de nouvelles options de configuration qui ne figurent pas dans votre fichier
config/newrelic.yml.
Conseil
Vous pouvez référencer les secrets stockés dans les informations d'identification Rails dans votre fichier newrelic.yml à l'aide de l'interpolation 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 %>Afficher les logs de vos données APM et infrastructure
Vous pouvez également rassembler vos données de log et d'application pour rendre le dépannage plus facile et plus rapide. Avec les logs en contexte, vous pouvez voir les messages de log liés à vos erreurs et les tracer directement dans UI de votre application. Vous pouvez également voir les logs en contexte de vos données infrastructure , telles que le cluster Kubernetes. Pas besoin de passer à une autre page UI .
Mettre à jour l'agent Ruby
Lorsque vous utilisez Subversion avec le plugin Rails, assurez-vous de supprimer l'ancien plugin d'agent avant de le réinstaller.
Conseil
Utilisez la gem si possible.
$svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins -m "removing old version of newrelic"Ensuite, pour installer le dernier plugin de l'agent Ruby :
$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"Désinstaller le plugin Rails
Pour désinstaller le plugin Rails :
$svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins