ClickHouse è fuori uso? Stato in tempo reale e segnalazioni di guasti

Informazioni sul servizio e risoluzione dei problemi

Il server ClickHouse non risponde alle query

Se le query si bloccano senza restituire risultati, il primo posto dove guardare è il file config.xml: spesso il problema è un valore troppo basso per max_connections o un timeout configurato male. Controlla anche che la porta 8123 (HTTP) o 9000 (TCP nativo) sia raggiungibile e non bloccata dal firewall. Riavvia il servizio con systemctl restart clickhouse-server e verifica i log in /var/log/clickhouse-server/.

Query lente o che non terminano mai

Le query analitiche pesanti possono andare in timeout o consumare tutta la RAM disponibile. Verifica i parametri max_memory_usage e max_execution_time nel profilo utente. Usa EXPLAIN per analizzare il piano di esecuzione e capire se mancano indici o se la query scansiona troppe parti. Aggiungere un indice di granularità appropriato alla tabella MergeTree riduce spesso i tempi di decine di volte.

Inserimento dati che si blocca o fallisce

• Controlla che il formato dei dati corrisponda esattamente allo schema della tabella: un tipo errato su una colonna blocca l'intero batch.
• Verifica il numero di parti attive con SELECT count() FROM system.parts WHERE active: se supera 300 per tabella, il merge è in ritardo.
• Riduci la frequenza degli insert raggruppando i record in batch da almeno 10.000 righe.
• Controlla i log per errori del tipo Too many parts: significa che i merge non tengono il passo con gli insert.

Interfaccia web Play UI non carica

L'interfaccia integrata risponde sulla porta 8123. Se il browser non la raggiunge, verifica che listen_host nel file di configurazione includa l'indirizzo corretto e non solo 127.0.0.1. Svuota la cache del browser e riprova. Se usi un proxy inverso come nginx, assicurati che i timeout upstream siano impostati ad almeno 300 secondi.

Errore di autenticazione all'accesso

Se ricevi un messaggio di accesso negato, controlla il file users.xml o la configurazione in users.d/. Un errore comune è lasciare la password in chiaro invece di usare l'hash SHA256. Rigenera l'hash con echo -n tua_password | sha256sum e aggiorna la configurazione, poi riavvia il servizio.

Replica tra nodi non sincronizzata

• Controlla lo stato con SELECT * FROM system.replication_queue WHERE is_currently_executing = 1.
• Errori di rete tra i nodi ZooKeeper e ClickHouse causano code bloccate: verifica la connettività sulla porta 2181.
• Se una replica è troppo indietro, usa SYSTEM SYNC REPLICA per forzare il riallineamento.

Disco pieno blocca le scritture

ClickHouse smette di accettare dati quando lo spazio libero scende sotto la soglia configurata in keep_free_space_bytes. Libera spazio eliminando le partizioni vecchie con ALTER TABLE DROP PARTITION oppure configura una policy di storage con TTL automatico per spostare i dati storici su un volume più economico.