This repository has been archived on 2026-06-26. You can view files and clone it, but cannot push or open issues or pull requests.
Set-OPS/roles/serveur_loki/README.md
Daniel Allaire ca0f95da28 Mettre les noms de roles et playbooks au singulier
serveurs_* -> serveur_, clients_ -> client_, suffixes pluriels au
singulier (serveur_web_dorsal/frontal, client_metrique, client_journal).

Renommage par tokens exacts : repertoires de roles, playbooks de groupes,
group_vars, variables internes des roles (serveur_nginx_*, conformite
ansible-lint), groupes du plan, constantes de code, docs. Faux-amis
preserves (serveurs_bd, scripts/serveurs.py, fonctions Python). Groupes
d'etat gardes au pluriel (hotes_actifs/planifies, modeles_vm).

Valide : ansible-lint 0 echec (0 var-naming), diff vide de la generation,
node --check, tous les registres. Ajout de .ansible-lint excluant docs/
(registres de donnees, pas du contenu Ansible).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-23 23:18:52 -04:00

30 lines
1.2 KiB
Markdown

# serveur_loki
Agrégation de journaux **Loki** (dépôt apt officiel Grafana), plateforme d'observabilité.
## Rôle
- Ajoute le **dépôt apt Grafana** (clé + source) et installe `loki`.
- Déploie une configuration **single-node** (stockage `filesystem`, schéma TSDB v13).
- Rétention via le compactor (`retention_enabled`, `retention_period`).
- Écoute sur `:3100`.
## Variables principales
| Variable | Défaut | Rôle |
| --- | --- | --- |
| `serveur_loki_port` | `3100` | Port HTTP |
| `serveur_loki_chemin` | `/var/lib/loki` | Stockage local |
| `serveur_loki_retention` | `744h` (31 j) | Rétention des journaux |
## Intégration
- Côté VM : l'expédition des journaux (promtail / Grafana Alloy) sera gérée par le
futur rôle `client_journal`.
- `serveur_grafana` consommera Loki comme datasource.
## Notes / limites
- Le format de configuration Loki **évolue entre versions** ; la config fournie cible
un Loki récent (TSDB v13, single-node). Un ajustement mineur peut être requis selon
la version installée par le dépôt.
- Le chemin du fichier de config (`/etc/loki/config.yml`) suit le paquet Debian Grafana.
## Hors périmètre
- Mode distribué/microservices, stockage objet (S3), alerting Loki.