CMChainmaestro.
Dernières actusIAApps à testerCette semaineGuidesLe média
Retour au journal

Open source et développement

OpenTelemetry déprécie les span events : comment préparer la transition vers les événements corrélés

OpenTelemetry recommande désormais d’émettre les nouveaux événements via l’API Logs et de les corréler au span actif. La transition est progressive : elle doit préserver les vues, attributs, coûts et alertes existants.

22 octobre 20265 min de lecturePar Romain Adler
OpenTelemetry déprécie les span events : comment préparer la transition vers les événements corrélés

Ce qu’il faut retenir

  • OpenTelemetry déprécie l’API d’enregistrement des span events, notamment les usages de Span.AddEvent et Span.RecordException, au profit d’événements fondés sur les logs.
  • Cette dépréciation ne supprime pas immédiatement les événements attachés aux spans ni les données existantes. Des mécanismes de compatibilité sont prévus.
  • Le nouveau code doit préférer l’API Logs avec le contexte actif afin de conserver la corrélation trace-log.
  • Avant migration, il faut vérifier ingestion, vues, requêtes, alertes, attributs, échantillonnage, cardinalité et coût dans le backend réellement utilisé.

Sommaire

  1. Comprendre ce qui change
  2. Inventorier les dépendances
  3. Comparer les deux représentations
  4. Mesurer volume et coût
  5. Déployer progressivement

Une API se déprécie, pas la capacité d’observer un événement

OpenTelemetry offrait deux voies proches : ajouter un événement à un span via l’API de traces, ou émettre un événement sous forme de log associé au contexte courant. Cette duplication compliquait les conventions, les SDK et l’expérience des opérateurs. Le projet oriente donc les nouveaux événements vers l’API Logs.

La nuance est importante : les span events restent présents dans le modèle OTLP de trace et les données existantes demeurent valides. Les versions stables d’instrumentations ne doivent pas changer brutalement de comportement. Les SDK et backends peuvent fournir une compatibilité qui réaffiche un événement fondé sur les logs dans une vue orientée span.

Une équipe n’a donc pas à réécrire toutes ses applications cette semaine. Elle doit arrêter d’ajouter une dépendance non nécessaire à l’ancienne API dans le nouveau code, puis observer comment les bibliothèques et conventions qu’elle utilise organisent leur prochaine version majeure.

Le risque se trouve dans les consommateurs, pas seulement dans le code

L’inventaire recherche les appels explicites à AddEvent et RecordException, mais aussi les événements générés par les frameworks, les auto-instrumentations et les bibliothèques. Il associe chaque événement à sa convention sémantique, ses attributs, son exporteur et son backend.

Ensuite viennent les consommateurs : vues de traces, requêtes, tableaux de bord, alertes, pipelines de transformation, politiques de rétention et exports secondaires. Une exception peut être visible aujourd’hui uniquement parce que le backend l’affiche dans la chronologie d’un span. Si la donnée arrive demain par le pipeline de logs, la même alerte peut cesser de fonctionner alors que l’application émet toujours l’information.

Cette chaîne rejoint le travail de cartographie des intégrations et contrats d’API. Nom de l’événement, attributs, contexte et schéma forment un contrat. Un changement de signal doit être versionné et testé comme tel.

Un test en double émission rend les écarts visibles

Sur un service non critique, l’équipe sélectionne quelques événements : exception, retry, timeout et décision métier technique. Elle conserve temporairement le span event et émet en parallèle son équivalent via l’API Logs, lorsque le SDK et l’instrumentation le permettent. Le contexte actif doit fournir les identifiants nécessaires à la corrélation.

La comparaison porte sur six points :

  1. l’événement arrive-t-il dans les deux pipelines sans perte ?
  2. le nom, la gravité, l’horodatage et les attributs restent-ils équivalents ?
  3. la vue de trace permet-elle encore de retrouver l’événement ?
  4. une requête partant du log retrouve-t-elle le span et la trace ?
  5. les alertes se déclenchent-elles une seule fois ?
  6. le masquage des données sensibles est-il identique ?

Le double envoi est un outil de recette limité dans le temps. Le laisser en place sans date de sortie double certains volumes, crée des doublons d’alerte et rend les tendances incomparables. Le plan désigne l’événement, la version, la période, le propriétaire et le critère de retrait de l’ancienne voie.

Les systèmes d’agents rendent cette corrélation particulièrement utile, car une décision peut traverser modèle, outil et service. Le dossier sur les agents MCP en entreprise décrit ces enchaînements ; la télémétrie doit conserver l’identité de la trace sans exposer les secrets ni les contenus non nécessaires.

Un modèle plus cohérent peut coûter plus cher s’il est mal réglé

Les logs et les traces n’ont pas toujours la même tarification, la même rétention ni le même taux d’échantillonnage. Migrer un événement fréquent vers le pipeline de logs peut augmenter le volume indexé. À l’inverse, un span échantillonné pouvait faire disparaître des événements que le pipeline de logs conserve désormais.

Le test mesure événements par requête, octets avant et après traitement, attributs à forte cardinalité, taux de rejet, latence d’ingestion et volume stocké. Il distingue coût d’ingestion, coût d’indexation, rétention et requêtes. Les hypothèses sont propres au backend ; le dossier sur le coût complet de l’infrastructure fournit une grille pour ne pas réduire le calcul au tarif affiché.

La sécurité fait partie de la comparaison. Les attributs d’exception peuvent contenir URL, identifiants, entrées utilisateur ou jetons. Le passage par un autre pipeline ne doit pas contourner les règles de filtrage décrites dans le dossier sur la cybersécurité des systèmes automatisés.

Une transition par convention et par service

La première règle porte sur le nouveau code : utiliser les événements fondés sur les logs lorsque le SDK et la convention sémantique le recommandent. La deuxième protège l’existant : ne pas modifier un service uniquement pour suivre une annonce tant que son écosystème n’offre pas la compatibilité et la visibilité nécessaires.

La migration progresse ensuite par bibliothèque ou domaine. Chaque lot conserve une requête de comparaison, une alerte de référence et un tableau de volume. Le retour arrière restaure la configuration d’émission précédente, sans perdre les événements produits pendant l’essai.

Trois indicateurs suffisent : part des événements inventoriés, part des consommateurs validés et écart de volume/coût après migration. La décision finale appartient conjointement à l’équipe applicative, à la plateforme d’observabilité et aux opérateurs qui utilisent les vues en incident.

Sources officielles

  • OpenTelemetry, « Deprecating Span Events API », 17 mars 2026, consulté le 30 septembre 2026.
  • OpenTelemetry, spécification des logs, consultée le 30 septembre 2026.
  • OpenTelemetry, blog officiel et annonces du projet, consulté le 30 septembre 2026.

La prochaine action raisonnable

Choisir une exception réellement utilisée dans un tableau de bord, produire son équivalent log corrélé et vérifier la chaîne complète jusqu’à l’alerte. La migration commence par cette preuve, pas par une recherche-remplacement.

L'auteur

Romain Adler

Romain Adler couvre la mesure, la donnée décisionnelle et les tableaux de bord, avec une obsession simple : rendre l'information actionnable.

Tous les articles

À lire ensuite

Même rubrique

Voir tout
Node.js 26 : préparer une migration vers le support LTS

Node.js 26 : préparer une migration vers le support LTS

PostgreSQL 19 : tester sa migration sur un environnement isolé

PostgreSQL 19 : tester sa migration sur un environnement isolé

Chainmaestro.

Un média indépendant pour comprendre la technologie, l'intelligence artificielle et les nouveaux business numériques.

Tech · idées · impact

Explorer

Tous les articlesIntelligence artificielleCybersécuritéStartups et financement

Informations

À proposContactMentions légalesPolitique de cookies
© 2026 Chainmaestro. Tous droits réservés.