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. Um OpenTelemetry für Ihre Java-Anwendung zu installieren und zu konfigurieren, empfehlen wir die Verwendung des OpenTelemetry-Java-Agenten, um Daten an den AppSignal-Collector zu exportieren. Dieser Agent instrumentiert Ihre Anwendung automatisch.

OpenTelemetry-Java-Agenten herunterladen

Laden Sie den OpenTelemetry-Java-Agenten aus dem neuesten Release auf GitHub herunter. Beim Ausführen Ihrer Anwendung muss der OpenTelemetry-Java-Agent vorhanden sein.

Anwendung mit dem Agenten ausführen

Beim Ausführen Ihrer Anwendung müssen Sie die Java-Laufzeitumgebung so konfigurieren, dass sie den OpenTelemetry-Java-Agenten lädt. Ändern Sie die Art, wie Sie Ihre Anwendung starten, damit der OpenTelemetry-Java-Agent zusammen mit Ihrer Anwendung geladen wird:
Ersetzen Sie /path/to/opentelemetry-javaagent.jar durch den Pfad zum heruntergeladenen Agenten und your-application.jar durch den Pfad zur JAR-Datei Ihrer Anwendung.

Gradle

Wenn Sie Gradle verwenden, können Sie den Agenten in der Datei build.gradle zu der Task hinzufügen, die Ihre Anwendung startet:

Agenten konfigurieren

Der Agent kann über Java-Properties oder Umgebungsvariablen konfiguriert werden. Wir empfehlen die Verwendung von Umgebungsvariablen zur Konfiguration. Konfigurieren Sie den Agenten zunächst so, dass er Traces und Logs an den AppSignal-Collector exportiert:
Konfigurieren Sie anschließend die von AppSignal benötigten OpenTelemetry-Resource-Attribute:

Anwendung testen!

Nachdem nun alle Komponenten verbunden sind, starten Sie Ihre Anwendung mit den erforderlichen Umgebungsvariablen 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!