1. Deux chemins #
OneAgent ou OTLP.
Architecture #
| Situation | Approche |
|---|---|
| Hôtes où OneAgent peut être installé | OneAgent : instrumentation automatique, et capture des spans OpenTelemetry déjà présents |
| Serverless, environnements sans agent, langages non couverts | SDK OpenTelemetry vers OTLP |
| Plusieurs backends, besoin de transformer | OpenTelemetry Collector entre les applications et Dynatrace |
2. Envoyer en OTLP #
Endpoint, jeton, temporalité.
Configuration #
| Signal | Endpoint | Permission du jeton |
|---|---|---|
| Traces | https://<env>.live.dynatrace.com/api/v2/otlp/v1/traces | openTelemetryTrace.ingest |
| Métriques | .../api/v2/otlp/v1/metrics | metrics.ingest |
| Logs | .../api/v2/otlp/v1/logs | logs.ingest |
# collecteur : exportateur vers Dynatrace
exporters:
otlphttp/dynatrace:
endpoint: https://<env>.live.dynatrace.com/api/v2/otlp
headers: { Authorization: "Api-Token ${env:DT_API_TOKEN}" }
processors:
cumulativetodelta: {} # Dynatrace attend des métriques en temporalité delta
batch: {}
service:
pipelines:
traces: { receivers: [otlp], processors: [batch], exporters: [otlphttp/dynatrace] }
metrics: { receivers: [otlp], processors: [cumulativetodelta, batch], exporters: [otlphttp/dynatrace] }
logs: { receivers: [otlp], processors: [batch], exporters: [otlphttp/dynatrace] }Erreur Courante : Des métriques OTLP envoyées en temporalité cumulative sont rejetées : configurez le SDK en delta (OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta) ou ajoutez le processeurcumulativetodeltadans le collecteur.
3. Bonnes pratiques #
Cohabiter sans doublons.
Règles #
- Ne pas instrumenter deux fois le même processus (OneAgent et agent OpenTelemetry automatique) : choisir l'un ou l'autre par service.
- Utiliser la propagation W3C Trace Context, comprise par OneAgent et OpenTelemetry, pour des traces de bout en bout entre services instrumentés différemment.
- Renseigner
service.name,deployment.environmentetservice.version: Dynatrace les utilise pour nommer et regrouper les services. - La distribution Dynatrace OTel Collector contient les composants testés et supportés par Dynatrace.
