Skip to main content
Um OpenTelemetry-Daten von Ihrer Python-Anwendung an AppSignal zu senden, können Sie entweder das AppSignal for Python-Paket verwenden oder OpenTelemetry manuell installieren und konfigurieren.

Verwendung des AppSignal for Python-Pakets

Das AppSignal for Python-Paket kann OpenTelemetry automatisch so konfigurieren, dass es Daten an den AppSignal Collector sendet. Es kann auch automatisch OpenTelemetry-Instrumentierungen für gängige Bibliotheken und Frameworks aktivieren. Befolgen Sie die Anweisungen in der Installationsdokumentation für AppSignal for Python, um das Paket zu installieren und die Konfigurationsdatei einzurichten, und befolgen Sie dann die Anweisungen auf der Seite zur Collector-Konfiguration von AppSignal for Python, um es mit dem AppSignal Collector zu verwenden.

OpenTelemetry manuell installieren

Stellen Sie sicher, dass Sie den AppSignal Collector installieren, bevor Sie mit diesen Anweisungen fortfahren.

Die OpenTelemetry-Pakete installieren

Fügen Sie das OpenTelemetry-SDK, den OTLP-Exporter und die Instrumentierungspakete zur requirements.txt Ihrer Anwendung hinzu:
Fügen Sie auch die OpenTelemetry-Instrumentierungspakete für die Bibliotheken und Frameworks hinzu, die Ihre Anwendung verwendet. Zum Beispiel, wenn Sie Django und Celery verwenden:
Sehen Sie sich das OpenTelemetry-Registry nach Instrumentierungspaketen für die meisten Bibliotheken und Frameworks an.

OpenTelemetry in Ihrer Anwendung konfigurieren

Fügen Sie diese Datei appsignal.py mit der OpenTelemetry-Exporter- und AppSignal-Konfiguration zu Ihrer Anwendung hinzu. Importieren Sie diese Datei dann, bevor Ihre Anwendung gestartet wird. Stellen Sie sicher, dass Sie die folgenden Werte mit Ihrem AppSignal-Anwendungsnamen, der Umgebung und dem Push API-Schlüssel aktualisieren und den Exporter-Endpunkt durch die Adresse Ihres AppSignal Collectors ersetzen, falls erforderlich.
Initialisieren Sie dann in derselben Datei nach der OpenTelemetry-Einrichtung die OpenTelemetry-Instrumentierungen für die Bibliotheken und Frameworks, die Ihre Anwendung verwendet. Zum Beispiel, wenn Sie die Django- und Celery-Instrumentierungen verwenden:
Rufen Sie schließlich die Funktion initialize_opentelemetry mit dem Namen des zu überwachenden Dienstes so früh wie möglich am Einstiegspunkt Ihrer Anwendung auf. Eine häufige Wahl für den Service-Namen ist der Name des verwendeten Frameworks.

Verwendung mit Django

Importieren Sie in der Datei settings.py Ihrer Django-Anwendung das Modul appsignal.py am Anfang der Datei und rufen Sie die Funktion initialize_opentelemetry auf:

Verwendung mit Celery

Fügen Sie in der Datei tasks.py Ihrer Celery-Anwendung einen Verbindungs-Callback für Worker-Prozesse hinzu und importieren Sie darin das Modul appsignal.py.

Die App testen!

Nachdem nun alle Komponenten verbunden sind, starten Sie Ihre App und testen Sie, ob Daten in AppSignal eintreffen. Überprüfen Sie insbesondere die Seiten „Errors > Issue list” und „Performance > Traces”. Wenn Sie nach dem Befolgen unserer Installationsanweisungen immer noch keine Daten in AppSignal sehen, lassen Sie es uns wissen, und wir helfen Ihnen, Ihre OpenTelemetry-Installation abzuschließen!