Définition d’OpenTelemetry, projet de la CNCF consacré à la télémétrie
OpenTelemetry est un projet open source hébergé par la Cloud Native Computing Foundation (CNCF). Sa documentation le présente comme un cadre et une boîte à outils d’observabilité, qui facilitent la production, l’export et la collecte de données de télémétrie : traces, métriques et journaux. Il est indépendant des éditeurs comme des outils d’analyse.
Le projet est issu de la fusion de deux projets antérieurs, OpenTracing et OpenCensus, qui visaient chacun un standard d’instrumentation du code. D’après la page que lui consacre la CNCF, il a été accepté par la fondation le 7 mai 2019, est passé au niveau de maturité « Incubating » le 26 août 2021, puis au niveau « Graduated » le 11 mai 2026.
Le besoin d’un standard d’instrumentation
Pour qu’un système soit observable, son code doit émettre des signaux, envoyés à un outil d’analyse. Lorsque chaque outil apporte ses bibliothèques et son format, en changer oblige à reprendre l’instrumentation des applications.
La documentation du projet résume sa réponse en deux principes : l’organisation reste propriétaire des données qu’elle produit, sans dépendance à un fournisseur, et les équipes n’apprennent qu’un seul jeu d’interfaces et de conventions. Savoir si une supervision suffit est une autre question, traitée dans notre article observabilité vs supervision.
Signaux et composants d’OpenTelemetry
Le projet appelle signaux les catégories de télémétrie qu’il prend en charge. Sa documentation en cite quatre : les traces (le parcours d’une requête dans l’application), les métriques (une mesure relevée à l’exécution), les journaux (l’enregistrement d’un événement) et le baggage (un contexte transmis d’un signal à l’autre). Les profils et les événements y figurent comme en développement ou à l’état de proposition.
| Composant | Rôle |
|---|---|
| Spécification | Fixe les exigences communes à toutes les implémentations, quel que soit le langage |
| API et SDK par langage | L’API sert à produire la télémétrie dans le code ; le SDK l’implémente, traite les données et les exporte |
| Instrumentation | Par le code, ou sans le modifier (zero-code) pour les bibliothèques courantes |
| Conventions sémantiques | Des noms communs pour les opérations et les données |
| OTLP (OpenTelemetry Protocol) | Le protocole qui fixe l’encodage, le transport et la remise des données |
| Collector | L’intermédiaire qui reçoit, traite et exporte la télémétrie |
La spécification d’OTLP le définit sur gRPC et sur HTTP. À la date de rédaction, elle se déclare stable pour les traces, les métriques et les journaux.
Le Collector est un exécutable unique, organisé en pipelines : des récepteurs (receivers) collectent les données, des processeurs (processors) facultatifs les transforment ou les filtrent, des exportateurs (exporters) les envoient vers une ou plusieurs destinations. La documentation décrit deux modes de déploiement : en agent, aux côtés de l’application ou sur le même hôte, et en passerelle (gateway), service autonome qui offre un point d’entrée OTLP unique, par exemple par cluster.
OpenTelemetry, backend d’observabilité, SRE : ne pas confondre
OpenTelemetry n’est pas un backend d’observabilité : sa documentation laisse à dessein le stockage et la visualisation à d’autres outils, libres comme Jaeger ou Prometheus, ou commerciaux. L’adopter ne dispense pas de choisir où les données sont conservées.
Ce n’est pas non plus une méthode. Le projet fournit des formats et des outils ; le choix du parcours à instrumenter, la propagation du contexte d’un service à l’autre et la règle d’échantillonnage restent des décisions d’équipe, exposées dans notre article sur l’observabilité des systèmes distribués. Enfin, OpenTelemetry ne fixe aucun objectif de fiabilité : cette notion relève du SRE.
Exemple : le trajet d’une trace, du service au backend
Prenons un service de réservation. L’instrumentation sans modification du code produit des traces pour ses requêtes HTTP entrantes et sortantes. L’équipe ajoute, par l’API, un attribut métier : le canal de vente. Le SDK exporte ces données en OTLP vers un Collector en agent, qui les transmet à une passerelle.
Un processeur y retire un attribut sensible, puis deux exportateurs envoient les traces vers un outil de traçage et les métriques vers une base de séries temporelles. Si l’organisation adopte un autre outil d’analyse compatible, elle reconfigure l’exportateur : l’instrumentation du service n’est pas reprise.
Relier ces signaux à des objectifs de niveau de service et à des alertes est l’objet de notre page consacrée au SRE et à l’observabilité.