# Types de widgets

Les dashboards QuantumLogs supportent plusieurs types de widgets pour visualiser vos données.

## KPI (indicateur clé)

Le widget KPI affiche une **valeur unique** mise en avant, idéal pour les métriques essentielles.

**Exemples d'utilisation** :

* Nombre de joueurs en ligne actuellement
* Total de logs aujourd'hui
* Nombre de connexions cette semaine

**Configuration** :

* Métrique à afficher
* Format de la valeur (nombre, pourcentage, etc.)

## Jauge (Gauge)

Le widget Jauge affiche une valeur dans un **cadran circulaire** avec des seuils colorés, parfait pour les métriques avec une plage connue.

**Exemples d'utilisation** :

* Taux de remplissage du serveur (joueurs / max)
* Pourcentage d'utilisation des ressources

**Configuration** :

* Métrique à afficher
* Valeur minimale et maximale
* Seuils de couleur

## Graphique en courbe (Line / Area)

Le widget Line/Area affiche l'**évolution temporelle** d'une métrique sous forme de courbe.

**Exemples d'utilisation** :

* Évolution du nombre de joueurs sur 24h
* Tendance des logs par heure
* Comparaison entre serveurs

**Configuration** :

* Métrique(s) à afficher
* Période temporelle
* Serveur(s) source
* Style : courbe (line) ou aire (area)

## Graphique en barres (Bar)

Le widget Bar affiche des données en **barres** pour la comparaison, avec support multi-serveurs.

**Exemples d'utilisation** :

* Nombre de logs par serveur
* Répartition des types d'événements
* Comparaison journalière

**Configuration** :

* Métrique à afficher
* Regroupement (par heure, jour, semaine)
* Serveur(s) source

## Tailles des widgets

Chaque widget peut être dimensionné :

| Taille             | Largeur        | Usage recommandé                   |
| ------------------ | -------------- | ---------------------------------- |
| **Petit**          | 1/4 de la page | KPI, jauges                        |
| **Moyen**          | 1/2 de la page | Graphiques simples                 |
| **Grand**          | 3/4 de la page | Graphiques détaillés               |
| **Pleine largeur** | 100%           | Graphiques complexes, comparaisons |

## Éditeur de widget

L'éditeur de widget permet de configurer :

* **Type** : KPI, Jauge, Courbe, Barres
* **Titre** : Nom affiché en haut du widget
* **Métrique** : La donnée à visualiser (via le sélecteur de métriques)
* **Taille** : Dimensions du widget dans la grille
* **Options spécifiques** selon le type de widget


---

# 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:

```
GET https://docsnew.quantumlogs.cloud/dashboard-and-widgets/widgets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.