Passer au contenu principal
Cette documentation décrit comment la configuration AppSignal est chargée dans votre application Python. Il existe deux méthodes différentes pour configurer votre intégration AppSignal, qui peuvent être utilisées simultanément :
  • Fichier de configuration (__appsignal__.py)
  • Variables d’environnement
Une liste des options disponibles se trouve dans la documentation des options de configuration.

Ordre de chargement

La configuration est chargée selon un processus en quatre étapes :
  1. Valeurs par défaut du package - default
  2. Paramètres détectés par le système - system
  3. Variables d’environnement - env
  4. Configuration initiale - initial

1. Valeurs par défaut du package

D’abord, la configuration par défaut est chargée, ce qui définit les chemins et active certaines fonctionnalités. Cette source sera listée sous default dans la configuration de votre application et est visible dans le rapport Diagnose.

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, s’il s’exécute à l’intérieur d’un système basé sur des conteneurs tels que Docker ou Heroku, l’option de configuration running_in_container est définie sur true. Cette source sera listée sous system dans la configuration de votre application et est visible dans le rapport Diagnose.

3. Variables d’environnement

AppSignal recherchera les options de configuration définies via les variables d’environnement. La valeur de la variable d’environnement remplacera les valeurs des mêmes options de configuration définies dans les étapes précédentes.
export APPSIGNAL_APP_NAME="my custom app name"
# start your app here
Cette source sera listée sous env dans la configuration de votre application et est visible dans le rapport Diagnose.

4. Configuration initiale fournie à Appsignal

Enfin, la configuration initiale est chargée via la fonction Appsignal appelée depuis le fichier de configuration __appsignal__.py :
# __appsignal__.py
appsignal = Appsignal(
    active=True,
    name="My app name",
    push_api_key="00000000-0000-0000-0000-000000000000"
)
Les valeurs des options de configuration définies à cette étape remplaceront les valeurs des mêmes options de configuration définies dans les étapes précédentes. Cette source sera listée sous initial dans la configuration de votre application et est visible dans le rapport Diagnose.