Expédition

3. Expédition vers Loki #

Envoi sécurisé vers Grafana Loki.

Le composant loki.write #

loki.write "central" {
  external_labels = { cluster = "paris" }

  endpoint {
    url       = "https://loki.example.com/loki/api/v1/push"
    tenant_id = "equipe-paiement"

    batch_size = "1MiB"
    batch_wait = "1s"

    max_backoff_retries = 10
    max_backoff_period  = "5m"

    basic_auth {
      username = sys.env("LOKI_USER")
      password = sys.env("LOKI_PASSWORD")
    }
  }
}

Que se passe-t-il pendant une panne ? #

Alloy retente avec un délai croissant. Une fois les tentatives épuisées, le lot est perdu et loki_write_dropped_entries_total augmente. Pour vos logs de fichiers, la position protège ce qui n'a pas encore été lu ; pour le reste, prévoyez le risque.

# Lignes perdues après épuisement des nouvelles tentatives (à alerter)
rate(loki_write_dropped_entries_total[5m]) > 0

# Lignes envoyées, nouvelles tentatives
rate(loki_write_sent_entries_total[5m])
rate(loki_write_batch_retries_total[5m])

Plusieurs destinations #

Comme pour les métriques, forward_to accepte plusieurs récepteurs : un loki.write pour le stockage courant, un autre pour l'audit, avec une rétention plus longue côté serveur. Les external_labels s'ajoutent à l'envoi : réservez-les à ce qui identifie le site, comme cluster.

Vérifier l'arrivée #

Nous avons vérifié l'envoi directement dans Loki :

curl -s http://localhost:3100/loki/api/v1/labels
curl -s -G http://localhost:3100/loki/api/v1/query_range \
  --data-urlencode 'query={job="app"}' \
  --data-urlencode "start=$(( $(date +%s)-600 ))000000000"

Bonne pratique : gardez peu d'étiquettes, à faible nombre de valeurs. job, env, level et service couvrent la plupart des besoins ; le reste se cherche dans le texte, au moment de la requête.