2.9 KiB
- Documentation : https://grafana.com/docs/agent/latest/
- Status de cette page : unstable / bulseye
Grafana agent est un collecteur de logs, métriques et traces.
Installation
# wget -q -O /etc/apt/trusted.gpg.d/grafana.asc https://apt.grafana.com/gpg.key
# chmod 644 /etc/apt/trusted.gpg.d/grafana.asc
# echo "deb [signed-by=/etc/apt/trusted.gpg.d/grafana.asc] https://apt.grafana.com stable main" > /etc/apt/sources.list.d/grafana.list
# apt update && apt install grafana-agent-flow
# systemctl daemon-reload
Configuration
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/
.
# 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 ; c'est dû à l'utilisation de la fonction Golang filepath.Walkdir
.
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 :
#
# 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'environnementCUSTOM_ARGS
- utilise le dossier
/etc/grafana-agent-flow/config.d/
pour stocker les fichiers de configuration en définissant la variable d'environnementCONFIG_FILE
Pour que /etc/grafana-agent-flow/config.env
soit utilisé par le service grafana-agent-flow.service
on le surcharge comme ceci :
# mkdir /etc/systemd/system/grafana-agent-flow.service.d/
# cat <<EOF > /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