ClickHouse

ClickHouse Cloud kobles til med en API-nøkkel opprettet i organisasjonsinnstillingene dine. En API-nøkkel tilhører nøyaktig én organisasjon, så én nøkkel kobler til én organisasjon, og hver organisasjon kobles til et workspace én gang. Nøkler krypteres før de lagres, og agenten ser dem aldri.

1. Åpne ClickHouse Cloud, gå til organisasjonens API Keys.
2. Klikk på New API key og velg rollen Developer (skrivebeskyttet): Polylane leser bare under synkronisering.
3. Kopier både key ID og key secret; hemmeligheten vises bare én gang.
4. Lim begge verdiene inn i Polylane.
5. Polylane validerer nøkkelen og begynner å synkronisere.

Polylane oppdager tjenestene dine, inkludert tilstand, nivå, region, skyleverandør, ClickHouse-versjon, replikastørrelse og tilkoblingsendepunkter. Tilkoblingsvertsnavn brukes til lenking på tvers av skyer, så applikasjoner som når en tjeneste gjennom en miljøvariabel, lenkes til den på kartet.

Overvåkingen reiser et issue når tjenester står forringet, feilet, stoppet eller delvis kjørende; inaktive og oppvåknende tjenester er vanlig livssyklus for tjenester med inaktivitetsskalering og forblir friske. ClickHouse Clouds kontrollplan rapporterer metrikker som et øyeblikksbilde uten historikk, så agenter leser gjeldende verdier på forespørsel, og tjenester har ingen metrikkdiagrammer.

Feilsøking

Feilen «Invalid API key»

• Både nøkkel-ID-en og nøkkelhemmeligheten kreves; den ene alene kan ikke autentisere.
• Sjekk at nøkkelen ikke er slettet eller deaktivert i ClickHouse Clouds innstillinger for API-nøkler.
• Nøkler med en utløpsdato slutter å virke når de utløper; opprett en ny nøkkel og roter den i Polylane.

Manglende ressurser

• ClickHouse Cloud kan bruke noen minutter på å synkronisere alt.
• Utløs en manuell Sync fra kontooverskriften for å oppdatere.

Ratebegrensninger

• ClickHouse Cloud tillater 10 API-forespørsler per 10 sekunder per nøkkel. En egen nøkkel for Polylane unngår å dele det budsjettet med andre verktøy.

Frakobling

Koble kontoen fra i Polylane, og slett så API-nøkkelen fra organisasjonsinnstillingene dine i ClickHouse Cloud.

Å koble til ClickHouse Cloud trenger ingen nettleser: det samme endepunktet konsollen kaller, passer i en CI-jobb. Én autentisert POST oppretter tilkoblingen og starter den første synkroniseringen.

Forutsetninger

• En Polylane-API-nøkkel med omfangene cloud_accounts:write og cloud_accounts:read. Se API-nøkler og OAuth.
• Workspace-ID-en din, som starter med ws_. Les den fra GET /v1/workspaces med den samme nøkkelen.
• En ClickHouse Cloud-API-nøkkel-ID og -hemmelighet fra organisasjonens API Keys, opprettet med rollen Developer (skrivebeskyttet).

Opprett tilkoblingen

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økkel tilhører nøyaktig én organisasjon, så ett kall kobler til én organisasjon.

Svaret lister hva som ble koblet til, med den første synkroniseringen allerede i gang. Trimmet til de to feltene resten av flyten leser:

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

En konto som allerede er tilkoblet, lander i failures i stedet for accounts, så å gjenta kallet dupliserer aldri en tilkobling.

Vent på den første synkroniseringen

Spør etter hver returnert konto på id-en dens til status når ready (new ved registrering, syncing mens ressurser strømmer inn):

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

Gi løkken en frist slik at en feilet tilkobling får jobben til å feile i stedet for å henge. Når kontoen er ready, er ressursene dens i topologien, og Polylane har startet sin første sjekk.

Koble fra via API-et

Å slette tilkoblingen stopper hver synkronisering og sjekk og sletter legitimasjonen Polylane hadde. Kallet trenger omfanget cloud_accounts:delete:

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

Trekk så tilbake ClickHouse Cloud-legitimasjonen på leverandørsiden, som beskrevet under Koble fra nedenfor.