C'est quoi, cet outil ?
Un moteur de recherche gratuit et instantané sur le registre officiel des semantic conventions OpenTelemetry. Il indexe chaque attribut (y compris les resource attributes), chaque métrique, span, event et entity définis par la spécification OTel — noms, descriptions, valeurs d'enum, exemples, unités et notes de dépréciation — avec une recherche approximative : une requête comme « http method » ou « gen_ai tokens » trouve la bonne convention même sans en connaître le nom exact.
Pourquoi vérifier les semantic conventions avant de nommer sa télémétrie ?
Les semantic conventions OpenTelemetry définissent des noms standard pour la télémétrie
(traces, métriques, logs) — par exemple http.request.method,
db.system.name ou k8s.pod.name. Réutiliser un attribut standard
plutôt que d'en inventer un garde votre télémétrie interrogeable, permet aux backends
d'observabilité de construire des dashboards automatiquement, et rend les données
comparables entre services et équipes. Le registre contient des milliers de définitions
réparties sur des dizaines de domaines (HTTP, bases de données, messaging, Kubernetes,
cloud, Gen AI…), ce qui rend la question « cet attribut existe-t-il déjà ? »
étonnamment difficile — cet outil y répond en quelques secondes.
FAQ
Comment savoir si un attribut OpenTelemetry existe déjà ?
Tapez quelques mots décrivant le concept (ex : « queue message size ») dans le champ ci-dessus. L'outil cherche dans les noms, descriptions, notes et valeurs d'enum de tout le registre, et chaque résultat renvoie vers sa documentation officielle et sa source YAML.
Que se passe-t-il si j'utilise un nom d'attribut custom ?
Rien ne casse, mais vous perdez l'interopérabilité : les backends ne reconnaîtront pas l'attribut, et une future version d'OTel pourrait standardiser le même concept sous un autre nom, imposant une migration. Les règles de nommage OTel recommandent de réutiliser les conventions existantes dès que possible.
Les données sont-elles à jour ?
L'index est généré directement depuis le dossier model/ du dépôt officiel
open-telemetry/semantic-conventions ;
la version indexée est affichée en haut de page.