Je exporteert OpenTelemetry-data naar Dynatrace via het OTLP-protocol (OpenTelemetry Protocol), waarbij je je applicatie of OpenTelemetry Collector configureert om telemetriedata te sturen naar het Dynatrace OTLP-endpoint. Dynatrace ondersteunt OTLP over HTTP en gRPC, en authenticatie verloopt via een API-token. Dit werkt voor traces, metrics en logs, en maakt Dynatrace een volwaardige backend voor je OpenTelemetry-instrumentatie. In dit artikel behandelen we de meestgestelde vragen over de integratie, van basisinstellingen tot veelvoorkomende problemen.
Welke OpenTelemetry-signalen ondersteunt Dynatrace?
Dynatrace ondersteunt alle drie de primaire OpenTelemetry-signaaltypen: traces, metrics en logs. Je kunt elk van deze signalen via het OTLP-protocol naar Dynatrace sturen, zowel over HTTP als over gRPC. Dit maakt Dynatrace een volwaardige observability-backend voor OpenTelemetry-geïnstrumenteerde applicaties.
Traces worden opgeslagen en weergegeven in Dynatrace Distributed Tracing, waarmee je end-to-end de doorlooptijd van requests door je applicatieketen kunt volgen. Metrics worden ingelezen als Dynatrace-metrics en kunnen worden gebruikt in dashboards en alerting. Logs worden gekoppeld aan de bijbehorende traces en services, wat contextrijke foutanalyse mogelijk maakt.
Dynatrace verrijkt binnenkomende OpenTelemetry-data automatisch met metadata uit zijn eigen topologiemodel. Dat betekent dat een trace die via OTLP binnenkomt, automatisch gekoppeld wordt aan de betreffende service, host of cloud-omgeving, zolang de juiste resource-attributen aanwezig zijn in de telemetriedata.
Hoe stuur je OpenTelemetry-data direct naar Dynatrace via OTLP?
Je stuurt OpenTelemetry-data direct naar Dynatrace door in je SDK of exporteur het Dynatrace OTLP-endpoint in te stellen en een geldig API-token mee te geven als bearer-token in de HTTP-header. Het endpoint heeft de vorm https://<your-environment-id>.live.dynatrace.com/api/v2/otlp, gevolgd door het signaalspecifieke pad.
De volledige endpoints per signaaltype zijn:
- Traces:
/v1/traces - Metrics:
/v1/metrics - Logs:
/v1/logs
In je SDK-configuratie stel je de exporter in op otlp en geef je het endpoint en de header mee. In Python ziet dat er bijvoorbeeld zo uit: je stelt OTEL_EXPORTER_OTLP_ENDPOINT in als omgevingsvariabele, samen met OTEL_EXPORTER_OTLP_HEADERS met de waarde Authorization=Api-Token <jouw-token>. Hetzelfde patroon werkt voor Java, Node.js en andere ondersteunde talen.
Het API-token heeft de juiste scopes nodig: openTelemetryTrace.ingest, metrics.ingest en logs.ingest, afhankelijk van welke signaaltypen je wilt inzenden. Zorg dat je het token aanmaakt via de Dynatrace-omgeving onder Access Tokens en sla het veilig op, bij voorkeur als omgevingsvariabele of in een secrets manager.
Wanneer gebruik je de OpenTelemetry Collector in plaats van een directe verbinding?
Je gebruikt de OpenTelemetry Collector wanneer je meerdere services, talen of omgevingen hebt die telemetriedata genereren, en je die data wilt bundelen, transformeren of doorsturen naar meerdere backends tegelijk. De Collector fungeert als een centrale proxy tussen je applicaties en Dynatrace, en geeft je meer controle over de datapipeline.
Een directe verbinding vanuit de SDK is eenvoudiger en werkt goed voor kleinere setups of voor teams die snel willen starten. Zodra de complexiteit toeneemt, biedt de Collector echter duidelijke voordelen:
- Je kunt data filteren, samplen of verrijken voordat die Dynatrace bereikt
- Je stuurt dezelfde data tegelijkertijd naar Dynatrace én naar een andere backend, zoals Prometheus of Jaeger
- Je centraliseert het beheer van endpoints en tokens, zodat individuele services die niet hoeven te kennen
- Je buffert data lokaal bij netwerkstoringen, wat dataverlies vermindert
In Kubernetes-omgevingen wordt de Collector vaak als DaemonSet of als sidecar ingezet, zodat telemetriedata van alle pods via één gecontroleerd kanaal naar Dynatrace stroomt. Dit sluit goed aan bij een volwassen full stack observability-aanpak, waarbij je zicht wilt op de volledige applicatieketen zonder dat elke service zijn eigen exportconfiguratie beheert.
Hoe configureer je de OpenTelemetry Collector om data naar Dynatrace te sturen?
Je configureert de OpenTelemetry Collector voor Dynatrace door in het configuratiebestand een OTLP-exporter te definiëren met het Dynatrace-endpoint en het API-token als header. Vervolgens koppel je die exporter aan de juiste pipelines voor traces, metrics en logs.
Een minimale configuratie in collector-config.yaml ziet er als volgt uit:
- Definieer een receiver, bijvoorbeeld
otlpop poort 4317 (gRPC) of 4318 (HTTP), om data van je applicaties te ontvangen - Definieer een exporter van het type
otlphttpmet het Dynatrace-endpoint en de Authorization-header - Voeg optioneel een processor toe, zoals
batch, om data te bundelen voor efficiënter transport - Koppel alles in de pipelines-sectie: receiver naar processor naar exporter, voor elk signaaltype apart
Let op dat je voor elk signaaltype het juiste eindpad gebruikt. Dynatrace verwacht traces op /api/v2/otlp/v1/traces, metrics op /api/v2/otlp/v1/metrics en logs op /api/v2/otlp/v1/logs. Als je één enkel endpoint definieert in de Collector-exporter, zorg dan dat Dynatrace het OTLP-pad correct afhandelt, of definieer aparte exporters per signaaltype.
Waarom verschijnen OpenTelemetry-traces niet in Dynatrace?
OpenTelemetry-traces verschijnen niet in Dynatrace door een van drie veelvoorkomende oorzaken: een onjuist of onbereikbaar endpoint, een API-token zonder de juiste ingest-scope, of ontbrekende resource-attributen waardoor Dynatrace de trace niet aan een bekende service kan koppelen.
Doorloop deze controlepunten stap voor stap:
- Endpoint: Controleer of de environment-ID in de URL klopt en of het volledige pad correct is, inclusief
/api/v2/otlp/v1/traces - Token: Verifieer dat het token de scope
openTelemetryTrace.ingestheeft en niet verlopen is - Headers: Zorg dat de header exact luidt
Authorization: Api-Token <token>, zonder spaties of typfouten - Sampling: Als je head-based sampling hebt ingesteld in je SDK, controleer dan of de sample rate niet te laag is voor testverkeer
- Resource-attributen: Voeg minimaal
service.nametoe als resource-attribuut, anders kan Dynatrace de trace niet correct categoriseren
Gebruik de Dynatrace-omgeving zelf als debugtool: onder Settings kun je de OTLP-ingest controleren op fouten. De Collector-logs zijn ook een waardevolle bron, want een 401- of 403-statuscode wijst direct op een tokenfout, terwijl een 404 meestal op een verkeerd endpoint wijst.
Wat is het verschil tussen de Dynatrace OneAgent en OpenTelemetry voor instrumentatie?
De Dynatrace OneAgent instrumenteert applicaties automatisch en zonder codewijzigingen, terwijl OpenTelemetry een open standaard is waarbij je zelf instrumentatiecode toevoegt aan je applicatie. Het grootste verschil zit in de mate van controle, vendor-afhankelijkheid en de diepte van automatische detectie.
Dynatrace OneAgent
De OneAgent installeert zich op host- of containerniveau en injecteert automatisch instrumentatie in ondersteunde runtimes zoals Java, .NET, Node.js en Python. Je hoeft geen code aan te passen. De agent detecteert services, afhankelijkheden en topologie automatisch en koppelt die aan het Dynatrace-platform. Dit levert direct rijke inzichten op, maar bindt je wel aan Dynatrace als platform.
OpenTelemetry
OpenTelemetry is vendor-neutraal en gestandaardiseerd door de CNCF. Je voegt instrumentatiebibliotheken toe aan je code of gebruikt automatische instrumentatie via agents die de OpenTelemetry-standaard volgen. De data die je genereert is draagbaar: je kunt die naar Dynatrace sturen, maar ook naar Grafana, Jaeger, of een andere backend. Dit geeft meer flexibiliteit, maar vereist meer configuratie en onderhoud.
In de praktijk combineren veel organisaties beide aanpakken: de OneAgent voor brede, automatische dekking van bestaande services, en OpenTelemetry voor maatwerkinstrumentatie van nieuwe microservices of voor omgevingen waar de OneAgent niet kan worden ingezet. Dynatrace ondersteunt deze hybride aanpak expliciet en kan data van beide bronnen samenvoegen in één weergave.
Wil je weten welke aanpak het beste past bij jouw applicatielandschap? Wij helpen je graag bij het bepalen van de juiste strategie. Neem contact op voor een vrijblijvend gesprek.
Veelgestelde vragen
Kan ik OpenTelemetry-data naar meerdere backends tegelijk sturen, waaronder Dynatrace?
Ja, dit is mogelijk via de OpenTelemetry Collector. Door meerdere exporters te definiëren in je Collector-configuratie en deze aan dezelfde pipeline te koppelen, stuur je dezelfde telemetriedata gelijktijdig naar Dynatrace én naar andere backends zoals Prometheus, Grafana of Jaeger. Dit is een van de grootste voordelen van de Collector ten opzichte van een directe SDK-verbinding, waarbij je doorgaans gebonden bent aan één endpoint per signaaltype.
Welke resource-attributen zijn verplicht of sterk aanbevolen voor een goede integratie met Dynatrace?
Het attribuut `service.name` is het meest kritisch: zonder dit attribuut kan Dynatrace de binnenkomende telemetriedata niet aan een specifieke service koppelen. Daarnaast zijn `service.version`, `deployment.environment` en `telemetry.sdk.language` sterk aanbevolen, omdat Dynatrace deze gebruikt om services te categoriseren en te verrijken binnen zijn topologiemodel. Hoe meer relevante resource-attributen je meegeeft, hoe rijker de context die Dynatrace automatisch kan opbouwen rondom je traces, metrics en logs.
Hoe test ik of mijn OTLP-configuratie correct werkt voordat ik naar productie ga?
De eenvoudigste manier is om een testapplicatie of een eenvoudig script te draaien dat bewust een trace of metric genereert, en vervolgens in de Dynatrace-omgeving te controleren of de data binnenkomt onder Distributed Tracing of Metrics. Gebruik daarnaast de Collector-logs of de SDK-debug-output om HTTP-statuscodes te controleren: een 200-response bevestigt succesvolle ingest, terwijl een 401, 403 of 404 direct wijst op respectievelijk een tokenfout of een onjuist endpoint. Je kunt ook de Dynatrace-omgeving raadplegen via Settings u003e OpenTelemetry u0026 OpenTracing voor ingest-statistieken en foutmeldingen.
Wat zijn de kosten of limieten verbonden aan het inzenden van OpenTelemetry-data naar Dynatrace?
Dynatrace hanteert verbruiksgebaseerde prijzen voor OTLP-ingest: traces worden verrekend op basis van het aantal ingested spans, metrics op basis van het aantal metric data points, en logs op basis van het volume in gigabytes. Er gelden ook rate limits op API-niveau, die per omgeving kunnen variëren. Het is verstandig om al vroeg in je implementatie sampling en filtering in te stellen via de OpenTelemetry Collector, zodat je alleen relevante en waardevolle data naar Dynatrace stuurt en onnodige kosten vermijdt.
Kan ik bestaande Prometheus-metrics doorsturen naar Dynatrace via de OpenTelemetry Collector?
Ja, de OpenTelemetry Collector heeft een ingebouwde Prometheus-receiver waarmee je bestaande Prometheus-metrics kunt scrapen en omzetten naar het OTLP-formaat, waarna je ze via de OTLP-exporter naar Dynatrace stuurt. Dit is een populaire aanpak voor teams die al Prometheus gebruiken en hun metrics willen consolideren in Dynatrace zonder hun bestaande instrumentatie te herschrijven. Let er wel op dat Prometheus-metrics worden omgezet naar het Dynatrace-metriekmodel, waarbij sommige labelconventies en metriektypes een lichte transformatie ondergaan.
Hoe ga ik om met gevoelige data in OpenTelemetry-attributen voordat die Dynatrace bereikt?
Je kunt de OpenTelemetry Collector inzetten als filterlaag om gevoelige attributen te verwijderen of te maskeren vóór verzending naar Dynatrace. Met de `transform`-processor of de `attributes`-processor kun je specifieke span- of log-attributen hernoemen, verwijderen of vervangen door geanonimiseerde waarden. Dit is essentieel voor compliance met AVG of andere privacyregelgeving, en het is een best practice om dit centraal in de Collector te regelen in plaats van in elke individuele applicatie.
Is het mogelijk om OpenTelemetry te gebruiken in combinatie met de Dynatrace OneAgent op dezelfde host of container?
Ja, Dynatrace ondersteunt deze hybride aanpak expliciet. De OneAgent kan draaien naast een OpenTelemetry-geïnstrumenteerde applicatie en Dynatrace voegt de data van beide bronnen samen in één weergave. Wanneer de OneAgent aanwezig is, kan hij OpenTelemetry-traces zelfs automatisch verrijken met aanvullende context uit zijn eigen topologiedetectie. Zorg er wel voor dat je geen dubbele instrumentatie creëert voor dezelfde operaties, omdat dit kan leiden tot verdubbelde spans en verhoogde ingest-kosten.


