> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Marqueurs de version sur les graphiques du dashboard
> Superposez, sur les graphiques temporels du dashboard, le moment où chaque version d’un service est apparue pour la première fois, à partir de l’expression de version du service configurée dans la source de la tuile
export const Image = ({img, alt, size = "lg", background}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
return ;
};
La première question face à un pic de latence ou d’erreurs est généralement de savoir si une nouvelle version a été déployée. Les graphiques temporels des dashboards permettent d’y répondre directement : activez les marqueurs de version, et chaque tuile trace une ligne verticale en pointillés au moment où une version d’un service apparaît pour la première fois dans sa télémétrie.
Les versions proviennent de la télémétrie que vous envoyez déjà, lue via une expression définie sur la source de la tuile. Aucune intégration d’intégration continue n’est nécessaire, et rien n’est à envoyer au moment du déploiement.
## Activer les marqueurs
Les marqueurs de version sont désactivés par défaut. Ouvrez le menu d’options d’un dashboard et sélectionnez **Afficher les marqueurs de version**.
Le commutateur ajoute `releaseMarkers=true` à l’URL du dashboard, afin que les liens que vous partagez s’ouvrent avec les marqueurs déjà activés. Il s’agit d’un état d’affichage et non de la configuration du dashboard : il n’est pas enregistré avec le dashboard et sa désactivation supprime à nouveau le paramètre.
Les marqueurs sont affichés sur les tuiles de séries temporelles dont la source est une source de logs ou de traces. Les [annotations d’alertes](/docs/fr/clickstack/features/alerts) sont accessibles depuis le même menu et peuvent être affichées simultanément : les deux types de marqueurs sont affichés ensemble et conservent chacun leurs propres libellés.
## Configurer la source de la version
Par défaut, ClickStack lit `ResourceAttributes['service.version']`, l’attribut de ressource OpenTelemetry. Si vos services respectent les [conventions sémantiques des ressources de service](https://opentelemetry.io/docs/specs/semconv/registry/attributes/service/), les marqueurs fonctionnent sans configuration.
Pour lire la version depuis un autre emplacement, définissez **Expression de version du service** dans la source de logs ou de traces. Modifiez la source sous **Paramètres de l’équipe → Sources**. Dans une source de logs, le champ se trouve sous **Configurer les champs facultatifs** ; dans une source de traces, il apparaît directement dans le formulaire, sous **Expression du nom du service**.
La valeur est une expression SQL, et non un nom d’attribut, ce qui couvre deux cas courants :
* **L’identifiant de version se trouve dans un autre attribut.** Avec GitOps, l’élément qui identifie une version est généralement le tag de l’image de conteneur, transmis sous la forme `container.image.tag`. Pointer la source vers `ResourceAttributes['container.image.tag']` est bien moins coûteux que de modifier l’instrumentation sur l’ensemble du parc.
* **Les services d’une même table utilisent des attributs différents.** Utilisez `coalesce` pour basculer d’un attribut à l’autre :
```sql theme={null}
coalesce(
nullIf(ResourceAttributes['service.version'], ''),
nullIf(ResourceAttributes['container.image.tag'], '')
)
```
Le champ est également disponible sous le nom `serviceVersionExpression` pour les sources de logs et de traces dans l’[API des sources](/docs/fr/clickstack/api-reference), ce qui vous permet de le définir lors de l’approvisionnement programmatique des sources. Consultez la liste complète des paramètres des sources pour les [logs](/docs/fr/clickstack/managing/config#logs) et les [traces](/docs/fr/clickstack/managing/config#traces).
## Ce que signifie un marqueur
Un marqueur indique qu'une valeur de version apparaît pour la première fois dans les données de la tuile au sein de la fenêtre visible. Cela s'apparente à un déploiement, mais il ne s'agit délibérément pas du même signal. C'est pourquoi il s'agit de marqueurs de version plutôt que de marqueurs de déploiement :
* Un déploiement qui ne modifie pas la chaîne de version ne produit aucun marqueur.
* Un service qui reste inactif plus longtemps que la période de recherche affiche un marqueur lorsqu'il remonte en charge.
La version qui était déjà en cours d'exécution à l'ouverture de la fenêtre est reconnue et écartée, plutôt que représentée comme une version qui n'a jamais existé. Pour ce faire, la requête remonte avant le début de la fenêtre — de 30 minutes, ou de 10 % de la fenêtre si cette durée est plus longue — afin d'identifier la version en cours.
## Quelles versions une tuile affiche
La requête sur les versions s’exécute sur la source de la tuile, avec ses propres prédicats : sa clause `WHERE`, le filtre de chaque série et les éventuels [filtres du dashboard](/docs/fr/clickstack/features/dashboards/overview#custom-filters). Ce qu’affiche une tuile dépend de ce qu’elle représente dans le graphique :
| Tuile | Marqueurs |
| :----------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
| Filtrée sur un seul service | Les versions de ce service |
| Regroupée par service | Les versions de chaque service représenté dans le graphique, chacune colorée pour correspondre à sa propre ligne |
| Ligne agrégée sur plusieurs services | Aucune, sauf si toutes les versions de la fenêtre proviennent d’un seul service |
Dans le troisième cas, le service d’un marqueur n’a aucune ligne correspondante dans le graphique ; les marqueurs sont donc supprimés. Si toutes les versions de la fenêtre proviennent d’un seul service, elles sont affichées à la place, dans la couleur de marqueur par défaut.
## Consulter les marqueurs sur un graphique dense
Survolez l’étiquette d’un marqueur pour afficher toutes les versions à cet endroit, ainsi que le service qui les a publiées, leur numéro de version et l’heure.
La couleur associe un marqueur à sa série, mais la légende d’un graphique affiche au maximum quatre entrées avant de regrouper les autres sous « +N autres ». Il n’y a alors plus rien à l’écran permettant d’identifier la couleur. L’infobulle indique explicitement le nom du service et fonctionne donc quel que soit le nombre de séries affichées dans la tuile.
Les marqueurs trop rapprochés pour être étiquetés individuellement sont regroupés sous une seule ancre libellée `N versions` ; son survol les répertorie toutes. Un regroupement couvrant plusieurs services est affiché dans une couleur neutre plutôt que dans celle de l’un d’eux, afin que le nombre reste exact sans laisser entendre qu’un service en est propriétaire.
Le glissement horizontal sur le tracé permet toujours de zoomer lorsque les marqueurs sont affichés.
## Limitations
* **Uniquement les tuiles de séries temporelles.** Les tables, nombres et heatmaps n'affichent pas de marqueurs.
* **Uniquement les sources de logs et de traces.** Une source de métriques résout sa table en fonction du type de métrique ; il n'existe donc pas de table unique à réagréger ni de moyen de donner un sens aux filtres d'une tuile. Pour annoter des données de métriques, placez une tuile de logs ou de traces à côté, sur le même dashboard.
* **Les valeurs de version vides sont ignorées.** Un service qui n'émet aucune version ne génère aucun marqueur. Si une tuile ne détecte aucun changement de version, ClickStack affiche `No releases found` plutôt que de vous laisser vous demander si la fonctionnalité est défaillante.
* **Jusqu'à 500 versions distinctes** sont lues par fenêtre.