C'est quoi, cet outil ?
Un moteur de recherche sur les semantic
conventions OpenTelemetry.
Il indexe les noms de chaque entity (resource), ou signal de type metric,
span (trace) ou event (logs).
Il indexe aussi tous les noms d'attribute.
Il précise de plus une description et des valeurs sont données en exemple.
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
Par exemple http.request.method, db.system.name ou k8s.pod.name.
Réutiliser un nom standard plutôt que d'en inventer un garde votre télémétrie interrogeable, et permet aux backends
d'observabilité de construire des dashboards automatiquement, et rend les données
comparables entre services et équipes.
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 ?
la version indexée est affichée en bas de page.