Passer au contenu principal
Cette documentation explique comment configurer AppSignal. Pour plus d’informations sur l’installation d’AppSignal, suivez les étapes de notre documentation d’installation.

​
Environnement d’application

Par défaut, l’intégration AppSignal pour Python signale l’application actuelle dans l’environnement « development ». Vous pouvez utiliser l’option de configuration environment pour définir un environnement différent. Par exemple, dans votre fichier __appsignal__.py : 
# __appsignal__.py
appsignal = Appsignal(
    # ...
    environment="production"
)
Vous pouvez également utiliser la variable d’environnement APPSIGNAL_APP_ENV.

​
Signaler les déploiements

Vous pouvez utiliser les marqueurs de déploiement pour signaler les nouveaux déploiements de votre application Python. Vous pouvez combiner les marqueurs de déploiement avec les liens de backtrace pour créer directement un lien depuis AppSignal vers le code source sur des plateformes telles que GitHub et GitLab. Les marqueurs de déploiement peuvent être configurés à l’aide de l’option de configuration revision ou de la variable d’environnement APP_REVISION. Nous recommandons d’utiliser des SHA de commit Git ou un tag dans votre SCM. Par exemple, pour les applications Git, ajoutez le code suivant au fichier __appsignal__.py : 
# __appsignal__.py
import subprocess

revision = None

try:
    revision = subprocess.check_output(
        "git rev-parse --short HEAD", shell=True, text=True
    ).strip()
except subprocess.CalledProcessError:
  pass

appsignal = Appsignal(
    # ...
    revision=revision
)

​
Importer le fichier de configuration

L’intégration AppSignal pour Python doit être chargée et démarrée dans votre application. Pour charger et démarrer l’intégration, importez le module appsignal et appelez la méthode appsignal.start() au démarrage de l’application ou dans la méthode main.
AppSignal prend également en charge directement les frameworks web populaires, tels que Django, Flask, FastAPI ou Starlette. Si vous utilisez un framework web que nous prenons directement en charge, suivez les instructions pour ce framework au lieu des instructions génériques de cette page.
# Your app file

# Add this import statement
import appsignal

def main():
    # Add this method call
    appsignal.start()


if __name__ == '__main__':
    main()

​
Ajouter des packages d’instrumentation

L’étape suivante consiste à instrumenter les bibliothèques Python telles que Django, Celery, etc. L’instrumentation des bibliothèques fournira un ensemble plus large de données de surveillance, vous permettant de mieux comprendre les performances de votre application. Vous pouvez en savoir plus sur l’installation et la configuration des instrumentations dans notre documentation sur les instrumentations Python.