Plugin de source de données ClickHouse pour Grafana

Pour vous connecter à ClickHouse via TCP natif, vous avez besoin des informations suivantes :

Les détails de votre service ClickHouse Cloud sont disponibles dans la console ClickHouse Cloud. Sélectionnez le service auquel vous allez vous connecter, puis cliquez sur Connect :

Choisissez Native ; les détails sont disponibles dans un exemple de commande clickhouse-client.

Si vous utilisez une instance ClickHouse autogérée, les détails de connexion sont définis par votre administrateur ClickHouse.

Lorsque vous connectez ClickHouse à un outil de visualisation de données comme Grafana, il est recommandé de créer un utilisateur en lecture seule afin de protéger vos données contre toute modification indésirable.

Grafana ne vérifie pas que les requêtes sont sûres. Les requêtes peuvent contenir n’importe quelle instruction SQL, y compris DELETE et INSERT.

Pour configurer un utilisateur en lecture seule, suivez ces étapes :

1. Créez un profil utilisateur readonly en suivant le guide Creating Users and Roles in ClickHouse.
2. Assurez-vous que l’utilisateur readonly dispose des permissions nécessaires pour modifier le paramètre max_execution_time requis par le client clickhouse-go sous-jacent.
3. Si vous utilisez une instance ClickHouse publique, il n’est pas recommandé de définir readonly=2 dans le profil readonly. À la place, laissez readonly=1 et définissez le type de contrainte de max_execution_time sur changeable_in_readonly pour autoriser la modification de ce paramètre.

Avant que Grafana puisse se connecter à ClickHouse, vous devez installer le plugin Grafana approprié. En supposant que vous êtes connecté à Grafana, suivez ces étapes :

1. Depuis la page Connections dans la barre latérale, sélectionnez l’onglet Add new connection.

2. Recherchez ClickHouse et cliquez sur le plugin signé de Grafana Labs :

   

3. Sur l’écran suivant, cliquez sur le bouton Install :

   

1. Une fois l’installation terminée, cliquez sur le bouton Add new data source. (Vous pouvez également ajouter une source de données depuis l’onglet Data sources de la page Connections.)

   

2. Faites défiler la page vers le bas pour trouver le type de source de données ClickHouse, ou recherchez-le dans la barre de recherche de la page Add data source. Sélectionnez la source de données ClickHouse et la page suivante s’affichera :

3. Saisissez les paramètres de votre serveur et vos identifiants. Les paramètres clés sont :

• Adresse d’hôte du serveur : le nom d’hôte de votre service ClickHouse.
• Port du serveur : le port de votre service ClickHouse. Il varie selon la configuration du serveur et le protocole.
• Protocol le protocole utilisé pour se connecter à votre service ClickHouse.
• Connexion sécurisée à activer si votre serveur nécessite une connexion sécurisée.
• Username et Password : saisissez les identifiants de votre utilisateur ClickHouse. Si vous n’avez configuré aucun utilisateur, essayez default comme username. Il est recommandé de configurer un utilisateur en lecture seule.

Pour plus de paramètres, consultez la documentation de la configuration du plugin.

4. Cliquez sur le bouton Save & test pour vérifier que Grafana peut se connecter à votre service ClickHouse. Si tout fonctionne, le message Data source is working s’affichera :

   

Votre source de données est maintenant prête à être utilisée ! Découvrez comment créer des requêtes avec le query builder.

Pour plus de détails sur la configuration, consultez la documentation de la configuration du plugin.

Si vous recherchez des informations supplémentaires qui ne figurent pas dans cette documentation, consultez le dépôt du plugin sur GitHub.