Uso y facturación
Qué mide Kisenon, la asignación gratuita y cómo la muestra la consola.
Kisenon mide lo que realmente usas y lo agrupa por organización. 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:
| Dimensión | Unidad | Cómo se mide |
|---|---|---|
| Cómputo | CU-horas | Recalculado cada minuto a partir del tiempo de ejecución del lado del servidor de cada endpoint (Postgres now()), agrupado por hora y ponderado por el tamaño de cómputo. |
| Almacenamiento | GB-meses | Consultado cada 5 minutos a partir del tamaño por proyecto de la capa de almacenamiento. |
| Ramas | rama-meses | Muestreado una vez al día a las 02:00 UTC por proyecto. |
El cómputo es el que se mueve: un endpoint que se suspende al estar inactivo deja de acumular CU-horas en el momento en que se detiene, de modo que un proyecto que duerme la mayor parte del día cuesta una fracción de uno que corre a pleno rendimiento. 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:
| Dimensión | Unidad |
|---|---|
| Cómputo | CU-horas |
| Almacenamiento | GB-meses |
| Ramas | rama-meses |
| Egreso | GB |
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 que mantiene bajas las CU-horas.
- Precios — la asignación gratuita, las tarifas por unidad y el descuento por volumen.