Installer l'agent Ruby New Relic

Notre agent Ruby instrumente automatiquement votre code afin que vous puissiez commencer monitoring les applications. Vous pouvez utiliser notre lanceur ou suivre les instructions de ce document pour terminer une installation de base de l'agent Ruby.

Installer la gem

1. La gem de l'agent Ruby est disponible sur rubygems.org sous le nom newrelic_rpm. Pour les applications utilisant Bundler, ajoutez ce gem au Gemfile :

   gem 'newrelic_rpm'

   Copier

2. Pour utiliser Infinite Tracing, la gem Infinite Tracing est également disponible sur rubygems.org sous le nom newrelic-infinite_tracing. Pour les applications utilisant Bundler, incluez également le gem Infinite Tracing dans le Gemfile :

   gem 'newrelic-infinite_tracing'

   Copier

3. L'étape suivante varie selon que vous utilisez Rails, Roda ou Sinatra :

   Ruby installation	Comments
   Si vous utilisez Rails, Roda ou Sinatra	Rails:Rails appellera automatiquement Bundler.require et fera en sorte que newrelic_rpm soit requis lors du démarrage de votre application. Roda, Sinatra:Si vous utilisez Roda, Sinatra ou un autre framework, vous devez appeler manuellement require 'newrelic_rpm'. De plus, si vous utilisez Infinite Tracing, appelez manuellement require 'newrelic/infinite_tracing'. Vous pouvez également appeler manuellement Bundler.require, ce qui active également le Infinite Tracing.
   Si vous n'utilisez pas Rails, Roda ou Sinatra	Pour utiliser monitoring automatique du navigateur d'applications dans une application Rack qui n'utilise pas Roda, Sinatra ou Rails, vous devez inclure manuellement des middlewaresRack supplémentaires fournis par l'agent. Placez la gem New Relic aussi bas que possible dans la liste, permettant aux frameworks situés au-dessus d'elle d'être instrumentés lorsque la gem s'initialise.

Installer le fichier de configuration

Après avoir installé l'agent, vous devrez installer le fichier de configuration newrelic.yml et nommer votre application :

1. Téléchargez une copie de newrelic.yml depuis notre référentiel GitHub.
2. Copiez le fichier newrelic.yml dans le sous-répertoire config de votre application.
3. Modifiez la valeur license_key pour inclure votre clé de licence.
4. Modifiez la valeur app_name avec un nom significatif.

Alternativement, vous pouvez générer un fichier newrelic.yml manuellement avec la commande suivante :

$
newrelic install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"

Vous pouvez également utiliser l'option --force avec cette commande si vous devez écraser un newrelic.yml existant.

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

Voir Mettre à niveau les versions de l'agent Ruby.

Agent d'installation hors environnement de production

En règle générale, vous installerez l’agent Ruby dans votre environnement de production. Si vous souhaitez tester l'agent Ruby dans un environnement de développement ou localhost, vérifiez dans le bloc environment: correspondant du fichier newrelic.yml que la valeur de configuration monitor_mode a été définie sur true.

Par exemple, pour déployer New Relic dans votre environnement de développement et pouvoir toujours afficher les mesures de performances de votre application : dans le bloc development: , définissez la valeur de configuration monitor_mode sur true.

Désinstaller la gem de l'agent Ruby

Pour désinstaller l'agent Ruby à l'aide de Bundler, supprimez gem 'newrelic_rpm' de votre Gemfile. Si vous n'utilisez pas Bundler, supprimez toutes les références à newrelic_rpm de votre fichier environment.rb .