Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-08

Capacidades y apagado (vista de administración)

Cómo la plataforma expone, limita o apaga recursos costosos y sensibles en emergencia, en despliegue gradual o en prueba controlada — y lo que eso significa para su workspace.

En esta página (12)

El mecanismo de exposición/kill de capacidades es fail-closed y está cubierto por pruebas, pero es un control operativo de la plataforma — no un botón self-service por workspace hoy.

Además de la verificación de cuenta al día (suspensão) y del RBAC (papéis), la plataforma tiene una tercera capa: un resolutor de capacidades que decide si una superficie cara/sensible está expuesta, limitada o apagada — con efecto inmediato en emergencia.

Qué es#

Una capacidad es una superficie nombrada que puede encenderse/apagarse de forma ortogonal al plan y a la morosidad. Grupos:

GrupoCapacidadesEfecto de apagar
Dinero/consumoconsultas no console de dados, acesso ao conjunto de dados, amostragem de dados, atualização de painéis, consulta em linguagem natural, insights de IA, exportação para Excelcorta la vía de pago correspondiente
Exposición/aislamientoapi.v1 (API externa REST+OData), painel público e embed (embed + dashboard público)derriba la exposición externa sin tocar los datos internos
Piloto (ejecución)execução de ingestão (pipeline), execução de relatórios (geração/entrega de relatório)nada corre/encola/entrega
Organizaciónorg.admin (administración de la org)cierra la superficie de org (por-org)

Cómo se toma la decisión (orden)#

  1. Kill global (*) → todo cerrado.
  2. Kill por capacidad → esa superficie cerrada.
  3. Config versionada (sobre { v, items }) → rollout %, allowlist/denylist, override por org/workspace/usuario, validez.
  4. Predeterminado: capacidad declarada y sin kill nace expuesta. El resolutor también sabe tratar capacidad marcada como sensível — esa nace OFF sin decisión explícita (fail-closed) —, pero hoy ninguna capacidad del catálogo está marcada así, por decisión registrada en el código: marcar una de ellas la dejaría apagada para todo el mundo, y la barrera de morosidad es otra capa (suspensão). Es decir: el estándar efectivo hoy es "expuesta", y el control ocurre por el apagado y por los límites, no por un baseline apagado.

Encima de todo, el apagado de emergencia se superpone al final — emergencia siempre gana, incluso sobre una config custom.

Fail-closed es la regla#

  • Config ilegible (JSON inválido) → la capacidad cierra (error de configuración), nunca "abre a oscuras".
  • Capacidad sensível sin decisión → OFF (mecanismo probado; sin uso en el catálogo actual, como se explicó arriba).
  • Efecto inmediato, sin redeploy, cuando el operador acciona la emergencia.

Para qué sirve#

  • Contener incidente: apagar la API externa o el embed público en el momento, sin tumbar la app entera.
  • Rollout seguro: liberar una capacidad para una fracción (canario) antes de 100%.
  • Aislar exposición: matar api.v1/painel público e embed corta el egress sin afectar a quienes solo usan el BI interno.

Plan y permisos#

  • Visión admin: el efecto de las capacidades es visible para el workspace (una superficie desaparece/responde no disponible).
  • Control: el accionamiento (kill/canario/rollout) es operacional/de plataforma — no es un toggle por workspace hoy.

Ejemplo#

Durante un incidente, el operador acciona el kill de api.v1. A partir de ahí, toda llamada a las rutas /api/v1/** responde no disponible — pero los dashboards internos de Comércio Aurora (ficticia) siguen en línea, porque los datos internos no fueron tocados. Resuelto el incidente, la capacidad vuelve a exponerse.

Resultado esperado#

  • Capacidad expuesta → funciona normalmente (la verificación de cuenta al día sigue vigente).
  • Capacidad apagada → la superficie responde no disponible de forma predecible; el resto del producto continúa.

Relación con las otras verificaciones#

  • RBAC decide qué puede hacer el rol (403 de rol).
  • Verificación de cuenta al día decide si la cuenta está en día (402 de morosidad).
  • Capacidad / apagado decide si la superficie está expuesta (independiente de las dos). Son capas ortogonales.

Seguridad#

  • Fail-closed en todo el borde (config inválida/sensível → OFF).
  • Decisión por org tiene cache aislada por orgId — la decisión de una org nunca se filtra a otra.
  • Kill de emergencia no depende de redeploy.

Límites#

  • No es un panel self-service por workspace: el ajuste lo hace nuestro equipo.
  • El kill de exposición (api.v1/painel público e embed) es ortogonal a la morosidad — no sustituye la verificación de suscripción ni el RBAC.

Errores comunes y cómo resolverlos#

SintomaCausa probableQué hacer
API/OData respondiendo no disponiblecapacidad api.v1 apagada (incidente)acompañe el status; abra ticket
Embed/panel público fueracapacidad painel público e embed apagadaídem arriba
Refresh/IA/export fuera, pero dashboard abrecapacidad de consumo apagada (no es morosidad)verifique con soporte
Recurso "desapareció" sin aviso de pagokill de capacidad ≠ 402 de suspensióndiferencie de Suspensão

Relacionados#


Última revisión: 2026-09-08.

Enlaces relacionados