Uso y facturación

Kisenon mide cuatro dimensiones y las agrupa por organización. El cómputo se mide como tiempo activo ponderado por tamaño — lee Qué es una CU-hora antes de interpretar una cifra de cómputo. La consola muestra tu uso, y el uso que excede tu asignación mensual gratuita se factura según el contrato de precios — consulta Estado de facturación más abajo.

Qué medimos

El plano de control muestrea tres dimensiones por proyecto y las agrega por organización:

Qué es una CU-hora

Una CU-hora es una hora que un endpoint pasa despierto, multiplicada por el tamaño de cómputo de ese endpoint. Esa es toda la definición.

Mide tamaño y tiempo activo, no trabajo realizado. El medidor no lee CPU, ni memoria, ni IOPS, ni número de conexiones — así que un endpoint despierto pero inactivo acumula CU-horas exactamente al mismo ritmo que uno saturado del mismo tamaño. Un endpoint que satura todos sus núcleos durante una hora y otro que responde un único SELECT 1 en esa hora se facturan igual.

Lo que sí cambia tu factura de cómputo:

• El tiempo activo. Un endpoint suspendido no acumula nada. El tiempo dormido es gratis.
• El tamaño de cómputo. Un endpoint más grande acumula proporcionalmente más por hora despierto.

Así que la palanca es la suspensión al estar inactivo, no la eficiencia de las consultas: un endpoint que se suspende deja de acumular CU-horas en el momento en que se detiene, y un proyecto que duerme la mayor parte del día cuesta una fracción de uno que se mantiene despierto. Afinar una consulta para que use menos CPU no baja una factura en CU-horas; dejar que el endpoint se suspenda antes, sí.

Los recuentos de almacenamiento y de ramas son estables dentro de sus ventanas de muestreo, así que una cadencia más gruesa es suficiente.

Las muestras se agrupan en una única vista por organización del uso de cómputo, almacenamiento y ramas para el ciclo de facturación actual — los números que la página de facturación renderiza.

El nivel gratuito

Cada organización comienza con una asignación mensual gratuita. También puede aplicarse un límite de recuento de proyectos por organización: cuando el límite está habilitado, una organización sin método de pago registrado se mantiene en un número fijo de proyectos; una vez alcanzado, crear otro proyecto devuelve free_allowance_exhausted (HTTP 403). Las organizaciones con un método de pago registrado no tienen límite. El límite exacto es una configuración de despliegue en lugar de un número codificado, así que puede ajustarse con el tiempo.

A medida que el uso medido de un ciclo aumenta, la consola muestra un banner escalado sobre el contenido principal en tres umbrales — los mismos porcentajes 80 / 95 / 100 que el plano de control registra en su registro de notificaciones por ciclo:

• 80% — un aviso amarillo: "Has usado más del 80% de tu nivel gratuito este período."
• 95% — una advertencia ámbar para añadir un método de pago antes de que se interrumpa el servicio.
• 100% — un estado rojo de agotamiento: el cómputo puede pausarse hasta que se añada un método de pago.

Cada banner puede descartarse durante la sesión y enlaza a Añadir un método de pago.

La página de facturación de la organización

Cada organización tiene una página de facturación en /orgs/{id}/billing, accesible desde la navegación de la organización. Cuando hay datos de uso disponibles renderiza, por dimensión, una barra usado / asignación (verde por debajo del 80%, ámbar 80–95%, rojo en/por encima del 95%) más un marcador opcional de fin de período proyectado, una línea de factura proyectada, y el plan y el método de pago actuales.

Gestionar la facturación

La facturación de autoservicio está activa. Una vez que hay un método de pago registrado, la página de facturación de la organización (Settings → Billing) muestra un botón Manage billing que abre el Customer Portal alojado por Stripe. En el portal puedes:

• Actualizar o reemplazar el método de pago.
• Ver facturas y recibos.
• Editar tu dirección de facturación e identificadores fiscales.
• Cancelar.

Antes de añadir una tarjeta, la página muestra en su lugar un botón Checkout (añadir un método de pago); los dos son mutuamente excluyentes.

Quién puede: solo el owner de la organización o el rol de billing — no admin, member ni viewer.

Como referencia, el plano de control expone:

POST /v1/billing/portal-session → { url }

que devuelve una URL al Customer Portal; el portal siempre te devuelve a la página de facturación de la organización después.

Coste por proyecto (showback)

La página de facturación incluye una tarjeta Cost by project que desglosa tu uso por proyecto. Reporta cuatro dimensiones medidas por proyecto:

Un interruptor Include credits & discounts alterna la vista entre bruto y neto — la vista neta aplica una asignación prorrateada de la asignación gratuita y el descuento por volumen. Es una lente de visualización: el pie siempre muestra el subtotal bruto, la asignación gratuita, el descuento por volumen y el total neto.

Los datos tienen granularidad diaria: el período se identifica por una fecha de inicio completa (YYYY-MM-DD). El uso se extrae de un almacén de medición global, de modo que los costes de un proyecto siguen visibles incluso después de eliminarlo.

Estado de facturación

El uso medido se recopila por proyecto, se agrega por organización y se factura a través de Stripe según el contrato de precios:

• El uso dentro de tu asignación mensual gratuita no se cobra; el uso más allá de ella se mide por unidad, con un descuento por volumen automático en el uso intensivo.
• El endpoint de facturación del plano de control (/v1/billing/customer) respalda el banner de uso y la página de facturación de la organización — leen de la misma fuente, así que ambos reflejan los números reales del ciclo actual.
• Añade un método de pago desde la página de facturación de la organización para levantar el límite de proyectos del nivel gratuito y continuar más allá de la asignación gratuita.

Relacionado

• Organizaciones — la unidad a la que se agrega el uso.
• Endpoints — la suspensión al estar inactivo es lo único que mantiene bajas las CU-horas; consulta Qué es una CU-hora.
• Precios — la asignación gratuita, las tarifas por unidad y el descuento por volumen.