Installer l'agent Node.js pour Docker

Vous pouvez utiliser notre Node.js agent pour instrumenter Node.js l'application déployée dans le Docker conteneur . Ce document explique comment créer, configurer et déployer votre Dockerisée Node.js application que vous avez instrumentée avec New Relic.

Si vous avez besoin d'une aide générale concernant l'installation de l'agent Node.js, consultez nos instructions d'installation principales.

Instrumenter votre conteneur

En apportant quelques configuration modifications et en ajoutant des New Relic variables d'environnement à votre Dockerfile existant, vous pouvez instrumenter votre application Dockerisée avec notre Node.js agent

1. Ajoutez newrelic à votre package.json:

   "newrelic": "latest",

   Copier

   Vous pouvez mettre à jour la valeur latest pour installer une version spécifique ou utiliser l'une des autres options fournies par le formatpackage.json . Consultez les Node.js agent notes de sortie pour obtenir des informations sur les agent versions précédentes .

2. Injectez l' agent dans votre commande de démarrage node pour instrumenter votre application. La configuration de votre conteneur peut vous permettre de modifier le ENTRYPOINT pour inclure d'abord le module newrelic avec l'indicateur Node.js -r/--require lorsque la commande node est invoquée. Si votre Dockerfile contient l'une de ces commandes de démarrage, vous pouvez les modifier de cette manière :

   • Remplacez node YOUR_PROGRAM.js par node -r newrelic YOUR_PROGRAM.js
   • Remplacez ENTRYPOINT ['node', 'YOUR_PROGRAM.js'] par ENTRYPOINT ['node', '-r', 'newrelic', 'YOUR_PROGRAM.js']
   • Remplacez CMD ['node', 'YOUR_PROGRAM.js'] par CMD ['node', '-r', 'newrelic', 'YOUR_PROGRAM.js']
   • Si vous disposez d'un script npm pour exécuter votre programme tel que npm start, vous pouvez modifier ce script par programmation en exécutant npm pkg set scripts.start="node -r newrelic your-program.js".
   • Si vous ne pouvez pas contrôler la manière dont votre programme s'exécute, vous pouvez charger le module newrelic avant tout autre module de votre programme en ajoutant require('newrelic') en haut de votre fichier d'entrée.

3. Créez votre image Docker comme vous le faites normalement.

4. Pour exécuter votre application Docker avec l'agent activé, ajoutez votre clé de licenceet le nom de votre application à votre commande docker run en tant que variables d'environnement :

   bash

   Copier

   $
   docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
   >
           -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
   >
           YOUR_IMAGE_NAME:latest

Autres options de configuration

En plus de définir le nom de votre application ou votre clé de licence, vous pouvez définir d'autres options de configuration en démarrant votre conteneur avec l'option -e . Vous pouvez également :

• Activez un indicateur de fonctionnalité à l'aide de sa variable d'environnement (NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED), comme dans le snippet ci-dessous, en remplaçant NAME_OF_FEATURE_FLAG par le nom en majuscule de l'indicateur de fonctionnalité :

  bash

  Copier

  $
  docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
  >
          -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
  >
          -e NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED=true \
  >
          YOUR_IMAGE_NAME:latest

• Définissez les options de configuration dans votre Dockerfile à l'aide des directives ENV :

  ENV NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED=true \
      NEW_RELIC_LOG=stdout
      # etc.

  Copier