Quand Chronograf ne reste pas lancé après un redémarrage, ou que son adresse ne répond plus, évitez de le relancer tout de suite depuis un terminal root. Une seconde instance peut utiliser une autre base BoltDB ou entrer en conflit avec le service déjà présent. Commencez par identifier l’unité, le processus et les chemins réellement utilisés.
Voici comment lire l’échec de Chronograf sous Linux, vérifier son écoute et contrôler l’accès à son stockage sans modifier le serveur. Les commandes ci-dessous sont des exemples en lecture seule ; leurs sorties sont hypothétiques et doivent être comparées à votre installation.

Identifier l’unité et lire l’échec de Chronograf
Les paquets DEB/RPM officiels prévoient une unité systemd nommée chronograf.service. Une archive, une compilation, un conteneur ou une unité personnalisée peut suivre un autre chemin. Si systemd ne connaît pas cette unité, retrouvez d’abord le mode d’installation au lieu de créer ou d’installer un service au hasard.
systemctl status chronograf.service --no-pager -l
systemctl show chronograf.service -p LoadState -p ActiveState -p SubState -p Result -p ExecMainStatus -p NRestarts
Une sortie possible de status contient Loaded, Active, un PID éventuel et quelques lignes de journal. show renvoie des paires telles que ActiveState=failed ou ExecMainStatus=1. Ces valeurs sont des exemples, pas le résultat d’un contrôle effectué sur votre machine. inactive ne signifie pas forcément panne, et failed ne donne pas à lui seul la cause.
Pour consulter les messages de l’unité pendant le démarrage courant :
sudo journalctl -u chronograf.service -b -n 100 --no-pager -o short-iso
Si l’incident date d’un démarrage précédent, retirez -b :
sudo journalctl -u chronograf.service -n 100 --no-pager -o short-iso
Repérez la première erreur, puis les messages qui la suivent. Un journal vide ne prouve pas que Chronograf a démarré : l’unité peut être différente, les journaux anciens peuvent avoir été purgés ou votre compte peut ne pas pouvoir les lire. Pour une méthode générale sur systemd, consultez le diagnostic d’un service en échec. Pour filtrer les messages du démarrage, le guide journalctl et le dernier démarrage Linux couvre cette étape.
Retrouver les options réellement utilisées par le service
L’unité et ses éventuelles surcharges indiquent quel programme systemd lance, sous quel compte et depuis quel répertoire. Elles peuvent aussi référencer un fichier d’environnement.
systemctl cat chronograf.service --no-pager
systemctl show chronograf.service -p FragmentPath -p DropInPaths -p ExecStart -p User -p Group -p WorkingDirectory -p EnvironmentFiles -p Requires -p Wants -p After
cat affiche l’unité et ses drop-ins. show expose les propriétés retenues par systemd. Une sortie possible comprend un ExecStart avec le chemin du binaire et des options, un WorkingDirectory et un EnvironmentFiles pointant vers un fichier. Les valeurs exactes varient selon l’installation.
Les paquets officiels décrivent /etc/default/chronograf comme un fichier de paires clé-valeur. Ne supposez pas qu’il existe ou qu’il soit chargé avec une archive, un conteneur ou une unité personnalisée. EnvironmentFiles confirme une référence déclarée, pas le contenu finalement utilisé ; les options de ligne de commande peuvent aussi prendre priorité sur les variables correspondantes.
Attention : l’unité ou ExecStart peut contenir des identifiants. Gardez ces sorties sur la machine et masquez les secrets avant de partager un extrait. Ne demandez pas l’environnement complet du processus et ne copiez pas de jetons dans un ticket.
Une fois le chemin du binaire relevé dans ExecStart, utilisez ce chemin précis pour demander sa version et ses options :
/chemin/reel/vers/chronograf --version
/chemin/reel/vers/chronograf --help
Remplacez /chemin/reel/vers/chronograf par le chemin effectivement affiché par votre unité ; cette notation n’est pas une commande à copier telle quelle. Si ExecStart appelle un wrapper, identifiez le binaire invoqué avant de le questionner. Une sortie possible affiche une version et l’aide disponible. Ces commandes ne valident pas la configuration et ne doivent pas être remplacées par un lancement de Chronograf sans ses paramètres de service.
La documentation répertorie notamment --host, --port et --bolt-path. Elle donne 8888 comme port par défaut des connexions non chiffrées et ./chronograf-v1.db comme chemin par défaut de BoltDB pour l’option CLI. Un chemin relatif dépend du répertoire de travail ; ne déduisez donc pas le chemin de la base à partir d’un exemple générique. La page de configuration montre aussi une commande systemctl start suivie d’options applicatives : ne la reprenez pas, ces options ne sont pas des arguments valides de systemctl.
Vérifier qui écoute sur le port attendu
Le port configuré peut différer de 8888. Relevez d’abord le port effectif dans l’unité et les paramètres chargés, puis inspectez cette écoute. Exemple pour le défaut documenté :
sudo ss -ltnp '( sport = :8888 )'
Une sortie possible comporte une ligne LISTEN, une adresse et, si les permissions le permettent, un PID et un nom de processus. Aucune ligne signifie seulement qu’aucune écoute TCP n’a été trouvée sur ce port, dans cet espace réseau et à cet instant. Dans un conteneur, l’hôte et le conteneur n’ont pas nécessairement le même contexte réseau.
Si un autre PID occupe le port, identifiez le service avant toute intervention. Il peut s’agir d’une application légitime ; ne l’arrêtez pas pour libérer le port. Le guide identifier un processus en écoute avec ss explique aussi la différence entre une écoute locale et une exposition réseau.
Quand l’adresse et le protocole effectifs sont connus, un GET local permet de voir si un serveur HTTP répond. Exemple seulement si le service utilise réellement HTTP sur 127.0.0.1:8888 :
curl --noproxy '*' --connect-timeout 3 --max-time 5 -sS -o /dev/null -w 'HTTP %{http_code}\n' http://127.0.0.1:8888/
Une sortie hypothétique HTTP 200, HTTP 302, HTTP 401 ou HTTP 403 confirme une réponse HTTP, avec un sens différent pour chaque code. Elle ne prouve ni que Chronograf a répondu, ni que l’interface fonctionne entièrement, ni que la connexion à InfluxDB est établie. HTTP 000 ou une erreur curl indique qu’aucune réponse HTTP n’a été obtenue dans ces conditions ; rapprochez le résultat de ss, de l’adresse et du journal.
Adaptez l’URL au port, à l’adresse, au HTTPS et au chemin de base réellement configurés. N’utilisez pas 0.0.0.0 comme adresse de destination et ne contournez pas TLS avec -k. Le fait que Chronograf documente 0.0.0.0 comme valeur par défaut de --host ne justifie pas d’exposer son interface sur le réseau. Même un GET peut être inscrit dans les journaux du serveur.
Si le service répond normalement, vous êtes sorti du diagnostic de démarrage. Une connexion InfluxDB défaillante relève alors d’un autre contrôle ; Kapacitor est optionnel selon la documentation d’installation. Une réponse HTTP ne prouve pas non plus le bon affichage de l’interface, sujet distinct du présent diagnostic.
Contrôler le stockage et les dépendances signalées
Le stockage de Chronograf contient notamment des configurations et des tableaux de bord. Avant d’examiner ses droits, retrouvez --bolt-path ou BOLT_PATH dans les options réellement appliquées. Si le chemin est relatif, combinez-le avec le répertoire de travail effectif. Ne supposez pas que la base se trouve toujours sous /var/lib/chronograf/.
Une fois le chemin réel repéré, affectez-le localement à une variable shell BOLT_DB, puis vérifiez le fichier et son répertoire parent. Remplacez la valeur d’exemple par le chemin constaté :
BOLT_DB='/chemin/reel/vers/chronograf-v1.db'
namei -l "$BOLT_DB"
stat -c '%A %a %U:%G %n' "$BOLT_DB" "$(dirname "$BOLT_DB")"
findmnt -T "$(dirname "$BOLT_DB")" -o TARGET,SOURCE,FSTYPE,OPTIONS
df -h "$(dirname "$BOLT_DB")"
df -i "$(dirname "$BOLT_DB")"
namei détaille les droits de chaque composant du chemin. stat affiche ceux du fichier et du parent ; s’il manque, examinez le répertoire sans créer la base manuellement. findmnt indique le montage et ses options. df affiche l’espace disponible, puis les inodes. Les sorties attendues sont des métadonnées locales, pas une valeur universelle à atteindre.
Comparez ces informations avec le compte User réellement défini dans l’unité. Un champ vide ne prouve pas que le service tourne sous un compte nommé chronograf. Les bits Unix ne suffisent pas toujours : ACL, SELinux, AppArmor ou le confinement systemd peuvent aussi refuser l’accès. Si le journal contient encore permission denied, examinez la politique correspondante sans la désactiver.
Ne supprimez pas chronograf-v1.db pour « repartir de zéro ». Vous pourriez perdre les configurations et tableaux de bord. Ne lancez pas non plus une deuxième instance à la main sous root : elle peut créer une base dans un autre répertoire, avec un mauvais propriétaire, ou entrer en conflit avec le port déjà utilisé.
Pour les dépendances, partez des propriétés Requires, Wants et After, puis des messages de l’unité. After fixe un ordre de démarrage ; seul, il ne rend pas une dépendance obligatoire. Vérifiez etcd uniquement si l’unité ou la configuration l’utilise. Une connexion InfluxDB distante qui échoue n’empêche pas nécessairement le processus Chronograf de démarrer.
Relier le message à une correction ciblée
Ces contrôles servent à documenter l’incident, pas à appliquer une réparation automatique. Voici comment relier quelques messages fréquents aux preuves à transmettre pour revue :
| Message ou symptôme | Preuve à relever | Intervention à faire examiner |
|---|---|---|
address already in use |
Port et PID associés avec ss, unité du processus occupant le port |
Choix du port ou conflit de service, sans arrêter le processus tiers |
permission denied |
Compte systemd, chemin complet, droits, montage et politique de sécurité concernée | Droits ciblés ou règle de confinement, sans changement récursif |
| Fichier BoltDB absent ou inaccessible | Option effective, répertoire de travail et existence du parent | Chemin de stockage et procédure de restauration adaptée |
| Option inconnue | Version, aide du binaire exact et paramètres de lancement | Compatibilité de l’option avec cette version |
| Échec ou délai sur une dépendance | Dépendances déclarées et message précis du journal | Composant réellement configuré et ordre requis |
Une correction de propriétaire ou de droits, une restauration BoltDB, une modification d’unité, d’adresse, de port, de certificat ou de dépendance demande une sauvegarde adaptée, un périmètre clair et un retour arrière revu. Un redémarrage sur un service critique nécessite aussi une validation indépendante. N’appliquez pas de chmod ou chown récursif, ne tuez pas le PID qui écoute et n’ouvrez pas le port au pare-feu sur la seule base d’un message d’erreur. Une ouverture de 8888 peut exposer une interface d’administration ; une modification des droits peut rendre des secrets lisibles.
Le contrôle s’arrête au processus et à son écoute : attribuez le PID à la bonne unité, puis confirmez une réponse HTTP cohérente avec l’adresse et le protocole configurés. Cela ne démontre pas que Chronograf communique correctement avec InfluxDB.
Sources
- Configure Chronograf, documentation officielle InfluxData.
- Chronograf configuration options, options CLI, variables d’environnement, écoute et stockage.
- Install Chronograf, datastore et dépendances facultatives.
- Diagnostiquer un service systemd en échec, lien interne vérifié dans le brief.
- Identifier un processus en écoute avec ss, lien interne vérifié dans le brief.
- Filtrer le journal du dernier démarrage Linux, lien interne vérifié dans le brief.