Zum Hauptinhalt springen
Diese Dokumentation erklärt, wie Sie AppSignal konfigurieren. Weitere Informationen zur Installation von AppSignal finden Sie in unserer Installationsdokumentation.

Anwendungsumgebung

Standardmäßig meldet die AppSignal-Integration für Python die aktuelle Anwendung in der Umgebung „development”. Sie können die Konfigurationsoption environment verwenden, um eine andere Umgebung festzulegen. Zum Beispiel in Ihrer __appsignal__.py-Datei:
# __appsignal__.py
appsignal = Appsignal(
    # ...
    environment="production"
)
Sie können auch die Umgebungsvariable APPSIGNAL_APP_ENV verwenden.

Deploys melden

Sie können Deploy-Marker verwenden, um neue Deploys Ihrer Python-Anwendung zu melden. Sie können Deploy-Marker mit Backtrace-Links kombinieren, um direkt von AppSignal zum Quellcode auf Plattformen wie GitHub und GitLab zu verlinken. Deploy-Marker können über die Konfigurationsoption revision oder die Umgebungsvariable APP_REVISION konfiguriert werden. Wir empfehlen die Verwendung von Git-Commit-SHAs oder eines Tags in Ihrem SCM. Für Git-Anwendungen fügen Sie beispielsweise den folgenden Code in die Datei __appsignal__.py ein:
# __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
)

Importieren der Konfigurationsdatei

Die AppSignal-Integration für Python muss in Ihrer Anwendung geladen und gestartet werden. Um die Integration zu laden und zu starten, importieren Sie das Modul appsignal und rufen Sie die Methode appsignal.start() beim Start der App oder in der Methode main auf.
AppSignal unterstützt auch beliebte Web-Frameworks direkt, wie z. B. Django, Flask, FastAPI oder Starlette. Wenn Sie ein Web-Framework verwenden, das wir direkt unterstützen, folgen Sie den Anweisungen für dieses Framework anstelle der allgemeinen Anweisungen auf dieser Seite.
# Your app file

# Add this import statement
import appsignal

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


if __name__ == '__main__':
    main()

Instrumentierungspakete hinzufügen

Der nächste Schritt besteht darin, Python-Bibliotheken wie Django, Celery usw. zu instrumentieren. Die Instrumentierung von Bibliotheken liefert einen breiteren Satz an Monitoring-Daten und hilft Ihnen, die Performance Ihrer Anwendung besser zu verstehen. Weitere Informationen zur Installation und Konfiguration von Instrumentierungen finden Sie in unserer Dokumentation zu Python-Instrumentierungen.