Ist ClickHouse ausgefallen? Live-status & störungsmeldungen

Serviceinformationen und Fehlerbehebung

Verbindung zum Server schlägt fehl

Wenn der Client keine Verbindung aufbaut, liegt das meist an einem falschen Port oder einer gesperrten Firewall-Regel. Standardmäßig läuft der HTTP-Interface auf Port 8123, der native TCP-Client auf 9000. Überprüfe, ob der Dienst überhaupt läuft: `systemctl status clickhouse-server`. Prüfe danach die Konfigurationsdatei config.xml auf den richtigen listen_host-Eintrag — oft steht dort nur 127.0.0.1, was externe Verbindungen blockiert.

Abfrage bricht mit Timeout-Fehler ab

Langläufige SELECT-Abfragen scheitern häufig wegen zu niedrig gesetzter Timeouts. Die Parameter max_execution_time und receive_timeout lassen sich direkt in der Session setzen:

• SET max_execution_time = 300;
• SET receive_timeout = 300;
• SET send_timeout = 300;

Für dauerhafte Änderungen trägst du diese Werte in users.xml ein.

Einfügen von Daten schlägt fehl

Bei INSERT-Fehlern lohnt ein Blick auf den Datentyp: ClickHouse ist hier streng. Ein String in eine UInt64-Spalte einzufügen wirft sofort einen Fehler. Prüfe außerdem, ob die Tabelle eine MergeTree-Engine nutzt und ob genug Speicherplatz vorhanden ist — volle Partitionen führen ebenfalls zu Schreibfehlern.

Zu viel Arbeitsspeicher verbraucht

Abfragen auf großen Tabellen können den RAM-Verbrauch explodieren lassen. Mit max_memory_usage lässt sich ein Limit pro Abfrage setzen, z.B. SET max_memory_usage = 10000000000. Nutze außerdem LIMIT und WHERE konsequent, um unnötige Datenmengen zu vermeiden.

Schnittstelle reagiert nicht mehr

• Prüfe mit `top` oder `htop`, ob clickhouse-server die CPU vollständig auslastet.
• Schau in /​var/​log/​clickhouse-​server/​clickhouse-​server.​err.​log nach Hinweisen.
• Ein Neustart des Dienstes hilft bei eingefrorenem Zustand: `systemctl restart clickhouse-server`.

Replikation synchronisiert nicht

Bei replicated-Tabellen kann die Synchronisation hängen, wenn ZooKeeper nicht erreichbar ist. Kontrolliere den ZooKeeper-Status und prüfe in der Systemtabelle system.replication_queue, welche Aufgaben blockiert sind. Veraltete Einträge lassen sich dort manuell löschen.