ClickHouse

ClickHouse Cloud se conecta con una clave de API creada en la configuración de tu organización. Una clave de API pertenece exactamente a una organización, así que una clave conecta una organización, y cada organización se conecta a un espacio de trabajo una sola vez. Las claves se cifran antes de almacenarse, y el agente nunca las ve.

1. Abre ClickHouse Cloud y ve a API Keys de tu organización.
2. Haz clic en New API key y elige el rol Developer (solo lectura): Polylane solo lee durante la sincronización.
3. Copia tanto el key ID como el key secret; el secreto se muestra una sola vez.
4. Pega ambos valores en Polylane.
5. Polylane valida la clave y empieza a sincronizar.

Polylane descubre tus servicios, incluidos estado, tier, región, proveedor de nube, versión de ClickHouse, dimensionamiento de réplicas y endpoints de conexión. Los nombres de host de conexión se usan para enlazar entre nubes, así que las aplicaciones que alcanzan un servicio a través de una variable de entorno se enlazan con él en el mapa.

La monitorización abre un issue cuando los servicios permanecen degradados, fallidos, detenidos o parcialmente en ejecución; los servicios inactivos y en proceso de despertar son el ciclo de vida normal de los servicios con escalado a inactividad y se mantienen sanos. El plano de control de ClickHouse Cloud reporta las métricas como una instantánea en vivo sin historial, así que los agentes leen los valores actuales bajo demanda y los servicios no llevan gráficos de métricas.

Solución de problemas

Error "Invalid API key"

• Se requieren tanto el ID de la clave como el secreto de la clave; ninguno de los dos autentica por sí solo.
• Comprueba que la clave no se haya eliminado ni deshabilitado en la configuración de claves de API de ClickHouse Cloud.
• Las claves con caducidad dejan de funcionar cuando expiran; crea una clave nueva y rótala en Polylane.

Faltan recursos

• ClickHouse Cloud puede tardar unos minutos en sincronizar todo.
• Lanza un Sync manual desde la cabecera de la cuenta para actualizar.

Límites de tasa

• ClickHouse Cloud permite 10 solicitudes de API cada 10 segundos por clave. Una clave dedicada para Polylane evita compartir ese presupuesto con otras herramientas.

Desconexión

Desconecta la cuenta en Polylane y luego elimina la clave de API desde la configuración de tu organización de ClickHouse Cloud.

Conectar ClickHouse Cloud no necesita navegador: el mismo endpoint al que llama la consola cabe en un trabajo de CI. Un único POST autenticado crea la conexión e inicia la primera sincronización.

Requisitos previos

• Una clave de API de Polylane con los scopes cloud_accounts:write y cloud_accounts:read. Consulta Claves de API y OAuth.
• El ID de tu espacio de trabajo, que empieza por ws_. Léelo desde GET /v1/workspaces con la misma clave.
• Un ID y un secreto de clave de API de ClickHouse Cloud de API Keys de tu organización, creados con el rol Developer (solo lectura).

Crear la conexión

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 clave de API pertenece exactamente a una organización, así que una llamada conecta una organización.

La respuesta lista lo que se conectó, con la primera sincronización ya en marcha. Recortada a los dos campos que lee el resto del flujo:

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

Una cuenta que ya está conectada acaba en failures en lugar de en accounts, así que repetir la llamada nunca duplica una conexión.

Esperar a la primera sincronización

Consulta cada cuenta devuelta por su id hasta que status llegue a ready (new al registrarse, syncing mientras los recursos van llegando):

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

Dale al bucle un plazo límite para que una conexión fallida haga fallar el trabajo en lugar de dejarlo colgado. Cuando la cuenta está ready, sus recursos están en la topología y Polylane ha iniciado su primera comprobación.

Desconectar desde la API

Eliminar la conexión detiene todas las sincronizaciones y comprobaciones y elimina las credenciales que Polylane guardaba. La llamada necesita el 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"

Después revoca la credencial de ClickHouse Cloud del lado del proveedor, como se describe más abajo en Desconectar.