ClickHouse

ClickHouse Cloud forbindes med en API-nøgle oprettet i din organisations indstillinger. En API-nøgle tilhører præcis én organisation, så én nøgle forbinder én organisation, og hver organisation forbindes til et arbejdsområde én gang. Nøgler krypteres, før de gemmes, og agenten ser dem aldrig.

1. Åbn ClickHouse Cloud, og gå til din organisations API Keys.
2. Klik på New API key, og vælg rollen Developer (skrivebeskyttet): Polylane læser kun under synkronisering.
3. Kopiér både key ID og key secret; hemmeligheden vises kun én gang.
4. Indsæt begge værdier i Polylane.
5. Polylane validerer nøglen og begynder at synkronisere.

Polylane opdager dine services, inklusive tilstand, tier, region, cloududbyder, ClickHouse-version, replikastørrelse og forbindelses-endpoints. Forbindelseshostnavne bruges til kobling på tværs af clouds, så applikationer, der når en service gennem en miljøvariabel, kobles til den på kortet.

Overvågningen rejser et issue, når services står som degraded, failed, stopped eller partially running; idle og waking services er almindelig livscyklus for idle-skalerede services og forbliver sunde. ClickHouse Clouds kontrolplan rapporterer metrikker som et live-snapshot uden historik, så agenter læser aktuelle værdier efter behov, og services har ingen metrikdiagrammer.

Fejlfinding

Fejlen "Invalid API key"

• Både nøgle-id og nøglehemmelighed er påkrævet; den ene alene kan ikke autentificere.
• Kontrollér, at nøglen ikke er blevet slettet eller deaktiveret i ClickHouse Clouds API-nøgleindstillinger.
• Nøgler med udløb holder op med at virke, når de udløber; opret en ny nøgle, og rotér den i Polylane.

Manglende ressourcer

• ClickHouse Cloud kan bruge et par minutter på at synkronisere alt.
• Udløs en manuel Sync fra kontohovedet for at opdatere.

Rate limits

• ClickHouse Cloud tillader 10 API-anmodninger per 10 sekunder per nøgle. En dedikeret nøgle til Polylane undgår at dele det budget med andre værktøjer.

Afbrydelse

Afbryd kontoen i Polylane, og slet derefter API-nøglen fra din ClickHouse Cloud-organisations indstillinger.

Forbindelse af ClickHouse Cloud kræver ingen browser: det samme endpoint, konsollen kalder, passer ind i et CI-job. Én autentificeret POST opretter forbindelsen og starter den første synkronisering.

Forudsætninger

• En Polylane-API-nøgle med scopes cloud_accounts:write og cloud_accounts:read. Se API-nøgler og OAuth.
• Dit arbejdsområde-id, som begynder med ws_. Læs det fra GET /v1/workspaces med den samme nøgle.
• Et ClickHouse Cloud-API-nøgle-id og en hemmelighed fra din organisations API Keys, oprettet med rollen Developer (skrivebeskyttet).

Opret forbindelsen

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

En API-nøgle tilhører præcis én organisation, så ét kald forbinder én organisation.

Svaret lister, hvad der blev forbundet, med den første synkronisering allerede i gang. Trimmet til de to felter, resten af flowet læser:

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

En konto, der allerede er forbundet, lander i failures i stedet for accounts, så gentagelse af kaldet duplikerer aldrig en forbindelse.

Vent på den første synkronisering

Poll hver returneret konto efter dens id, indtil status når ready (new ved registrering, syncing mens ressourcer strømmer ind):

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

Giv løkken en deadline, så en fejlet forbindelse får jobbet til at fejle i stedet for at hænge. Når kontoen er ready, er dens ressourcer i topologien, og Polylane har startet sin første kontrol.

Afbryd fra API'et

Sletning af forbindelsen stopper hver synkronisering og kontrol og sletter de legitimationsoplysninger, Polylane opbevarede. Kaldet kræver scopet cloud_accounts:delete:

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

Tilbagekald derefter ClickHouse Cloud-legitimationen på udbyderens side, som beskrevet under Afbryd nedenfor.