Plugin de fonte de dados do ClickHouse para o Grafana

Com o Grafana, você pode explorar e compartilhar todos os seus dados por meio de dashboards. O Grafana requer um plugin para se conectar ao ClickHouse, que pode ser instalado facilmente pela UI.

Reúna os detalhes da sua conexão

Para se conectar ao ClickHouse com TCP nativo, você precisa destas informações:

Parâmetros	Descrição
`HOST` e `PORT`	Normalmente, a porta é 9440 ao usar TLS, ou 9000 quando não se usa TLS.
`DATABASE NAME`	Por padrão, há um banco de dados chamado `default`; use o nome do banco de dados ao qual você quer se conectar.
`USERNAME` e `PASSWORD`	Por padrão, o nome de usuário é `default`. Use o nome de usuário apropriado para o seu caso de uso.

Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud. Selecione o serviço ao qual você vai se conectar e clique em Connect:

Escolha Native; os detalhes estarão disponíveis em um comando clickhouse-client de exemplo.

Detalhes da conexão TCP nativa do ClickHouse Cloud

Se você estiver usando ClickHouse autogerenciado, os detalhes da conexão serão definidos pelo administrador do ClickHouse.

Criando um usuário somente leitura

Ao conectar o ClickHouse a uma ferramenta de visualização de dados como o Grafana, recomenda-se criar um usuário somente leitura para proteger seus dados contra modificações indesejadas.O Grafana não valida se as consultas são seguras. As consultas podem conter qualquer instrução SQL, incluindo DELETE e INSERT.Para configurar um usuário somente leitura, siga estas etapas:

Crie um perfil de usuário readonly seguindo o guia Creating Users and Roles in ClickHouse.
Certifique-se de que o usuário readonly tenha permissão suficiente para modificar a configuração max_execution_time exigida pelo cliente clickhouse-go.
Se você estiver usando uma instância pública do ClickHouse, não é recomendável definir readonly=2 no perfil readonly. Em vez disso, mantenha readonly=1 e defina o tipo de constraint de max_execution_time como changeable_in_readonly para permitir a modificação dessa configuração.

Instale o plugin ClickHouse para Grafana

Antes que o Grafana possa se conectar ao ClickHouse, você precisa instalar o plugin apropriado do Grafana. Supondo que você esteja conectado ao Grafana, siga estas etapas:

Na página Connections na barra lateral, selecione a aba Add new connection.
Procure por ClickHouse e clique no plugin assinado pela Grafana Labs:
Na próxima tela, clique no botão Install:

Defina uma fonte de dados do ClickHouse

Quando a instalação for concluída, clique no botão Add new data source. (Você também pode adicionar uma fonte de dados pela aba Data sources na página Connections.)
Role a página para baixo e localize o tipo de fonte de dados ClickHouse ou pesquise por ele na barra de busca da página Add data source. Selecione a fonte de dados ClickHouse e a página a seguir será exibida:

Insira as configurações do servidor e as credenciais. As principais configurações são:

Server host address: o hostname do seu serviço ClickHouse.
Server port: a porta do seu serviço ClickHouse. Ela varia conforme a configuração do servidor e o protocolo.
Protocol o protocolo usado para se conectar ao seu serviço ClickHouse.
Secure connection habilite esta opção se o seu servidor exigir uma conexão segura.
Username e Password: insira as credenciais do seu usuário do ClickHouse. Se você não tiver configurado nenhum usuário, tente default como nome de usuário. Recomendamos configurar um usuário somente leitura.

Para ver mais configurações, consulte a documentação de configuração do plugin.

Clique no botão Save & test para verificar se o Grafana consegue se conectar ao seu serviço ClickHouse. Se a conexão for bem-sucedida, você verá a mensagem Data source is working:

Próximos passos

Sua fonte de dados agora está pronta para uso! Saiba mais sobre como criar consultas com o query builder.Para mais detalhes sobre configuração, consulte a documentação de configuração do plugin.Se você estiver procurando mais informações que não estão incluídas nesta documentação, consulte o repositório do plugin no GitHub.

Atualizando versões do plugin

A partir da v4, configurações e consultas podem ser atualizadas à medida que novas versões são lançadas. Configurações e consultas da v3 são migradas para a v4 conforme são abertas. Embora as configurações e dashboards antigos sejam carregados na v4, a migração não é salva até que sejam salvos novamente na nova versão. Se você notar algum problema ao abrir uma configuração/consulta antiga, descarte suas alterações e relate o problema no GitHub. O plugin não pode voltar para versões anteriores se a configuração/consulta tiver sido criada com uma versão mais recente.

​Atualizando versões do plugin

Atualizando versões do plugin