Skip to main content
Zorg ervoor dat u de AppSignal collector installeert voordat u verdergaat met deze instructies.

Installeer de OpenTelemetry-pakketten

Gebruik npm om de OpenTelemetry SDK en de OTLP-exporter toe te voegen aan de dependencies van uw applicatie:
Het pakket @opentelemetry/auto-instrumentations-node instrumenteert de meeste applicaties en libraries automatisch. Bekijk de README van het pakket voor een lijst met libraries en frameworks die het instrumenteert. U kunt aanvullende instrumentaties voor libraries en frameworks vinden in het OpenTelemetry-register.

Configureer OpenTelemetry in uw applicatie

Voeg dit bestand opentelemetry.cjs toe aan uw applicatie met de OpenTelemetry-exporter en AppSignal-configuratie. Zorg ervoor dat u de onderstaande waarden bijwerkt met de naam, omgeving en push API-sleutel van uw AppSignal-applicatie, en vervang het exporter-endpoint zo nodig door het adres van uw AppSignal collector.

Start uw applicatie met OpenTelemetry

Om uw applicatie met OpenTelemetry uit te voeren, dient u de vlag --require te gebruiken om het bestand opentelemetry.cjs te laden voordat uw applicatie wordt gestart:
Werk uw package.json-bestand bij om --require toe te voegen aan het commando dat uw app start.
U kunt de vlag --require ook gebruiken met tools zoals ts-node en nodemon. Wanneer u een wrapper-CLI gebruikt, zoals nest start of fastify start, om uw applicatie te starten, gebruik dan de omgevingsvariabele NODE_OPTIONS om de vlag door te geven aan de Node.js-runtime:

Test de app!

Nu alle componenten zijn verbonden, start u uw app met de vereiste command-line argumenten en test u of er gegevens binnenkomen in AppSignal. Controleer specifiek de pagina’s “Errors > Issue list” en “Performance > Traces”. Als u na het volgen van onze installatie-instructies nog steeds geen gegevens ziet in AppSignal, laat het ons weten en wij helpen u uw OpenTelemetry-installatie te voltooien!