> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Par où commencer : ouvrir le bon dashboard

> Guide de navigation rapide dans les 13 dashboards Grafana de Kaeyros. Trouvez le bon tableau de bord selon le symptôme rapporté, sans deviner.

Quand on vous dit que quelque chose ne va pas, la première question n'est pas "pourquoi?", mais "où regarder?". Ce guide répond exactement à cela. Il liste les phrases qu'on entend réellement, et indique pour chacune le dashboard Grafana à ouvrir en premier, avec la raison de ce choix.

## Que vous dit-on

| Ce qu'on vous dit | Ouvrir | Pourquoi celui-là |
| - | - | - |
| "C'est lent", sans plus de précision | **Accueil**, est-ce que ça va? | Les 4 signaux dorés situent la panne: lente, en erreur, ou saturée. |
| Les erreurs 5xx montent | **Traefik**, point d'entrée | Traefik voit ce que les applications ne mesurent pas. |
| Un correctif poussé dans Git n'arrive pas en production | **GitOps**, ArgoCD et Rollouts | Les livraisons passent-elles, et le cluster correspond-il encore a Git? |
| Plusieurs choses cassent en meme temps, sans lien apparent | **kube-system**, plan de controle | C'est presque toujours l'API, CoreDNS ou etcd. Une panne qui se presente comme dix. |
| Un pod reste en Pending | **Kubernetes**, sante et capacite | La reservation sature avant les machines. L'ordonnanceur bloque sur du reserve, pas sur du consomme. |
| Des timeouts intermittents, aucun service fautif | **Reseau**, trafic et saturation | Un lien sature ou des paquets perdus produisent exactement ce symptome. |
| Une application est lente, la base est soupconnee | **PostgreSQL**, Zalando | Une bonne part des lenteurs applicatives viennent de la base, pas du code. |
| Combien de temps avant que le disque soit plein? | **Stockage**, disques, volumes, PVC, sauvegardes | Le tableau donne des JOURS. Le disque ne se libere jamais seul. |
| Un certificat va-t-il expirer? | **Plateforme**, certificats, secrets, Keycloak | Leur panne ne casse rien le jour ou elle survient, et tout le jour de l'expiration. |
| Faut-il livrer ou reparer? | **SLO**, objectifs et budget d'erreur | Le budget d'erreur tranche a la place des opinions. |
| Ca echoue, on ne sait pas pourquoi | **Erreurs**, classification par famille | Classification par famille technique, puis les logs bruts. |

> [!TIP]
>
> En cas de doute, ouvrez l'**Accueil**. S'il est entierement a zero et en vert, il n'y a rien a faire, et c'est une information a part entiere.

## Le réflexe par défaut

Si vous ne savez pas par ou commencer, ouvrez toujours le dashboard **Accueil**. Il synthetise les 4 signaux dores (latence, trafic, erreurs, saturation) sur l'ensemble des services supervises. Un accueil entierement vert et a zero est lui-meme un diagnostic: la supervision ne detecte rien d'anormal au niveau agrege.

> [!NOTE]
>
> Les 13 dashboards sont organises en 3 niveaux: **Accueil** (vue synthetique), **Diagnostic** (par domaine: Traefik, Kubernetes, PostgreSQL, etc.), et **Detail** (zoom sur une serie temporelle, un pod, ou une requete). Commencez toujours par le niveau le plus haut, et descendez seulement si le symptome persiste.

> [!NOTE]
>
> Tous les dashboards sont provisionnes depuis des fichiers versionnes dans le depot de la stack de supervision. Si un panneau semble manquant ou obsolete, contactez l'equipe DevOps a [**devops@kaeyros-analytics.com**](mailto:devops@kaeyros-analytics.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.