Discovery

1. Discovery #

Auto-détection des cibles via Kubernetes, Consul ou fichiers statiques.

Trouver les cibles automatiquement #

Dans un environnement moderne, les cibles apparaissent et disparaissent sans prévenir. Plutôt que de lister des adresses, on confie cette tâche aux composants discovery.*, qui publient une liste de cibles dans targets.

Qu'est-ce qu'une cible ? #

Une cible est un simple objet d'étiquettes. __address__ donne l'adresse. Les étiquettes commençant par __ sont internes : elles servent au relabeling, puis disparaissent avant le stockage. Vous pouvez les lire dans l'interface, sur la page du composant.

Exemple avec un fichier #

Une équipe décrit ses cibles dans un fichier, sans toucher à la configuration d'Alloy :

[
  {
    "targets": ["app-1:8080", "app-2:8080"],
    "labels": { "equipe": "plateforme", "env": "prod" }
  }
]

discovery.file "applis" {
  files            = ["/etc/alloy/cibles/*.json"]
  refresh_interval = "30s"
}

discovery.relabel "applis" {
  targets = discovery.file.applis.targets

  rule {
    source_labels = ["env"]
    regex         = "dev"
    action        = "drop"
  }

  rule {
    target_label = "cluster"
    replacement  = "paris"
  }
}

Résultat observé dans l'interface d'Alloy, pour chaque cible : __address__, env=lab, equipe=plateforme et cluster=paris. Les cibles de dev sont écartées.

action = "drop" écarte ce qui correspond, "keep" ne garde que cela. Une règle sans action remplace : elle écrit replacement dans target_label.

Exemple sur Kubernetes #

On ne garde que les pods annotés, et on transforme les métadonnées internes en étiquettes durables :

discovery.kubernetes "pods" {
  role = "pod"
}

discovery.relabel "annotes" {
  targets = discovery.kubernetes.pods.targets

  rule {
    source_labels = ["__meta_kubernetes_pod_annotation_prometheus_io_scrape"]
    regex         = "true"
    action        = "keep"
  }

  rule {
    source_labels = ["__meta_kubernetes_namespace"]
    target_label  = "namespace"
  }

  rule {
    source_labels = ["__meta_kubernetes_pod_name"]
    target_label  = "pod"
  }
}

Piège : sans règle explicite, les étiquettes __meta_* disparaissent. Si vous voulez namespace et pod dans vos métriques, il faut les copier, comme ci-dessus.