Passer au contenu principal
AppSignal pour Node.js peut être configuré de plusieurs manières différentes : via le constructeur Appsignal ou les variables d’environnement. La configuration est chargée en un processus en quatre étapes, commençant par les valeurs par défaut du package et se terminant par la lecture des variables d’environnement. Les options de configuration peuvent être mélangées sans perdre la configuration d’une autre option.

Ordres de chargement

1. Valeurs par défaut du module

Le module AppSignal commence par charger sa configuration par défaut, définir les chemins et activer certaines fonctionnalités. Les valeurs par défaut de l’agent se trouvent dans la documentation des options de configuration.

2. Paramètres détectés par le système

Le package détecte sur quel type de système il s’exécute et se configure en conséquence. Par exemple, lorsqu’il s’exécute dans un système basé sur des conteneurs (tel que Docker et Heroku), il définit l’option de configuration runningInContainer sur true.

3. Variables d’environnement

AppSignal recherchera sa configuration dans les variables d’environnement. Lorsqu’elles sont trouvées, celles-ci remplaceront toutes les options de configuration des étapes précédentes.
export APPSIGNAL_APP_NAME="my custom app name"
# start your app here

4. Configuration initiale fournie au constructeur Appsignal

Lors de l’initialisation de l’objet Appsignal, vous pouvez passer la configuration initiale que vous souhaitez appliquer. Il s’agit d’un object contenant l’une des options décrites ci-dessous.
new Appsignal({
  active: true,
  name: "<YOUR APPLICATION NAME>",
  pushApiKey: "<YOUR API KEY>",
});
Cette étape remplacera toutes les options fournies par les valeurs par défaut ou la configuration détectée par le système.