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

# Lacunes connues de la supervision Kaeyros

> Liste des lacunes connues de la stack de supervision Kaeyros, avec leur conséquence opérationnelle et l'action corrective à mener. À consulter avant de croire qu'un panneau vide signifie que tout va bien.

Une documentation qui tait ses trous laisse croire que le silence est bon signe. Cette page recense les lacunes actuellement identifiées dans la stack de supervision Kaeyros. Chaque entrée indique ce qui ne fonctionne pas, pourquoi cela limite la visibilité opérationnelle, et quelle action mener pour combler le trou.

## Lacunes actuelles

| Lacune | Conséquence | Action |
| - | - | - |
| **postgres\_exporter non déployé** | 16 panneaux PostgreSQL et 4 panneaux de sauvegarde restent vides. Plus grave : aucune visibilité sur l'archivage WAL, donc aucune réponse à la question « pourrait-on restaurer ? ». | `make pg-exporter A=detecter` |
| **CoreDNS n'expose pas le port 9153** | Aucune cible DNS n'est collectée. Le plan de contrôle perd son signal le plus partagé, celui qui indique si la résolution de noms fonctionne dans le cluster. | Vérifier les ports déclarés par les pods `rke2-coredns` |
| **2 serveurs d'API sur 3 injoignables** | Les métriques du plan de contrôle ne viennent que d'une seule machine. Si celle-ci tombe, la supervision du plan de contrôle devient aveugle. | `nc -vz <ip> 6443` depuis le nœud qui héberge vmagent |
| **etcd n'écoute que sur la boucle locale** | Comportement RKE2 par défaut. Les métriques etcd ne sont pas accessibles depuis l'extérieur du nœud. La latence reste mesurable indirectement via le serveur d'API, qui en est le client. | `etcd-expose-metrics: true` dans `/etc/rancher/rke2/config.yaml` |

> [!WARNING]
>
> **Ne pas confondre « No data » et « tout va bien »**
>
> Certains dashboards affichent « No data » non pas parce que la métrique est à zéro ou que le service est sain, mais parce que la source correspondante n'est tout simplement pas collectée. Avant de conclure qu'un panneau vide est rassurant, croisez avec cette page pour vérifier s'il s'agit d'une lacune connue.

## Conséquence sur la lecture des dashboards

Un panneau vide peut avoir trois origines :

1. **La donnée existe mais vaut zéro** : le panneau affiche généralement `0` ou une courbe plate à la base.
2. **La donnée n'existe pas encore** : le service vient de démarrer, aucune série temporelle n'a été écrite.
3. **La donnée n'est jamais collectée** : c'est le cas des lacunes listées ci-dessus. Le panneau affiche « No data » de façon permanente.

> [!NOTE]
>
> Lors d'une investigation, commencez toujours par vérifier si le panneau vide correspond à une lacune documentée ici. Cela évite de perdre du temps à chercher une panne qui n'existe pas.

## Comment est diagnostiqué un panneau vide

La stack fournit trois commandes pour distinguer une absence de données d'une absence de collecte :

### `make diagnostic`

Liste les panneaux qui n'affichent aucune donnée et précise pour chacun la raison identifiée :

* manque de collecteur (exporter non déployé)
* cible injoignable (firewall, port fermé)
* règle d'appariement qui ne renvoie rien
* absence de journal correspondant au filtre

### `make regles-erreurs`

Identifie les règles d'alerte et les recording rules qui échouent silencieusement. Une règle peut être syntaxiquement valide mais ne jamais produire de résultat si les séries qu'elle tente d'apparier n'existent pas. Cette commande expose les règles en échec sans message d'erreur visible dans l'interface Grafana.

### `make appariement`

Explique les opérations d'appariement de vecteurs qui ne renvoient aucun résultat. C'est l'outil de choix pour comprendre pourquoi une requête PromQL affiche « No data » alors que les séries individuelles existent. Pour plus de détails sur l'utilisation de cette commande, consultez la page [Tâches courantes](https://infra-docs.kaeyros.org/supervision/taches-courantes.md).

> [!TIP]
>
> Si un panneau reste vide après avoir vérifié les trois commandes ci-dessus, contacte l'équipe DevOps à [devops@kaeyros-analytics.com](mailto:devops@kaeyros-analytics.com) avec le nom du dashboard et du panneau concerné.


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