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

Die OpenTelemetry-Pakete installieren

Verwenden Sie npm, um das OpenTelemetry-SDK und den OTLP-Exporter zu den Abhängigkeiten Ihrer Anwendung hinzuzufügen:
Das Paket @opentelemetry/auto-instrumentations-node instrumentiert die meisten Anwendungen und Bibliotheken automatisch. In der README des Pakets finden Sie eine Liste der Bibliotheken und Frameworks, die es instrumentiert. Sie können zusätzliche Instrumentierungen für Bibliotheken und Frameworks im OpenTelemetry Registry finden.

OpenTelemetry in Ihrer Anwendung konfigurieren

Fügen Sie diese Datei opentelemetry.cjs mit der OpenTelemetry-Exporter- und AppSignal-Konfiguration zu Ihrer Anwendung hinzu. 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.

Ihre Anwendung mit OpenTelemetry starten

Um Ihre Anwendung mit OpenTelemetry auszuführen, müssen Sie die Option --require verwenden, um die Datei opentelemetry.cjs vor dem Start Ihrer Anwendung zu laden:
Aktualisieren Sie Ihre package.json-Datei, um --require zu dem Befehl hinzuzufügen, der Ihre App startet.
Sie können die Option --require auch mit Tools wie ts-node und nodemon verwenden. Wenn Sie eine Wrapper-CLI wie nest start oder fastify start zum Starten Ihrer Anwendung verwenden, verwenden Sie die Umgebungsvariable NODE_OPTIONS, um die Option an die Node.js-Laufzeit zu übergeben:

Die App testen!

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