← Retour au forum · 📚 Questions sur les formations
Quels attributs utiliser pour nommer mes spans HTTP (semconv) ?
-
Dans nos services, chaque équipe nomme les attributs à sa façon (
url,http_url,route...). Du coup, impossible de faire des tableaux de bord communs. Existe-t-il une norme ? -
✓ Réponse acceptée
Oui : les conventions sémantiques OpenTelemetry (semconv). Pour un serveur HTTP, les attributs stables sont :
-
http.request.method:GET,POST...
-http.route: la route sans identifiants (/users/{id})
-http.response.status_code:200,503...
-url.path,url.scheme,server.address,server.portEt le nom du span serveur suit la forme
{méthode} {route}:GET /users/{id}Si vous utilisez l'instrumentation automatique, ces attributs sont déjà posés. Pour vos attributs métier, préfixez-les par votre domaine (
acme.order.id) afin d'éviter les collisions.Astuce : ne mettez jamais un identifiant dans
http.routeni dans le nom du span, sinon la cardinalité explose côté métriques dérivées.