Skip to main content
Bitte folgen Sie zuerst dem Installationsleitfaden, wenn Sie eine neue Anwendung zu AppSignal hinzufügen. Stellen Sie anschließend sicher, dass Sie den AppSignal-Collector installiert haben, bevor Sie fortfahren.

OpenTelemetry in Ihrer Anwendung konfigurieren

OpenTelemetry muss vor dem Start Ihrer Anwendung initialisiert werden, damit alle Telemetriedaten über den Exporter an AppSignal gesendet werden. In einer Webanwendung muss OpenTelemetry beispielsweise initialisiert werden, bevor die Routen geladen werden und der Server startet. Erstellen Sie eine initOpenTelemetry()-Funktion wie im folgenden Beispiel und fügen Sie sie der Hauptdatei Ihrer Anwendung hinzu. Stellen Sie sicher, dass Sie die unten stehenden Werte mit Ihrem AppSignal-Anwendungsnamen, der Umgebung und dem Push API-Key aktualisieren und den Exporter-Endpoint bei Bedarf durch die Adresse Ihres AppSignal-Collectors ersetzen.
Wenn Ihr Collector über HTTPS erreichbar ist, entfernen Sie die drei Zeilen, die den Methodenaufruf WithInsecure() enthalten, aus der Beispielkonfiguration. Um die im obigen Beispiel importierten OpenTelemetry-Bibliotheken zu installieren, führen Sie diesen Befehl aus.

OpenTelemetry-Instrumentierungspakete konfigurieren

Der OpenTelemetry-Stack sendet von sich aus keine Daten. Um Ihre Anwendung zu instrumentieren, installieren und konfigurieren Sie die Instrumentierungspakete für die von Ihrer Anwendung verwendeten Bibliotheken und Frameworks. Sie können OpenTelemetry-Instrumentierungspakete in der OpenTelemetry-Registry finden. Für einige beliebte OpenTelemetry-Instrumentierungen finden Sie spezifische Konfigurationsanweisungen auf diesen Seiten:

Anwendung testen!

Nachdem nun alle Komponenten verbunden sind, starten Sie Ihre Anwendung und prüfen Sie, ob Daten in AppSignal eintreffen. Sehen Sie sich insbesondere die Seiten „Errors > Issue list” und „Performance > Traces” an. 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!

Instrumentierungspakete hinzufügen

Der nächste Schritt besteht darin, Go-Pakete wie Gin-gonic, Gorilla usw. zu instrumentieren. Dadurch erhalten Sie deutlich mehr Daten, um tief in die Performance Ihrer Anwendungen einzutauchen. Die Schritte für jedes Paket sind in der Regel die folgenden:
  • Installieren Sie das OpenTelemetry-Instrumentierungspaket für die Bibliothek, die Sie instrumentieren möchten.
  • Folgen Sie der Installationsanleitung für das Instrumentierungspaket.
Weitere Informationen zur Installation und Konfiguration der einzelnen Bibliotheken finden Sie im Abschnitt zu Go-Instrumentierungen.