Saltar a contenido

Oracle Cloud

Conecta un tenancy OCI en Account → Cloud accounts. Elige OCI y luego Add account.

Koltto inicia sesión como un usuario IAM en un grupo dedicado. Crea ese grupo y política en OCI primero, luego agrega la cuenta en Koltto.

El gasto viene de los cost reports de Oracle (archivos CSV en un bucket de Object Storage propiedad de Oracle) — la ruta que describe la documentación de facturación de Oracle. Koltto no usa Cost Analysis ni la API deprecada de Usage reports.

Crear el grupo KolttoReaders

En la consola de OCI, como administrador del tenancy:

  1. Crea un grupo IAM llamado KolttoReaders en el mismo identity domain que el usuario de Koltto (Default u Oracle Identity Cloud Service).
  2. Crea un usuario IAM para Koltto (no tu propio login de consola). Agrega ese usuario a KolttoReaders.
  3. Crea una política en el tenancy (raíz), no en un compartment hijo. Pega una de estas — el prefijo del grupo debe coincidir con el dominio de ese usuario.

Dominio Default:

define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq
endorse group Default/KolttoReaders to read objects in tenancy usage-report
Allow group Default/KolttoReaders to inspect all-resources in tenancy
Allow group Default/KolttoReaders to read instances in tenancy
Allow group Default/KolttoReaders to read metrics in tenancy
Allow group Default/KolttoReaders to read optimizer-api-family in tenancy

Dominio OracleIdentityCloudService:

define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq
endorse group OracleIdentityCloudService/KolttoReaders to read objects in tenancy usage-report
Allow group OracleIdentityCloudService/KolttoReaders to inspect all-resources in tenancy
Allow group OracleIdentityCloudService/KolttoReaders to read instances in tenancy
Allow group OracleIdentityCloudService/KolttoReaders to read metrics in tenancy
Allow group OracleIdentityCloudService/KolttoReaders to read optimizer-api-family in tenancy

Unprefixed Allow group KolttoReaders solo coincide con Default. Los dos dominios son grupos distintos aunque el nombre sea el mismo.

La línea define tenancy usage-report nombra el tenancy de reportes de Oracle (ese OCID es de Oracle, no tuyo). La línea endorse … to read objects es obligatoria para que Koltto pueda leer los archivos de cost report. Inventory y metrics siguen usando inspect all-resources, read instances y read metrics. read optimizer-api-family hace falta para que Koltto muestre expanders de Oracle Cloud Advisor en Opportunities (por ejemplo burstable shapes y object lifecycle). Sin ella, las recomendaciones propias de Koltto siguen funcionando.

No necesitas read usage-reports. Ese verbo era para la vieja Usage API.

Eso es solo lectura. Koltto puede listar compartments, inventory, métricas, costo y Cloud Advisor. No puede crear, iniciar, detener ni eliminar recursos.

Copia el tenancy OCID y el user OCID. Los pegarás en Koltto.

Los cost reports se generan a lo largo del día y pueden demorar hasta 24 horas. En la consola de OCI, Billing → Cost and Usage Reports es donde aparecen esos archivos. Después de conectar, ejecuta Refresh data → Cost; si el gasto sigue vacío, espera los siguientes archivos y vuelve a actualizar.

Campos del formulario

Campo Qué ingresar
Name Una etiqueta en Koltto (acme-prod).
Description Opcional.
Region Región home, por ejemplo us-ashburn-1.
Tenancy OCID ocid1.tenancy.oc1..…
User OCID El OCID del usuario KolttoReaders.
Sync regions Lista opcional separada por comas (us-ashburn-1, eu-frankfurt-1). Inventory y metrics sincronizan solo esas regiones. Una región significa solo esa. Déjalo en blanco para sincronizar solo la región home — no todas las regiones suscritas. El costo es a nivel tenancy desde la región home y no se limita por este campo.

Koltto genera el par de claves de firma de la API. La clave privada nunca sale de Koltto (cifrada en reposo). No pegas un PEM ni un passphrase.

Agregar la clave pública en OCI

Inventory no empieza cuando guardas la cuenta. Siguiente:

  1. Descarga la clave pública desde Koltto.
  2. En la consola de OCI, ve a Identity → Users, abre el usuario KolttoReaders, luego API Keys, y agrega la clave pública.
  3. Verifica que el fingerprint en OCI coincida con el que calculó Koltto.
  4. En Koltto, elige I've added the key and policy. La actualización de inventory empieza después de que ese verify tenga éxito.

Qué inventaría Koltto

Compute, OKE, block y boot volumes, object storage, file storage, load balancers (incluyendo network load balancers), NAT gateways, bases de datos (Autonomous DB, Base DB, MySQL HeatWave, PostgreSQL, OCI Cache) y sus backups, WAF, WAA y Logging.

Los collectors de VCN aún no están en el producto.

CPU y memoria de Compute en Inventory necesitan el plugin Compute Instance Monitoring en la instancia. Otras métricas (storage, load balancer, base de datos) no.

Después de verificar la clave

Inventory empieza cuando el verify tiene éxito. Ejecuta Refresh data → Cost y Metrics para que Overview, Spend Analytics y Opportunities tengan números.

El scope en el resto de la app es el árbol de compartments, con el tenancy en la raíz.