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

# Chaîne d'observabilité : métriques, journaux et alertes

> Parcours des métriques et journaux depuis le cluster jusqu'à VictoriaMetrics, vmalert, Alertmanager et les notifications.

La plateforme Kaeyros collecte les métriques et les journaux depuis le cluster Kubernetes et le serveur d'outillage, les centralise dans VictoriaMetrics et VictoriaLogs, puis déclenche des alertes via Alertmanager. Cette page décrit le parcours complet des données d'observabilité.

## Schéma de la chaîne de métriques

```text theme={null}
Cluster Kubernetes
  ├── node-exporter x4
  ├── kube-state-metrics
  └── fluent-bit x4
        │
        ▼
      vmagent
        │
        ▼
    ingest.kaeyros.org (vmauth)
        │
        ▼
    VictoriaMetrics (metrics.kaeyros.org)
        │
        ▼
      vmalert
        │
        ▼
    Alertmanager (alertmanager.kaeyros.org)
        │
        ▼
    alert-bridge (alerts.kaeyros.org)
        │
        ├──► ntfy (ntfy.kaeyros.org)
        └──► WhatsApp (via WAHA, waha.kaeyros.org)

Serveur d'outillage
  ├── cadvisor
  └── node-exporter
        │
        ▼
      vmagent local
        │
        ▼
    ingest.kaeyros.org (même chaîne VictoriaMetrics)
```

## Chaîne des journaux

Les journaux suivent un chemin parallèle :

1. **Collecte** : `fluent-bit` (x4 dans le cluster) récupère les logs des conteneurs.
2. **Stockage** : `VictoriaLogs` centralise et indexe les journaux.
3. **Alertes** : `vmalert-logs` évalue les règles d'alerte sur les logs.

## Points d'accès

| Composant | URL | Rôle |
| - | - | - |
| VictoriaMetrics | `metrics.kaeyros.org` | Stockage et requêtage des séries temporelles |
| vmauth / ingest | `ingest.kaeyros.org` | Point d'entrée authentifié pour les agents de collecte |
| Grafana | `grafana.kaeyros.org` | Visualisation des métriques et dashboards |
| Alertmanager | `alertmanager.kaeyros.org` | Gestion et silencing des alertes |
| alert-bridge | `alerts.kaeyros.org` | Passerelle de notification |
| ntfy | `ntfy.kaeyros.org` | Notifications push |
| WAHA | `waha.kaeyros.org` | Passerelle WhatsApp |

> [!TIP]
>
> Pour consulter les métriques en temps réel ou créer un dashboard personnalisé, connectez-vous à Grafana. Pour vérifier si une alerte est active ou la silencer, utilisez Alertmanager.


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