Passer au contenu principal
Dans cette section, nous expliquerons comment configurer AppSignal, ce qui peut être configuré dans le package Node.js, et quelle est la configuration minimale requise.

​
Configuration minimale requise

La configuration minimale requise par AppSignal pour Node.js comprend les éléments suivants. S’ils ne sont pas présents, AppSignal n’enverra aucune donnée à AppSignal.com.
  • Une clé d’API Push valide
  • Un nom d’application
  • Un environnement d’application (development/production/test en définissant NODE_ENV)
  • Le paramètre active: true
L’intégration prend en charge le chargement de sa configuration via les options passées au constructeur Appsignal. Nous recommandons de créer un fichier appsignal.cjs pour requérir et initialiser AppSignal. 
// appsignal.cjs
const { Appsignal } = require("@appsignal/nodejs");

new Appsignal({
  active: true,
  name: "<YOUR APPLICATION NAME>",
  pushApiKey: "<YOUR API KEY>",
});
Alternativement, vous pouvez configurer l’agent à l’aide de variables d’environnement système. AppSignal deviendra automatiquement actif si la variable d’environnement APPSIGNAL_PUSH_API_KEY est définie. 
export APPSIGNAL_PUSH_API_KEY="<YOUR API KEY>"
export APPSIGNAL_APP_NAME="<YOUR APPLICATION NAME>"
export APPSIGNAL_APP_ENV="production"

​
Options de configuration

Pour en savoir plus sur toutes les options de configuration, consultez la page des options.

​
Environnements d’application

Une application peut avoir plusieurs environnements tels que « development », « test », « staging » et « production ». Pour séparer les erreurs et les problèmes de performance qui surviennent dans l’environnement « development » de ceux qui surviennent en « production », il est possible de définir l’environnement dans lequel l’application s’exécute avec la variable d’environnement NODE_ENV. Si vous activez AppSignal par environnement, vous pouvez définir la propriété active des options que vous passez au constructeur de manière conditionnelle : 
// appsignal.cjs
const { Appsignal } = require("@appsignal/nodejs");

new Appsignal({
  active: process.env.NODE_ENV !== "development",
  name: "<YOUR APPLICATION NAME>",
  pushApiKey: "<YOUR API KEY>",
});
Cela désactivera également AppSignal lors de l’exécution de vos tests.