Ist ClickHouse ausgefallen? Live-status & störungsmeldungen

Serviceinformationen und Fehlerbehebung

ClickHouse startet nicht nach der Installation

Beim ersten Start meldet ClickHouse oft, dass der Port 9000 oder 8123 bereits belegt ist. Das passiert, wenn ein anderer Prozess diesen Port nutzt. Mit `lsof -i :9000` lässt sich der Konflikt schnell finden. Alternativ kann der Port in der Datei config.xml unter /etc/clickhouse-server/ angepasst werden. Nach Änderungen muss der Dienst neu gestartet werden: `systemctl restart clickhouse-server`.

Verbindung zum Server wird abgelehnt

Wenn der Client keine Verbindung aufbaut, liegt das häufig daran, dass ClickHouse nur auf localhost lauscht. In der config.xml ist der Parameter listen_host standardmäßig auf 127.0.0.1 gesetzt. Für externe Verbindungen muss dieser Wert auf 0.0.0.0 geändert werden. Zusätzlich sollte die Firewall prüfen, ob die Ports 9000 und 8123 freigegeben sind.

Abfragen laufen extrem langsam

• Fehlende Primärschlüssel oder falsch gewählte Sortierspalten in der MergeTree-Tabelle führen zu vollständigen Tabellenscans.
• Zu viele kleine Inserts erzeugen übermäßig viele Parts, was Merge-Operationen verlangsamt.
• Der Parameter max_threads ist möglicherweise zu niedrig gesetzt — hier hilft ein Blick auf die Systemtabelle system.settings.
• FINAL-Modifier bei ReplacingMergeTree-Abfragen kostet erheblich Leistung und sollte nur bei Bedarf verwendet werden.

Daten kommen nicht in Echtzeit an

Wenn Streaming-Daten über Kafka nicht ankommen, sollte zuerst der Status der Kafka Engine-Tabelle in system.tables geprüft werden. Häufige Ursache ist ein falscher Broker-Hostname oder ein nicht erreichbarer Kafka-Port. Die Fehlermeldungen finden sich im Log unter /​var/​log/​clickhouse-​server/​clickhouse-​server.​err.​log.

HTTP-Interface antwortet nicht mehr

Das HTTP-Interface auf Port 8123 kann durch zu viele parallele Anfragen überlastet werden. Der Parameter max_connections in der config.xml begrenzt gleichzeitige Verbindungen. Wer das Interface für externe Dashboards wie Grafana nutzt, sollte außerdem den Parameter keep_alive_timeout erhöhen, damit Verbindungen nicht vorzeitig getrennt werden.

Festplattenspeicher füllt sich unerwartet

• Unkomprimierte Logs in system.query_log wachsen ohne Limit unbegrenzt.
• TTL-Regeln für alte Partitionen sind nicht gesetzt oder werden nicht ausgeführt.
• Temporäre Dateien unter /var/lib/clickhouse/tmp/ können nach abgebrochenen Abfragen übrig bleiben und manuell gelöscht werden.

Benutzeranmeldung schlägt fehl

Wenn der Login mit dem Fehler Authentication failed scheitert, liegt das meistens an einer fehlerhaften Konfiguration in users.xml. Passwörter müssen dort als SHA256-Hash hinterlegt werden, nicht im Klartext. Nach Änderungen an der Benutzerkonfiguration ist ein Neustart des Dienstes erforderlich, damit die neuen Werte geladen werden.