> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration d'AppSignal pour Python

Cette documentation explique comment configurer AppSignal. Pour plus d'informations sur l'installation d'AppSignal, suivez les étapes de notre [documentation d'installation](/python/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` :

<CodeGroup>
  ```python Python theme={null}
  # __appsignal__.py
  appsignal = Appsignal(
      # ...
      environment="production"
  )
  ```
</CodeGroup>

Vous pouvez également utiliser la variable d'environnement `APPSIGNAL_APP_ENV`.

### Signaler les déploiements

Vous pouvez utiliser les [marqueurs de déploiement](/application/markers/deploy-markers) pour signaler les nouveaux déploiements de votre application Python. Vous pouvez combiner les marqueurs de déploiement avec les [liens de backtrace](/application/backtrace-links) 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` :

<CodeGroup>
  ```python Python theme={null}
  # __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
  )
  ```
</CodeGroup>

## 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`.

<Tip>
  AppSignal prend également en charge directement les frameworks web populaires, tels que
  [Django](/python/instrumentations/django),
  [Flask](/python/instrumentations/flask),
  [FastAPI](/python/instrumentations/fastapi) ou
  [Starlette](/python/instrumentations/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.
</Tip>

<CodeGroup>
  ```python Python theme={null}
  # Your app file

  # Add this import statement
  import appsignal

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


  if __name__ == '__main__':
      main()
  ```
</CodeGroup>

## 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][instrumentations].

[Python language]: https://www.python.org/

[OpenTelemetry]: https://opentelemetry.io/

[instrumentations]: /python/instrumentations

[django]: /python/instrumentations/django.html