Naar hoofdinhoud gaan
OpenTelemetry biedt uitgebreide instrumentatie voor veel populaire libraries en frameworks. Tijdens de installatie van AppSignal en OpenTelemetry heeft u mogelijk al enkele instrumentatiepakketten geïnstalleerd, maar het kan zijn dat u aanvullende instrumentatiepakketten moet toevoegen om specifieke libraries die uw applicatie gebruikt te monitoren. Deze gids legt uit hoe u aanvullende OpenTelemetry-instrumentatiepakketten kunt identificeren, installeren en configureren voor een betere observability-dekking.

​
Waarom aanvullende instrumentatie toevoegen?

Uw applicatie kan libraries gebruiken die niet worden gedekt door de instrumentatiepakketten die u tijdens de installatie heeft geïnstalleerd, zoals:
  • Database-drivers
  • HTTP-clientlibraries
  • Message-queue-systemen
  • Aangepaste of nichelibraries
Het toevoegen van instrumentatie voor deze libraries biedt een completere monitoringopzet voor alle componenten van uw applicatie.

​
Algemene stappen

Deze sectie beschrijft de stappen die voor de meeste talen nodig zijn om een aanvullende library te instrumenteren. Bekijk de sectie Taalspecifieke instructies voor taalspecifieke stappen.

​
1. Identificeer libraries om te instrumenteren

Bepaal eerst welke libraries uw applicatie gebruikt die u wilt monitoren. Veelvoorkomende kandidaten zijn:
  • Databaseclients (MySQL, PostgreSQL, MongoDB, Redis)
  • HTTP-clients
  • Message queues (RabbitMQ, Kafka, SQS)
  • Template-engines

​
2. Vind instrumentatiepakketten

Zoek naar instrumentatiepakketten in deze volgorde van voorkeur:
  1. Officiële OpenTelemetry-pakketten - Onderhouden door de OpenTelemetry-community
  2. OpenTelemetry contrib-pakketten - Door de community bijgedragen instrumentatie
  3. Pakketten van derden - Zorg ervoor dat u de maintainer vertrouwt en de code reviewt
Bekijk het OpenTelemetry Registry voor beschikbare instrumentatiepakketten. Houd er rekening mee dat sommige libraries op zichzelf OpenTelemetry-instrumentatie kunnen bevatten en dat er geen verdere configuratie nodig is.

​
3. Installeer het pakket

Zodra u een relevant instrumentatiepakket heeft gevonden, installeert u het instrumentatiepakket met de pakketmanager van uw taal. Bijvoorbeeld: 
go get go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp

​
4. Initialiseer de instrumentatie

Afhankelijk van de taal en de SDK-instrumentatiemethode, kunnen instrumentatiepakketten initialisatie in de startcode van uw applicatie vereisen. Dit omvat doorgaans:
  • Het importeren van het instrumentatiepakket
  • Het aanroepen van een initialisatiefunctie
  • Het configureren van eventuele pakketspecifieke opties
Voor sommige talen, zoals PHP en Java met auto-instrumentaties, is deze stap niet nodig. Het zal de instrumentatie automatisch opzetten, tenzij anders aangegeven.

​
5. Controleer binnenkomende gegevens

Verifieer na installatie dat de instrumentatie werkt:
  • Controleer of er nieuwe spans over de geïnstrumenteerde library verschijnen in uw traces die naar AppSignal.com worden gerapporteerd.
  • Bevestig dat metrics over de geïnstrumenteerde library naar AppSignal.com worden gerapporteerd.
  • Test foutscenario’s om er zeker van te zijn dat fouten worden gerapporteerd.

​
Taalspecifieke instructies

Voor gedetailleerde instructies over het toevoegen van instrumentatiepakketten voor specifieke talen:

​
Troubleshooting

​
Veelvoorkomende problemen

  • Ontbrekende traces: Zorg ervoor dat de instrumentatie wordt geïnitialiseerd voordat de library wordt gebruikt.
  • Onvolledige gegevens: Controleer of het instrumentatiepakket uw library-versie ondersteunt.
  • Dubbele spans: Vermijd het meerdere keren instrumenteren van dezelfde library.

​
Hulp krijgen

Als u problemen ondervindt:
  1. Bekijk de documentatie van het instrumentatiepakket
  2. Neem contact op met AppSignal-support voor hulp