OpenTelemetry et agents IA : que suivre quand ça bouge ?
Le 6 octobre 2026, la métrique standard de latence des appels de modèle IA a changé de nom. Votre panneau s’éteindrait-il sans la moindre erreur ?
EN 30 SECONDES
Les conventions sémantiques GenAI d’OpenTelemetry sont des noms partagés pour les durées, les tokens et les appels d’outils que remontent les modèles d’IA et les agents, lisibles par les outils compatibles. Elles restent au statut Development, sans version publiée, et ont encore changé le 6 octobre 2026.
À RETENIR · 3
- Les conventions GenAI ont désormais leur propre dépôt. Chaque span, métrique et attribut gen_ai.* y est au statut Development, sans version publiée.
- Le 6 octobre 2026, la PR #521 a ajouté gen_ai.client.inference.duration pour les appels de modèle. gen_ai.client.operation.duration ne devrait plus être émise pour l’inférence.
- Une métrique renommée peut vider un panneau sans la moindre erreur, dès que l’ancien nom n’arrive plus.
Sur cette page
Pourquoi un panneau de latence s’éteint
EN BREF Un nom de métrique dont dépendent vos tableaux de bord peut changer sans prévenir, parce que la spécification qui le définit bouge encore.
LES MOTS À CONNAÎTRE
- Span
- Une étape de travail chronométrée, comme un appel de modèle ou d’outil, avec un nom et des paires clé-valeur appelées attributs.
- Trace
- L’ensemble des spans d’une exécution, reliés de parent à enfant, pour voir quelle étape en a lancé une autre.
- Conventions sémantiques
- Les noms convenus par OpenTelemetry pour les spans, les attributs et les métriques, pour que tous les outils donnent le même sens au même nom.
- Statut Development
- Le premier niveau de maturité d’OpenTelemetry : les noms peuvent encore changer ou casser, et le projet déconseille de s’y fier en production.
EN CLAIR
La télémétrie, c’est ce qu’un système en marche dit de lui-même : durées, compteurs, journaux. OpenTelemetry est un standard ouvert pour la produire. Chaque Span Une étape de travail chronométrée, comme un appel de modèle ou d’outil, avec un nom et des paires clé-valeur appelées attributs. Voir le glossaire d’une Trace L’ensemble des spans d’une exécution, reliés de parent à enfant, pour voir quelle étape en a lancé une autre. Voir le glossaire porte des attributs, comme le nom du modèle.
UN RENOMMAGE, UN PANNEAU VIDE
Étape 1. Un appel de modèle se termine. Votre instrumentation, le code qui produit la télémétrie, le chronomètre.
- Un appel de modèle se termine Votre instrumentation, le code qui produit la télémétrie, le chronomètre.
- Avant la #521 Elle remonte gen_ai.client.operation.duration. Votre panneau de latence l’affiche.
- Votre bibliothèque adopte la #521 Les appels de modèle remontent désormais gen_ai.client.inference.duration.
- L’ancienne requête ne trouve rien Le panneau demande toujours l’ancien nom. Aucune erreur : la courbe reste à plat.
Ce changement date du 6 octobre 2026. KubeCon North America, la grande conférence du cloud, a lieu du 9 au 12 novembre à Salt Lake City : un bon moment pour choisir quoi instrumenter.
J’ai construit et fait tourner 46 agents pour les opérations internes d’Integra. J’ai aussi bâti une plateforme distincte de 11 agents pour un fonds de capital-investissement. Ce n’est pas un retour sur ces deux parcs, mais le lien que je ferais aujourd’hui avec les noms gen_ai.*.
ADAM explique : Pensez à un formulaire papier commun : chaque service remplit les mêmes cases imprimées. La limite : ce formulaire n’a pas de numéro d’édition, alors vous notez vous-même le commit.
Dans la section suivante : Mais d’où viennent ces noms partagés ?
Où sont définis les noms GenAI, et quelle est leur stabilité
EN BREF Ce sont les noms partagés d’OpenTelemetry pour la télémétrie de l’IA. Depuis juin 2026, ils ont leur propre dépôt, séparé des conventions de base.
Ces Conventions sémantiques Les noms convenus par OpenTelemetry pour les spans, les attributs et les métriques, pour que tous les outils donnent le même sens au même nom. Voir le glossaire donnent à chaque appel de modèle un nom de span et des attributs connus, sous gen_ai.*. Tout outil compatible peut alors compter les tokens par modèle.
Elles ont déménagé cette année. La base v1.41.0 (28 avril 2026) et son correctif v1.41.1 (11 mai) sont les derniers à contenir les pages GenAI. Depuis la v1.42.0 (12 juin 2026), un avis « Moved » renvoie vers semantic-conventions-genai.
Aucune convention GenAI de ce dépôt n’est stable. Chaque span, métrique et attribut GenAI que j’ai consulté est au Statut Development Le premier niveau de maturité d’OpenTelemetry : les noms peuvent encore changer ou casser, et le projet déconseille de s’y fier en production. Voir le glossaire. Aucun tag, aucune version publiée, et la section Schema URL du README dit juste « TODO ».
Le manifest, le fichier qui décrit le dépôt, donne une URL de schéma provisoire, gen-ai-dev/1.42.0-dev. Le 7 octobre, elle renvoyait une 404. Seuls les attributs stables repris de la base, comme error.type et server.address, sont garantis stables.
La métrique GenAI qui remplace gen_ai.client.operation.duration
EN BREF Pour les appels de modèle, c’est gen_ai.client.inference.duration, fusionnée le 6 octobre 2026. C’est le dernier de plusieurs changements cassants depuis août.
Elle vient de la PR #521 (pull request : une proposition de changement). L’ancienne métrique reste pour les autres opérations. Mais la page des métriques dit désormais qu’elle ne devrait plus être émise pour l’inférence (« SHOULD NOT be reported for inference operations »).
Chaque changement peut vider sans bruit un panneau construit sur l’ancien nom, dès que ce nom n’arrive plus. Je ne le reproche à personne : le statut Development existe pour que les noms s’améliorent avant d’être figés.
« Nous suivons les conventions GenAI d’OpenTelemetry » n’est pas une phrase complète. Quel commit ?
OBJET OBTENU
Nommer le commit
Sources, consultées le 7 octobre 2026 : semantic-conventions-genai, commit de la #521, métriques, manifest, avis de la base v1.42.0, niveaux de maturité.
FAQ
Des noms communs sous gen_ai.* pour la télémétrie de l’IA générative. Ils nomment les spans des appels de modèle, des agents, des outils et de la recherche, plus des métriques et des événements. Tous sont au statut Development, sans version publiée.
NIVEAU TERMINÉ
Ce que vous savez maintenant
- Pourquoi une métrique renommée peut vider un panneau sans déclencher d’erreur.
- Quelle couche des conventions GenAI est stable, et quelles autres peuvent encore changer.
Vérifiez par vous-même
Touchez ou cliquez une question pour voir la réponse.
Votre équipe dit « nous suivons les conventions GenAI d’OpenTelemetry ». Que manque-t-il à cette phrase, et pourquoi ?
Le commit. Au statut Development et sans version publiée, les noms bougent d’un commit à l’autre, comme avec la #521 le 6 octobre 2026.
Ingénieur web3 x IA, ancien CTO d’Integra. Auteur nommé (1 sur 5) d’ERC-3643, premier auteur d’ERC-6960, co-auteur d’ERC-7410 et co-auteur d’ERC-8203, encore à l’état de brouillon.
Un projet à livrer ou un poste à pourvoir ?
Parlons de votre besoinSuivre les notes techniques
Recevez les nouveaux articles sur l’IA en production et les smart contracts par email.