1. L'astreinte à deux #
Un ingénieur et un agent.
Le principe #
Disponible dans : ✓ Open source ✓ ClickHouse Cloud MCP : open source et cloud ; notebooks et agents : ClickHouse Cloud
ClickHouse résume sa vision ainsi : « la prochaine astreinte se fera à deux, un ingénieur et un agent ». Trois fonctions sont pensées pour l'agent d'astreinte, chacune avec un niveau de maturité différent.
| Fonction | Statut | Ce qu'elle change |
|---|---|---|
| Serveur MCP ClickStack | open source et cloud | l'agent enquête avec des outils de SRE (patterns, traces, recherches), pas avec du SQL brut : il ne devine plus le schéma |
| AI Notebooks | bêta publique | l'IA mène l'enquête dans l'interface, étape par étape, requêtes et graphiques visibles : on vérifie son raisonnement puis on partage |
| Observability Apps | préversion privée | on décrit l'écran voulu, il est généré sur ses données : un tableau de bord sur mesure par incident |
À savoir : ClickHouse annonce, face à un serveur MCP ClickHouse générique, 17 % de précision en plus, 25 % d'appels d'outils en moins et une constance 2,7 fois meilleure. Ce sont des mesures de l'éditeur.
2. AI Notebooks #
Une enquête écrite en blocs.
Mettre en œuvre #
- Vérifiez que l'IA est activée : Team Settings › API & Agents (« Generative AI features are enabled »).
- AI notebooks › New Shared Notebook (visible par l'équipe) ou New Private Notebook.
- Posez une question précise, avec la plage horaire en UTC : « Pourquoi POST /v1/payments a-t-il échoué entre 13h58 et 14h45 UTC ? Quelle version, quels pods ? »
- Lisez les blocs : l'agent cherche dans les logs, ouvre des traces, compare les versions ; chaque bloc (recherche, graphique, tableau, note) se modifie.
- Comparez sa conclusion à la vôtre avant de la partager.
3. Le serveur MCP de ClickStack #
Vos outils d'IA, sur vos données, avec vos droits.
Connecter un client MCP #
- Team Settings › API & Agents › Connect your AI agents : activez le serveur MCP distant.
- Copiez la commande de votre outil (un onglet par outil : Claude Code, Cursor, VS Code, Codex CLI…).
- Au premier appel, le navigateur s'ouvre : authentification OAuth, sans clé d'API à stocker.
- Demandez par exemple : « trouve les event patterns des erreurs de paiement et ouvre la trace la plus lente ».
claude mcp add clickstack --transport http https://mcp.clickhouse.cloud/clickstack --header "x-service-id: <id du service>"Bonne Pratique : Le même onglet propose Export to Terraform : dashboards, alertes, recherches et sources téléchargés sous forme de code, à versionner.
4. ClickHouse Agents #
Un assistant SRE sur vos tables.
Créer un assistant SRE #
- Documentez les tables avec
COMMENTsur chaque table et colonne : c'est la première chose que lit l'agent. - ClickHouse agents › Create New Agent, avec trois outils : ClickHouse (requêtes), Artifacts (graphiques), Run Code (Python).
- Donnez des instructions : heures en UTC, privilégier les agrégats, toujours un filtre sur
Timestampet unLIMIT. - Posez des questions métier (« combien l'incident a-t-il coûté ? ») ou demandez un tableau de bord (taux d'erreur, p99, burn rate) ; Run Code permet même une détection d'anomalies (Isolation Forest).
Attention : « L'IA suggère, nous mesurons et validons » : une conclusion d'agent est une hypothèse à vérifier dans les données, jamais une décision automatique en production.
5. Gouvernance #
Qui a le droit de voir quoi.
Deux niveaux de droits #
- RBAC de ClickStack : Team Settings › Members & Roles › Add Role, No Access, Read ou Manage par ressource, avec des règles fines sur un nom, un identifiant ou une étiquette.
- Row policies de ClickHouse : un rôle par équipe et une politique par table. ClickStack interroge avec les droits de l'utilisateur : la règle vaut pour l'interface, la console et le MCP, donc aussi pour les agents.
- RGPD : une suppression légère (
DELETE FROM … WHERE) efface un client des logs du mois en quelques secondes.
Commandes à connaître #
Commandes à connaître
claude mcp add clickstack --transport http https://mcp.clickhouse.cloud/clickstack --header "x-service-id: <id du service>": connecter Claude Code au serveur MCP de ClickStackALTER TABLE otel_logs COMMENT COLUMN SeverityText '…': documenter une colonne pour les agentsCREATE ROW POLICY … USING ResourceAttributes['k8s.namespace.name'] = 'payments' TO payments_team: restreindre une équipe à son namespaceDELETE FROM otel_logs WHERE …: suppression légère (RGPD)
Sources #
Également : présentations de la Matinée de l'Observabilité ClickHouse, Paris, 17 novembre 2026. Les fonctions en bêta ou en préversion évoluent vite : vérifiez la documentation avant de vous appuyer sur un détail.
