ClickHouse

ClickHouse Cloud se connecte avec une clé API créée dans les réglages de ton organisation. Une clé API appartient à exactement une organisation, donc une clé connecte une organisation, et chaque organisation se connecte une seule fois à un espace de travail. Les clés sont chiffrées avant d'être stockées, et l'agent ne les voit jamais.

1. Ouvre ClickHouse Cloud, va dans API Keys de ton organisation.
2. Clique sur New API key et choisis le rôle Developer (lecture seule) : Polylane ne fait que lire pendant la synchronisation.
3. Copie à la fois le key ID et le key secret ; le secret n'est affiché qu'une fois.
4. Colle les deux valeurs dans Polylane.
5. Polylane valide la clé et commence la synchronisation.

Polylane découvre tes services, y compris l'état, le niveau, la région, le fournisseur cloud, la version de ClickHouse, le dimensionnement des réplicas et les points d'accès de connexion. Les noms d'hôte de connexion servent aux liens entre clouds, donc les applications qui atteignent un service via une variable d'environnement y sont reliées sur la carte.

La surveillance ouvre une issue quand des services restent dégradés, en échec, arrêtés ou partiellement en cours d'exécution ; les services inactifs et en réveil relèvent du cycle de vie ordinaire des services à mise à l'échelle sur inactivité et restent sains. Le plan de contrôle de ClickHouse Cloud rapporte les métriques comme un instantané en direct sans historique, donc les agents lisent les valeurs courantes à la demande et les services ne portent aucun graphique de métriques.

Dépannage

Erreur "Invalid API key"

• Le key ID et le key secret sont tous deux requis ; l'un sans l'autre ne peut pas s'authentifier.
• Vérifie que la clé n'a pas été supprimée ou désactivée dans les réglages de clés API de ClickHouse Cloud.
• Les clés avec une expiration cessent de fonctionner quand elles expirent ; crée une nouvelle clé et fais-la tourner dans Polylane.

Ressources manquantes

• ClickHouse Cloud peut mettre quelques minutes à tout synchroniser.
• Déclenche un Sync manuel depuis l'en-tête du compte pour rafraîchir.

Limites de débit

• ClickHouse Cloud autorise 10 requêtes API par 10 secondes par clé. Une clé dédiée à Polylane évite de partager ce budget avec d'autres outils.

Déconnexion

Déconnecte le compte dans Polylane, puis supprime la clé API depuis les réglages de ton organisation ClickHouse Cloud.

Connecter ClickHouse Cloud ne nécessite aucun navigateur : le même point d'accès que la console appelle tient dans un job de CI. Un seul POST authentifié crée la connexion et démarre la première synchronisation.

Prérequis

• Une clé API Polylane avec les scopes cloud_accounts:write et cloud_accounts:read. Voir Clés API et OAuth.
• L'identifiant de ton espace de travail, qui commence par ws_. Lis-le depuis GET /v1/workspaces avec la même clé.
• Un identifiant et un secret de clé API ClickHouse Cloud depuis API Keys de ton organisation, créés avec le rôle Developer (lecture seule).

Créer la connexion

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "clickhouse",
    "workspaceId": "ws_0abc123",
    "keyId": "<key-id>",
    "keySecret": "<key-secret>"
  }'

Une clé API appartient à exactement une organisation, donc un appel connecte une organisation.

La réponse liste ce qui a été connecté, avec la première synchronisation déjà en cours. Réduite aux deux champs que le reste du flux lit :

{
  "success": true,
  "result": {
    "provider": "clickhouse",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Un compte déjà connecté atterrit dans failures au lieu de accounts, donc répéter l'appel ne duplique jamais une connexion.

Attendre la première synchronisation

Interroge chaque compte renvoyé par son id jusqu'à ce que status atteigne ready (new à l'enregistrement, syncing pendant que les ressources arrivent) :

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Donne une échéance à la boucle pour qu'une connexion échouée fasse échouer le job au lieu de le bloquer. Une fois que le compte est ready, ses ressources sont dans la topologie et Polylane a démarré sa première vérification.

Déconnecter depuis l'API

Supprimer la connexion arrête chaque synchronisation et chaque vérification et supprime les identifiants que Polylane détenait. L'appel nécessite le scope cloud_accounts:delete :

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Révoque ensuite l'identifiant ClickHouse Cloud côté fournisseur, comme décrit sous Disconnect ci-dessous.