Consultando o banco de dados `system` do ClickHouse

Monitore o ClickHouse Cloud consultando diretamente as tabelas de sistema

Todas as instâncias do ClickHouse incluem um conjunto de tabelas de sistema no banco de dados system, que contêm informações sobre:

• Estados, processos e ambiente do servidor.
• Processos internos do servidor.
• Opções usadas quando o binário do ClickHouse foi compilado.

Consultar essas tabelas diretamente é útil para monitorar implantações do ClickHouse, especialmente para introspecção detalhada e depuração.

​

Usando o Console do ClickHouse Cloud

O console do ClickHouse Cloud vem com um Console SQL e ferramentas de dashboards para consultar tabelas de sistema. Por exemplo, a consulta abaixo mostra quantas novas partes são criadas (e com que frequência) nas últimas duas horas:

SELECT
    count() AS new_parts,
    toStartOfMinute(event_time) AS modification_time_m,
    table,
    sum(rows) AS total_written_rows,
    formatReadableSize(sum(size_in_bytes)) AS total_bytes_on_disk
FROM clusterAllReplicas(default, system.part_log)
WHERE (event_type = 'NewPart') AND (event_time > (now() - toIntervalHour(2)))
GROUP BY
    modification_time_m,
    table
ORDER BY
    modification_time_m ASC,
    table DESC

Mais consultas de exemplo

Para outras consultas de monitoramento, veja os recursos a seguir:

• Consultas úteis para solução de problemas
• Monitoramento e solução de problemas de consultas de insert
• Monitoramento e solução de problemas de consultas de select

Você também pode usar essas consultas para criar um dashboard personalizado no Cloud Console.

​

Dashboard avançado de observabilidade integrado

O ClickHouse inclui um recurso integrado de dashboard avançado de observabilidade, que pode ser acessado em $HOST:$PORT/dashboard (requer usuário e senha) e mostra as métricas do Cloud Overview contidas em system.dashboards.

Este painel requer autenticação direta na instância do ClickHouse e é separado do Cloud Console Dashboard avançado, que pode ser acessado pela UI do Cloud Console sem autenticação adicional.

Para mais informações sobre as visualizações disponíveis e como usá-las para solucionar problemas, consulte a documentação do dashboard avançado.

​

Consultando em diferentes nós e versões

Para ter uma visão completa de todo o cluster, os usuários podem usar a função clusterAllReplicas em conjunto com a função merge. A função clusterAllReplicas permite consultar tabelas de sistema em todas as réplicas do cluster “default”, consolidando os dados específicos de cada nó em um resultado unificado. Em conjunto com a função merge, isso pode ser usado para consultar todos os dados de sistema de uma tabela específica em um cluster.

Por exemplo, para encontrar as 5 consultas com maior tempo de execução em todas as réplicas na última hora:

SELECT
    type,
    event_time,
    query_duration_ms,
    query,
    read_rows,
    tables
FROM clusterAllReplicas(default, system.query_log)
WHERE event_time >= (now() - toIntervalMinute(60)) AND type = 'QueryFinish'
ORDER BY query_duration_ms DESC
LIMIT 5
FORMAT VERTICAL

Essa abordagem é particularmente valiosa para o monitoramento e a depuração de operações em todo o cluster, garantindo que os usuários possam analisar com eficácia a integridade e o desempenho da implantação do ClickHouse Cloud.

Para mais detalhes, consulte consultas em todos os nós.

​

Considerações sobre o sistema

Consultar tabelas de sistema diretamente aumenta a carga de consultas no seu serviço de produção, impede que instâncias do ClickHouse Cloud entrem em modo ocioso (o que pode impactar os custos) e vincula a disponibilidade do monitoramento à saúde do sistema de produção. Se o sistema de produção falhar, o monitoramento também poderá ser afetado.

Para monitoramento de produção em tempo real com separação operacional, considere usar o endpoint de métricas compatível com Prometheus ou os dashboards do Cloud Console, que usam métricas já coletadas e não emitem consultas para o serviço subjacente.

​

Páginas relacionadas

• Referência das tabelas de sistema — Referência completa de todas as tabelas de sistema disponíveis
• Monitoramento no Cloud Console — Dashboards sem configuração que não afetam o desempenho do serviço
• Endpoint Prometheus — Exporte métricas para ferramentas externas de monitoramento
• Dashboard avançado — Referência detalhada das visualizações do dashboard