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/client_journal/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

27 lines
1.1 KiB
Markdown

# client_journal
Intégration cliente **journaux** : expédie le journal système (journald) de la VM
vers `serveur_loki`, via **Grafana Alloy**.
## Rôle
- Ajoute le **dépôt apt Grafana** et installe `alloy`.
- Ajoute l'utilisateur `alloy` au groupe `systemd-journal` (lecture du journal).
- Déploie `/etc/alloy/config.alloy` : `loki.source.journal``loki.write` vers Loki.
## Boucle
VM dans `client_journal` → Alloy lit journald → pousse vers Loki (obs-01) →
visible dans Grafana (datasource Loki).
## Variables
| Variable | Défaut | Rôle |
| --- | --- | --- |
| `client_journal_loki_url` | `http://10.1.14.11:3100/loki/api/v1/push` | Endpoint Loki (obs-01) |
## Notes / limites
- La **syntaxe de configuration Alloy évolue** entre versions ; la config fournie
cible un Alloy récent (`loki.source.journal`, `loki.write`). Ajustement mineur
possible selon la version installée.
- Étiquettes par défaut : `job=systemd-journal`, `host=<inventory_hostname>`.
## Prérequis
- Dépendance `client_journal requiert serveur_loki actif` (déjà dans `docs/dependances-groupes.yml`).