1. Le concept d'instrumentation #
Comment le code émet-il des données ?
OpenTelemetry : Le contrat universel #
Avec OpenTelemetry (OTel), vous instrumentez votre code de manière agnostique. Vous utilisez des SDKs standards. Si vous changez de backend (de Honeycomb à Grafana), vous ne touchez pas à votre code. C'est la fin du 'Vendor Lock-in'.
OneAgent : L'injection magique #
Le OneAgent de Dynatrace ne demande aucun changement de code. Il s'injecte au runtime (ex: dans la JVM Java ou le process Node.js) et intercepte les appels automatiquement. C'est un gain de temps phénoménal pour les équipes de développement.
2. Maintenance et Contrôle #
Effort manuel vs Boîte noire.
L'effort OpenTelemetry #
OTel demande plus d'efforts : il faut configurer les SDKs, gérer les collecteurs et s'assurer que les bibliothèques utilisées sont bien supportées. Mais vous avez un contrôle total sur ce qui est envoyé.
La sérénité Dynatrace #
Le OneAgent gère tout : propagation du contexte de trace, métriques JMX, logs. Cependant, c'est une 'boîte noire' propriétaire. Vous dépendez de la réactivité de Dynatrace pour supporter de nouvelles versions de frameworks.
3. Faire cohabiter les deux #
Les deux approches se complètent.
Les chemins des données #
| Critère | OpenTelemetry | OneAgent |
|---|---|---|
| Déploiement | SDK ou agent par application, Collector | un agent par hôte ou l’Operator Kubernetes |
| Modification du code | aucune en auto-instrumentation, nécessaire pour les spans métier | aucune |
| Backend | au choix (OTLP) | Dynatrace |
| Profondeur | selon les bibliothèques instrumentées | très profonde (méthodes, SQL, processus, réseau) |
| Topologie et cause racine | dépend du backend | Smartscape + Davis |
| Gouvernance | projet CNCF, neutre | propriétaire |
Quand une application déjà instrumentée avec le SDK OpenTelemetry tourne sur un hôte équipé du OneAgent, Dynatrace peut capter ces spans et les intégrer aux traces du OneAgent. Sans OneAgent, l'application ou le Collector envoie directement en OTLP vers l'API Dynatrace.
Erreur courante : Activer en même temps l'auto-instrumentation OpenTelemetry et le OneAgent sur le même processus Java : on obtient des spans en double et un surcoût. Choisissez un instrumenteur principal par processus.
4. Conclusion #
L'un n'exclut pas l'autre.
Verdict #
La bonne nouvelle est que Dynatrace supporte nativement OpenTelemetry. La stratégie moderne consiste à utiliser le OneAgent pour l'essentiel de l'infrastructure et de l'APM automatique, tout en ajoutant des traces OpenTelemetry personnalisées pour les besoins métier spécifiques au cœur de votre code.
5. Commandes à connaître et TP #
Envoyer des traces OTel vers Dynatrace.
Commandes à connaître #
| Action | Commande |
|---|---|
| Auto-instrumentation Java | java -javaagent:opentelemetry-javaagent.jar -Dotel.service.name=checkout -jar app.jar |
| Destination OTLP Dynatrace | export OTEL_EXPORTER_OTLP_ENDPOINT=https://<env>.live.dynatrace.com/api/v2/otlp |
| Authentification | export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Api-Token <jeton>" |
| Protocole (HTTP obligatoire) | export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf |
| Auto-instrumentation Python | opentelemetry-bootstrap -a install && opentelemetry-instrument python app.py |
| Vérifier les spans dans Dynatrace (DQL) | fetch spans | filter service.name == "checkout" | limit 20 |
À savoir : Le jeton Dynatrace doit avoir les portéesopenTelemetryTrace.ingest,metrics.ingestetlogs.ingestselon les signaux envoyés. L'endpoint OTLP de Dynatrace accepte HTTP, pas gRPC : passez par un Collector pour convertir si besoin.
TP : la même application, deux instrumentations #
- Lancez une petite application Java (Spring Boot) avec l'agent OpenTelemetry et les variables ci-dessus.
- Dans Dynatrace, retrouvez les traces avec la requête DQL, puis ajoutez un span métier manuel (
tracer.spanBuilder("paiement")). - Arrêtez l'application, retirez l'agent OTel, installez le OneAgent sur l'hôte et relancez.
- Comparez : profondeur des traces, requêtes SQL visibles, métriques de processus, présence du span métier.
Résultat attendu : vous savez ce que chaque approche apporte et quand les combiner.
