TP : Analyser des logs nginx avec Vector et VRL

Ce que vous allez apprendre dans ce TP

• Écrire une transformation VRL
• Router vers Loki
• Produire des métriques

Introduction #

Ce que vous allez apprendre dans cette section

• Écrire une transformation VRL
• Router vers Loki
• Produire des métriques

Contexte. Le site n'expose aucune métrique HTTP, mais nginx écrit des logs d'accès. Vous en tirez à la fois des logs structurés et des métriques.

Prérequis : Docker Compose  ·  Durée estimée : 45 min

Des logs structurés et des métriques à partir d'un simple fichier.

Mise en place #

Étapes guidées, avec leur correction.

1. 1. Préparer nginx et le trafic

   Pourquoi ? nginx écrit ses logs dans un volume partagé avec Vector.

   Créez un Compose avec nginx (logs dans un volume), un générateur de requêtes (dont des 404) et Loki.

2. 2. Écrire la transformation

   Pourquoi ? VRL extrait les champs et convertit les types : on peut ensuite filtrer et agréger.

   Créez vector.yaml avec une source file et un remap qui analyse le format combined.

3. 3. Lancer et observer

   Pourquoi ? vector tap montre les événements transformés en direct.

   Ajoutez Vector au Compose, démarrez et inspectez la sortie de parse.

4. 4. Dériver des métriques

   Pourquoi ? Compter les requêtes par statut sans toucher à nginx.

   Ajoutez un log_to_metric et un sink prometheus_exporter sur le port 9598, puis lisez les métriques.

5. 5. Vérifier dans Loki

   Pourquoi ? Les champs extraits se filtrent directement en LogQL.

   Affichez les requêtes en 404.

Niveau de difficulté : ●●●○○ (3/5)