AppSignal für Python Ladereihenfolge - AppSignal Documentation

Diese Dokumentation beschreibt, wie die AppSignal-Konfiguration in Ihrer Python-Anwendung geladen wird. Es gibt zwei verschiedene Methoden zur Konfiguration Ihrer AppSignal-Integration, die gleichzeitig verwendet werden können:

Konfigurationsdatei (__appsignal__.py)
Umgebungsvariablen

Eine Liste der verfügbaren Optionen finden Sie in der Dokumentation zu den Konfigurationsoptionen.

Ladereihenfolge

Die Konfiguration wird in einem vierstufigen Prozess geladen:

Paket-Standardwerte – default
Vom System erkannte Einstellungen – system
Umgebungsvariablen – env
Initiale Konfiguration – initial

1. Paket-Standardwerte

Zuerst wird die Standardkonfiguration geladen, die Pfade festlegt und bestimmte Features aktiviert. Diese Quelle wird unter default in der Konfiguration Ihrer Anwendung aufgeführt und ist im Diagnosebericht sichtbar.

2. Vom System erkannte Einstellungen

Das Paket erkennt, auf welcher Art von System es läuft, und konfiguriert sich entsprechend. Wenn es beispielsweise in einem container-basierten System wie Docker oder Heroku ausgeführt wird, wird die Konfigurationsoption running_in_container auf true gesetzt. Diese Quelle wird unter system in der Konfiguration Ihrer Anwendung aufgeführt und ist im Diagnosebericht sichtbar.

3. Umgebungsvariablen

AppSignal sucht nach Konfigurationsoptionen, die über Umgebungsvariablen gesetzt sind. Der Wert der Umgebungsvariablen überschreibt Werte für dieselben Konfigurationsoptionen, die in den vorherigen Schritten definiert wurden.

export APPSIGNAL_APP_NAME="my custom app name"
# start your app here

Diese Quelle wird unter env in der Konfiguration Ihrer Anwendung aufgeführt und ist im Diagnosebericht sichtbar.

4. Initiale Konfiguration, die an `Appsignal` übergeben wird

Schließlich wird die initiale Konfiguration über die Funktion Appsignal geladen, die aus der Konfigurationsdatei __appsignal__.py aufgerufen wird:

# __appsignal__.py
appsignal = Appsignal(
    active=True,
    name="My app name",
    push_api_key="00000000-0000-0000-0000-000000000000"
)

Die Werte der in diesem Schritt definierten Konfigurationsoptionen überschreiben Werte für dieselben Konfigurationsoptionen, die in den vorherigen Schritten definiert wurden. Diese Quelle wird unter initial in der Konfiguration Ihrer Anwendung aufgeführt und ist im Diagnosebericht sichtbar.