Sources de logs

1. Sources de logs #

Lecture de fichiers, journald et récepteurs réseau.

D'où viennent les logs ? #

Lire des fichiers #

local.file_match trouve les fichiers, loki.source.file les lit. Les étiquettes de la cible, ici job, accompagnent chaque ligne ; __path__ désigne le fichier, et devient l'étiquette filename.

local.file_match "app" {
  path_targets = [{ "__path__" = "/var/log/app/*.log", "job" = "app" }]
}

loki.source.file "app" {
  targets    = local.file_match.app.targets
  forward_to = [loki.write.local.receiver]
}

loki.write "local" {
  endpoint {
    url = "http://loki:3100/loki/api/v1/push"
  }
}

Alloy mémorise sa position dans --storage.path : au redémarrage, il reprend là où il s'était arrêté. Si ce dossier n'est pas conservé, tout le fichier est relu, et Loki reçoit des doublons.

Rien n'arrive ? Vérifiez d'abord les droits : l'utilisateur alloy doit pouvoir lire les fichiers. Sur Debian, ajoutez-le au groupe adm pour /var/log.

Le journal systemd #

loki.source.journal "systeme" {
  forward_to = [loki.write.local.receiver]
  labels     = { job = "journal" }
}

loki.write "local" {
  endpoint {
    url = "http://loki:3100/loki/api/v1/push"
  }
}

loki.source.journal peut aussi transformer les champs internes du journal avec relabel_rules, par exemple pour conserver le nom de l'unité.

Vérifier sans Loki #

Pour observer ce que voit Alloy, branchez loki.echo dans forward_to : chaque ligne est écrite dans les journaux d'Alloy, avec ses étiquettes. Nos essais de cette formation se sont appuyés sur ce composant.