diff --git a/HowtoGrafanaAgent.md b/HowtoGrafanaAgent.md index 8fd62b01..13e96b82 100644 --- a/HowtoGrafanaAgent.md +++ b/HowtoGrafanaAgent.md @@ -13,11 +13,56 @@ # systemctl daemon-reload ~~~ + # Configuration -On désactive l'envoi de statistique d'utilisation des composants aux développeurs des Grafana agent en ajouter `--disable-reporting` dans la varible `CUSTOM_ARGS` du fichier `/etc/default/grafana-agent-flow` : +## Configuration de `grafana-agent-flow` + +Par défaut, la configuration de `grafana-agent-flow` est lue à partir du fichier `/etc/grafana-agent-flow.river`. Mais on préfère séparer la configuration par fichiers, on utilise donc le dossier `/etc/grafana-agent-flow/config.d/`. + +~~~(sh) +# mkdir -p /etc/grafana-agent-flow/config.d/ +~~~ + +`grafana-agent-flow run` prend comme seul argument positionnel un fichier de configuration au format River ou bien un dossier contenant des fichiers au format River. Dans le cas d'un dossier, les fichiers `.river` qu'il contient seront [lus par ordre lexical](https://pkg.go.dev/path/filepath#WalkDir) ; c'est dû à l'utilisation de la fonction Golang [`filepath.Walkdir`](https://github.com/grafana/agent/blob/d226a0e7e733dd5a1793a1f39d352457f106e48c/cmd/internal/flowmode/cmd_run.go#L375-L402). + + + +## Configuration du service `grafana-agent-flow.service` + +Le service utilise par défaut le fichier d'environnement (`EnvironmentFile`) `/etc/default/grafana-agent-flow` pour passer des variables d'environnements et des arguments au processus `grafana-agent-flow run`. Afin de les surcharger, on utilise le fichier `/etc/grafana-agent-flow/config.env` avec ce contenu : + +~~~(env) +# +# Command line options for grafana-agent +# + +# Configuration directory, containing lexicaly ordered *.river files, in River +# configuration format. +CONFIG_FILE="/etc/grafana-agent-flow/config.d/" + +# User-defined arguments to pass to the run command: +# - don't send usage statistics to Grafana +CUSTOM_ARGS="--disable-reporting" + +# Restart on system upgrade. Defaults to true. +RESTART_ON_UPGRADE=true +~~~ + +Ces variables d'environnements : + +- désactive l'envoi de statistique d'utilisation des composants aux développeurs des Grafana agent en ajoutant `--disable-reporting` dans la variable d'environnement `CUSTOM_ARGS` +- utilise le dossier `/etc/grafana-agent-flow/config.d/` pour stocker les fichiers de configuration en définissant la variable d'environnement `CONFIG_FILE` + +Pour que `/etc/grafana-agent-flow/config.env` soit utilisé par le service `grafana-agent-flow.service` on le surcharge comme ceci : ~~~(sh) -# grep CUSTOM_ARGS /etc/default/grafana-agent-flow -CUSTOM_ARGS="--disable-reporting" -~~~ \ No newline at end of file +# mkdir /etc/systemd/system/grafana-agent-flow.service.d/ +# cat < /etc/systemd/system/grafana-agent-flow.service.d/override.conf +[Service] +# Override default configuration +EnvironmentFile=/etc/grafana-agent-flow/config.env +EOF +# systemctl daemon-reload +~~~ +