Les blocs de configuration

1. Les blocs de configuration #

Attributs, blocs et expressions en langage River.

L'anatomie d'un bloc #

// nom du composant : prometheus.scrape     étiquette : "app"
prometheus.scrape "app" {
  // attribut : une valeur
  scrape_interval = "30s"

  // référence à un export d'un autre composant
  targets    = discovery.relabel.pods.output
  forward_to = [prometheus.remote_write.mimir.receiver]

  // sous-bloc : un réglage structuré
  basic_auth {
    username = "collecte"
    password = sys.env("SCRAPE_PASSWORD")
  }
}

discovery.relabel "pods" {
  targets = []
}

prometheus.remote_write "mimir" {
  endpoint {
    url = "http://mimir:9009/api/v1/push"
  }
}

Attribut ou sous-bloc ? #

La documentation de chaque composant le précise, et l'erreur est fréquente : endpoint = { … } échoue, car endpoint est un bloc. targets est au contraire un attribut, qui attend un tableau d'objets.

Blocs de configuration générale #

Quelques blocs ne sont pas des composants : ils n'ont pas d'étiquette, et règlent Alloy lui-même.

logging {
  level  = "info"
  format = "logfmt"
}

livedebugging {
  enabled = true
}

livedebugging active l'observation des données en direct dans l'interface. Pensez à le désactiver hors des phases de diagnostic.

Les virgules #

Dans un tableau ou un objet sur plusieurs lignes, ajoutez une virgule après le dernier élément : Alloy l'accepte, et vos ajouts futurs ne modifient qu'une ligne dans Git. alloy fmt aligne ensuite le tout.

Les chaînes littérales #

Les expressions contenant des guillemets, comme les requêtes OTTL, sont plus lisibles entre accents graves : rien n'y est à échapper.

otelcol.processor.transform "noms" {
  error_mode = "ignore"
  trace_statements {
    context    = "span"
    statements = [
      `set(name, "GET /produits/{id}") where IsMatch(name, "^GET /produits/[0-9]+$")`,
    ]
  }
  output {
    traces = []
  }
}

Commandes utiles : alloy fmt -w config.alloy pour formater, alloy validate config.alloy pour vérifier sans lancer.