ClickHouse

ClickHouse Cloud si collega con una chiave API creata nelle impostazioni dell'organizzazione. Una chiave API appartiene a esattamente un'organizzazione, quindi una chiave collega un'organizzazione, e ogni organizzazione si collega a un workspace una sola volta. Le chiavi vengono cifrate prima di essere archiviate e l'agente non le vede mai.

1. Apri ClickHouse Cloud e vai su API Keys della tua organizzazione.
2. Fai clic su New API key e scegli il ruolo Developer (sola lettura): Polylane legge soltanto durante la sincronizzazione.
3. Copia sia il key ID sia il key secret; il secret viene mostrato una sola volta.
4. Incolla entrambi i valori in Polylane.
5. Polylane convalida la chiave e avvia la sincronizzazione.

Polylane scopre i tuoi servizi, inclusi stato, tier, regione, provider cloud, versione di ClickHouse, dimensionamento delle repliche ed endpoint di connessione. Gli hostname di connessione vengono usati per i collegamenti tra cloud, così le applicazioni che raggiungono un servizio tramite una variabile d'ambiente vi si collegano sulla mappa.

Il monitoraggio apre una issue quando i servizi restano degradati, falliti, fermi o parzialmente in esecuzione; i servizi idle o in fase di riattivazione fanno parte del normale ciclo di vita dei servizi con scalabilità a riposo e restano sani. Il control plane di ClickHouse Cloud riporta le metriche come istantanea live senza cronologia, quindi gli agenti leggono i valori correnti su richiesta e i servizi non hanno grafici delle metriche.

Risoluzione dei problemi

Errore "Invalid API key"

• Servono sia il key ID sia il key secret; uno solo dei due non basta per autenticarsi.
• Verifica che la chiave non sia stata eliminata o disabilitata nelle impostazioni delle chiavi API di ClickHouse Cloud.
• Le chiavi con scadenza smettono di funzionare quando scadono; crea una nuova chiave e ruotala in Polylane.

Risorse mancanti

• ClickHouse Cloud può impiegare qualche minuto per sincronizzare tutto.
• Avvia una Sync manuale dall'intestazione dell'account per aggiornare.

Limiti di frequenza

• ClickHouse Cloud consente 10 richieste API ogni 10 secondi per chiave. Una chiave dedicata a Polylane evita di condividere quel budget con altri strumenti.

Scollegamento

Scollega l'account in Polylane, poi elimina la chiave API dalle impostazioni della tua organizzazione ClickHouse Cloud.

Collegare ClickHouse Cloud non richiede un browser: lo stesso endpoint che chiama la console sta in un job CI. Una sola POST autenticata crea il collegamento e avvia la prima sincronizzazione.

Prerequisiti

• Una chiave API Polylane con gli scope cloud_accounts:write e cloud_accounts:read. Vedi Chiavi API e OAuth.
• L'ID del tuo workspace, che inizia con ws_. Leggilo da GET /v1/workspaces con la stessa chiave.
• Un ID e un secret di chiave API ClickHouse Cloud da API Keys della tua organizzazione, creati con il ruolo Developer (sola lettura).

Crea il collegamento

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>"
  }'

Una chiave API appartiene a esattamente una organizzazione, quindi una sola chiamata collega una organizzazione.

La risposta elenca ciò che è stato collegato, con la prima sincronizzazione già in corso. Ridotta ai due campi che il resto del flusso legge:

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

Un account già collegato finisce in failures invece che in accounts, quindi ripetere la chiamata non duplica mai un collegamento.

Attendi la prima sincronizzazione

Interroga ogni account restituito tramite il suo id finché status non raggiunge ready (new alla registrazione, syncing mentre le risorse arrivano):

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

Dai al ciclo una scadenza, così un collegamento fallito fa fallire il job invece di bloccarlo. Una volta che l'account è ready, le sue risorse sono nella topologia e Polylane ha avviato il suo primo controllo.

Scollega dall'API

Eliminare il collegamento interrompe ogni sincronizzazione e ogni controllo ed elimina le credenziali che Polylane conservava. La chiamata richiede lo 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"

Poi revoca la credenziale ClickHouse Cloud sul lato del provider, come descritto sotto Scollega qui sotto.