ClickHouse est-il en panne ? État en direct et signalements de pannes

Infos sur le service et dépannage

ClickHouse ne démarre pas après installation

L'erreur la plus fréquente au démarrage : le processus clickhouse-server s'arrête immédiatement sans laisser de message clair dans la console. Consultez les journaux dans /​var/​log/​clickhouse-​server/​clickhouse-​server.​err.​log - la cause y est presque toujours indiquée. Les problèmes courants sont un port 9000 ou 8123 déjà occupé par un autre processus, ou des droits insuffisants sur le répertoire de données. Vérifiez les ports avec ss -tlnp et corrigez les permissions avec chown -R clickhouse:clickhouse /var/lib/clickhouse.

Requêtes SQL retournent une erreur de mémoire

Lors de l'exécution de requêtes analytiques lourdes, ClickHouse peut renvoyer une erreur Memory limit exceeded. Augmentez la valeur de max_memory_usage dans le fichier de configuration ou directement dans la session avec SET max_memory_usage = 10000000000. Si la machine manque réellement de RAM, optimisez la requête : réduisez la fenêtre temporelle, ajoutez des filtres sur les colonnes indexées ou utilisez SAMPLE pour travailler sur un sous-ensemble de données.

Connexion refusée sur le port HTTP

Si le client ne parvient pas à joindre l'interface HTTP sur le port 8123, vérifiez que le serveur écoute bien sur l'adresse réseau souhaitée. Par défaut, ClickHouse n'écoute que sur localhost. Pour autoriser les connexions externes, modifiez le paramètre listen_host dans config.xml en remplaçant 127.0.0.1 par 0.0.0.0, puis redémarrez le service.

Les insertions sont lentes ou bloquées

• Vérifiez que vous insérez en lots d'au moins 10 000 lignes : les petites insertions unitaires fragmentent les parts et dégradent fortement les performances.
• Surveillez le nombre de parts actives avec SELECT count() FROM system.parts WHERE active. Un nombre trop élevé indique que les fusions n'ont pas le temps de se faire.
• Réduisez la fréquence d'insertion côté application ou utilisez une file d'attente intermédiaire comme Buffer engine.

Interface web Tabix ne charge pas les données

Tabix ou tout autre client graphique peut afficher un écran vide si la réponse du serveur dépasse le délai configuré. Augmentez le paramètre keep_alive_timeout dans config.xml. Vérifiez également que le serveur répond correctement en testant directement avec curl http://​localhost:​8123/?​query=​SELECT+​1 - si la réponse est 1, le problème vient du client.

Ping élevé lors des requêtes en production

Un temps de réponse anormalement long est souvent lié à un cold cache ou à des lectures sur disque. Activez le cache des marques et des données non compressées dans la configuration. Si le problème persiste, examinez la colonne read_rows dans system.query_log pour identifier les requêtes qui lisent trop de données et affinez les clés de tri de vos tables MergeTree.