Aller au contenu
Systeme

Chronograf ne démarre pas sous Linux

Avatar illustré de Julien Macé 8 min de lecture
Tux devant un serveur Linux ouvert, avec un module orange entre un port réseau et un disque de stockage.
Illustration générée : diagnostic symbolique d’un service Linux arrêté, entre écoute réseau et stockage. Ce visuel ne représente pas un test de Chronograf.

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.

Tux devant un serveur Linux ouvert, avec un module orange entre un port réseau et un disque de stockage.
Illustration générée : diagnostic symbolique d’un service Linux arrêté, entre écoute réseau et stockage. Ce visuel ne représente pas un test de Chronograf.

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

Avatar illustré de Julien Macé

Julien Macé est administrateur systèmes et réseaux depuis plus de 15 ans. Principalement spécialisé dans Windows, il s’intéresse également aux systèmes Linux. Sur LinuxEnCaja, il vous propose des tutoriels gratuits pour installer, administrer et dépanner vos systèmes Linux.

Partager Facebook X WhatsApp LinkedIn Pinterest Reddit E-mail