> ## 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 journaux VictoriaLogs et fluent-bit

> fluent-bit collecte les logs des pods et les serveurs, les envoie vers VictoriaLogs où vmalert-logs applique les règles d'alerte.

Les journaux d'applications et système suivent un chemin parallèle aux métriques. Cette page décrit la chaîne de collecte fluent-bit vers VictoriaLogs, le format des logs, les méthodes de requête et les limites actuelles de la plateforme.

## Architecture de la chaîne

```text theme={null}
Pods K8s ──► fluent-bit (DaemonSet) ──► VictoriaLogs
Serveurs ──► fluent-bit (systemd) ─────►     │
                                        vmalert-logs
                                             │
                                        Alertmanager
```

1. **fluent-bit** (DaemonSet dans le cluster, service systemd sur les serveurs) lit les logs à la source
2. **VictoriaLogs** centralise le stockage avec indexation par labels
3. **vmalert-logs** évalue les règles d'alerte sur les logs
4. **Alertmanager** reçoit les alertes de log

## Ce qui est collecté

* **stdout/stderr de tous les conteneurs** : chaque pod du cluster émet ses logs vers fluent-bit via le CRI
* **Journaux systemd (`journald`)** : logs des services système sur les serveurs
* **Logs applicatifs montés en volume** : sur demande, pour les applications qui écrivent dans des fichiers plutôt que stdout

## Format des logs

Chaque ligne de log est enrichie de labels structurés :

| Label | Exemple | Description |
| - | - | - |
| `namespace` | `biolab` | Namespace Kubernetes |
| `pod` | `api-7d9f4b8c5-x2k9m` | Nom du pod |
| `container` | `api` | Nom du conteneur |
| `node` | `hetzner-node-3` | Nœud d'exécution |

## Requêtes LogsQL

Vous pouvez interroger les logs depuis l'UI VictoriaLogs ou depuis Grafana en source de données.

### Exemples de requêtes

```text theme={null}
{namespace="biolab"} error
```

Filtre les logs contenant "error" dans le namespace `biolab`.

```text theme={null}
{namespace="sema", container="api"} | last 5m
```

Logs du conteneur `api` dans le namespace `sema`, limités aux 5 dernières minutes.

```text theme={null}
{namespace=~".*-prod"} status:5xx | last 15m
```

Logs des namespaces se terminant par `-prod` contenant un statut 5xx, sur les 15 dernières minutes.

## Rétention

La politique de rétention des logs est actuellement en cours de définition.

> [!WARNING]
>
> Un état `unhealthy` de VictoriaLogs a été observé récemment. Consultez la page [/operations/chantiers](https://infra-docs.kaeyros.org/operations/chantiers.md) pour le suivi de ce point.

> [!NOTE]
>
> Pour les traces distribuées, il n'y a pas de chaîne dédiée actuellement. Cette capacité est à compléter.


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