> ## 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 de métriques VictoriaMetrics chez Kaeyros

> Les métriques du cluster et des serveurs convergent vers VictoriaMetrics via vmagent, avec vmalert pour les règles d'alerte.

Toutes les métriques du cluster Kubernetes et des serveurs d'infrastructure convergent vers **VictoriaMetrics**, hébergé sur le serveur d'outillage interne. Cette page décrit les sources de collecte, le flux de données et les points d'accès pour consulter et exploiter ces métriques.

## Sources de métriques

### Dans le cluster Kubernetes

| Source | Type | Données collectées |
| - | - | - |
| `node-exporter` (DaemonSet) | Exporter Prometheus | CPU, mémoire, disque, réseau des 4 nœuds |
| `kube-state-metrics` | Exporter Prometheus | État des objets K8s : Deployments, Pods, PVC, Services |
| `cadvisor` (intégré au kubelet) | Agent intégré | Métriques des conteneurs : CPU, mémoire, I/O |
| Métriques applicatives | Endpoints `/metrics` | Métriques métier exposées par les applications |

### Sur les serveurs hors cluster

| Source | Données collectées |
| - | - |
| `node-exporter` local | Métriques OS des serveurs Hetzner |
| `cadvisor` pour Docker | Métriques des conteneurs Docker sur les serveurs d'outillage |

## Flux de données

```text theme={null}
Sources ──► vmagent ──► ingest.kaeyros.org (vmauth) ──► VictoriaMetrics
                                                            │
                                                        vmalert
                                                            │
                                                       Alertmanager
```

1. **vmagent** collecte les métriques via scraping HTTP ou réception push
2. **vmauth** (ingest.kaeyros.org) authentifie et route vers VictoriaMetrics
3. **VictoriaMetrics** stocke les séries temporelles
4. **vmalert** évalue les règles d'alerte et d'enregistrement
5. **Alertmanager** reçoit les alertes déclenchées

## Points d'accès

| URL | Rôle |
| - | - |
| [metrics.kaeyros.org](https://metrics.kaeyros.org) | UI VictoriaMetrics (exploration, requêtes MetricsQL) |
| [ingest.kaeyros.org](https://ingest.kaeyros.org) | Point d'entrée vmauth pour l'ingestion |
| [grafana.kaeyros.org](https://grafana.kaeyros.org) | Tableaux de bord et visualisation |

> [!TIP]
>
> Pour ajouter les métriques d'une nouvelle application : exposez un endpoint `/metrics` au format Prometheus, puis ajoutez les annotations suivantes sur le Service :
>
> ```yaml theme={null}
> prometheus.io/scrape: "true"
> prometheus.io/port: "8080"
> ```
>
> Remplacez `8080` par le port réel de votre endpoint `/metrics`.


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