> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/gauge.md).
# Affichage jauge
Suivez une lecture par rapport à des seuils avec la jauge — des bandes colorées montrent les zones sûres, d’avertissement et de dépassement.
L’affichage Jauge représente chaque mesure comme un marqueur glissant le long d’une piste horizontale. La piste est graduée entre un minimum et un maximum, et chaque condition numérique que vous définissez devient une bande colorée le long de celle-ci — ainsi, la position du marqueur indique l’état de fonctionnement, et pas seulement une valeur. La figure est affichée en entier au-dessus de la piste.
C'est l'affichage des mesures où la position par rapport à des seuils est l’essentiel : qu’une valeur se situe dans sa bande de sécurité, qu’elle dérive vers une limite ou qu’elle l’ait déjà franchie.
## Quand le choisir
* Une mesure qui doit rester dans une plage de fonctionnement — pression, régime moteur, température contrôlée — où les bandes portent le sens.
* Alerte par le bas — un consommable ou une réserve où le marqueur qui tombe dans une bande rouge constitue l’avertissement.
* Alerte par le haut — un niveau qui doit rester bas, où le marqueur qui monte dans le rouge signale un problème.
La Jauge n’a pas d’extrémité « bonne » fixe ; vos bandes de conditions déterminent ce que signifie chaque extrémité de la piste. Lorsqu’une mesure comporte des seuils, la Jauge rend leur franchissement visible — les situations ci-dessus sont un point de départ, pas une limite.
## Configurer un affichage Jauge
Voici une configuration complète pour un cas réel — surveiller un puisard afin qu'une panne de pompe soit détectée avant l'inondation du sous-sol. La pompe maintient l’eau à un niveau bas ; le puisard a environ 100 cm de profondeur, et un capteur de niveau renvoie le niveau d’eau en centimètres — la mesure va donc de 0 (un fond de puisard sec) à 100 (l’eau au point de débordement). Ce 0–100 est l’échelle de la piste, et chaque condition colore une portion. C’est un exemple : une Jauge convient à toute mesure évaluée par rapport à des seuils — seuls le dispositif et les bords des bandes changent.
1. Ouvrez le tableau de bord en mode édition et cliquez sur **Dernières données** dans le sélecteur de widgets. Le panneau des paramètres s’ouvre sur l’onglet **Source de données** onglet, sans encore aucune source de données.
2. Cliquez sur **Ajouter une source de données**. Un **Source de données 1** bloc apparaît.
3. Dans le bloc, cliquez sur **Choisir un appareil** et sélectionnez le capteur de niveau du puisard.
4. Cliquez sur **Ajouter une métrique**. Une ligne de métrique apparaît.
5. Dans la ligne, définissez **Type de données** sur **Télémétrie**, choisissez la mesure du niveau d’eau sous **Métrique de l’appareil**, puis choisissez une **Icône**.
> **Cet affichage a besoin d’un nombre.** La **Métrique de l’appareil** liste propose tous les types de métriques, mais une jauge se remplit sur une échelle — choisissez ici une mesure numérique ; une valeur textuelle non numérique est lue comme 0. (Pour afficher un texte ou une valeur marche/arrêt telle quelle, utilisez l’ [affichage de valeur](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/number.md).) Pour modifier la manière dont une métrique est stockée, ouvrez **Appareils → Métriques** — voir [Métriques](/kilo-docs-fr/kilo-iot-server/devices/metric-templates.md).
6. Cliquez sur **Conditions : N** pour ouvrir la fenêtre modale Conditions. Définissez une **Couleur par défaut** — la couleur à laquelle la mesure revient lorsque aucune de vos conditions ne correspond à la valeur actuelle — puis, pour chaque bande, cliquez sur **Ajouter une condition** et remplissez la ligne — saisissez un **Nom de la condition**, définissez **Type de données** sur **Nombre** (le type de données propre à la condition, distinct de celui de la ligne de métrique), comme le puisard a 100 cm de profondeur, saisissez **De** 0 (le fond sec) et **À** 100 (le point de débordement), puis choisissez une **Couleur**. Vous pouvez ensuite saisir les niveaux de couleur. Par exemple :
En partant du fond sec :
* « Normal » — **De** 0, **À** 30 — vert
* « En hausse » — **De** 30, **À** 60 — jaune
* « Critique » — **De** 60, **À** 100 — rouge
Sur une Jauge, ces conditions s’affichent sous forme de bandes colorées le long de la piste. Cliquez sur **Enregistrer** pour fermer la fenêtre modale.
7. Cliquez sur **Suivant** pour ouvrir l’onglet **Apparence** .
8. Saisissez un **Nom du widget** — par exemple « Niveau du puisard » — ainsi qu’une **Description**.
9. Sous **Type de widget**, choisissez **Jauge**. Un **Plage de valeurs** section apparaît pour la métrique.
10. Définissez **Valeur min** sur **0** (un puisard sec) et **Valeur max** sur **100** (l’eau au débordement) — les deux extrémités de la piste, le même 0–100 utilisé par les bandes — et définissez **Repères** sur **10**.
11. Activez **Afficher la légende des données** si nécessaire, puis cliquez sur **Enregistrer**.
Le résultat : une piste dont le marqueur reste bas et vert tant que la pompe suit. Si la pompe tombe en panne, l’eau monte et le marqueur se déplace le long de la piste jusqu’à entrer dans la bande rouge — ce franchissement est l’événement que vous surveillez. Une remarque sur le capteur : un capteur de niveau indique une valeur plus élevée lorsque l’eau monte, tandis qu’un capteur de distance monté en hauteur indique une valeur plus faible — placez la bande rouge sur la valeur qui correspond à une eau haute pour le capteur que vous avez installé. La Jauge rend la condition visible sur le tableau de bord ; pour une notification, utilisez une [Alarme](/kilo-docs-fr/kilo-iot-server/alarm.md). La même piste en bandes surveille tout ce qui est mesuré par rapport à des limites — seuls la métrique et les bords des bandes changent.
## Exemples pratiques
**Un consommable qui s’épuise** Lorsque le danger se situe à l’ *extrémité basse* de la plage, colorez les bandes à l’inverse. Une réserve exprimée en pourcentage va de 0 % (vide) à 100 % (plein), donc la piste prend **Valeur min** 0 et **Valeur max** 100. Un réservoir de liquide de refroidissement ou de réactif reçoit alors trois conditions : « Faites l’appoint maintenant » — De 0, À 15 — rouge ; « Niveau bas » — De 15, À 40 — jaune ; « Bon état » — De 40, À 100 — vert. Le marqueur reste en haut et vert lorsque la réserve est pleine, puis descend vers le rouge à mesure que le procédé la consomme.
**Rester dans une plage de sécurité** Certaines mesures doivent rester *entre* deux limites, et non au-dessus ou au-dessous d’une seule. Pour un compresseur dont la pression fonctionne entre 0 et 10 bar, la piste couvre cette plage de fonctionnement — définissez **Valeur min** 0 et **Valeur max** 10 — puis peignez une bande verte au milieu avec des bandes d’avertissement aux deux extrémités : « Bas » — De 0, À 2 — rouge ; « Avertissement bas » — De 2, À 4 — jaune ; « Normal » — De 4, À 7 — vert ; « Avertissement haut » — De 7, À 9 — jaune ; « Haut » — De 9, À 10 — rouge. La position du marqueur montre d’un coup d’œil si l’équipement fonctionne là où il devrait, et une dérive vers l’une ou l’autre extrémité devient visible avant de se transformer en panne.
## Voir aussi
* [Widget Dernières données](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget.md) — Référence de configuration complète et autres types d’affichage
* [Conditions](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/conditions.md) — Règles numériques De/À qui deviennent les bandes de la piste
* Autres types d’affichage : [Valeur](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/number.md) · [Beignet](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/doughnut.md) · [Camembert](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/pie.md) · [Tube](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/tube.md) · [Jauge radiale](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/radial-gauge.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/last-data-widget/gauge.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
