Saltar al contenido

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

Estado y disponibilidad

En esta página (8)

Dónde funciona la plataforma, qué garantizamos por contrato, dónde seguir la disponibilidad y qué recursos todavía están en homologación.

Dónde funciona la plataforma#

  • Infraestructura: nube de hiperescala, región São Paulo. El datalake de cada workspace (recepción, Bronze, Silver y Gold) y el procesamiento de las cargas quedan en Brasil.
  • Sus datos bajo su control: cada workspace tiene su propio datalake, aislado de los demás. En el modelo de nube propia (incluida a partir de Scale, add-on en Business), el datalake funciona en el proyecto de nube de su empresa — los datos quedan en su cuenta.

Disponibilidad y SLA#

PlanDisponibilidad mensual
Startermejor esfuerzo, sin porcentaje
Growth, Business y Scale99,5%
Enterprise99,5% o el porcentaje del contrato, el que sea mayor
  • Crédito de servicio: un mes por debajo de 99,5% da 10% de la mensualidad; por debajo de 99,0%, 25%. El crédito tiene un tope de 25% de la mensualidad y se descuenta en la factura siguiente. Reglas completas en Nivel de servicio (SLA).
  • Medición pública: la disponibilidad de cada uno de los últimos 90 días está en /status. Es la misma serie usada para calcular el crédito.
  • Monitor propio: GET /api/health es público y responde 200 cuando la aplicación y la base de metadatos responden, o 503 cuando una dependencia obligatoria está caída.
  • Metas internas de ingeniería: 99,9% de disponibilidad de la aplicación, 99,0% de éxito de ejecución de pipeline y consulta de panel por debajo de 8 segundos en el p95. El compromiso contractual es el de la tabla de arriba.

Atención#

  • Aiô — 24 horas, 7 días, dentro del sistema (botón en todas las pantallas o ⌘/). Investiga ejecuciones, logs, tablas y paneles de su workspace y propone la corrección, que usted confirma.
  • Atención humana — de 9 a 18 h, de lunes a viernes (hora de Brasilia), por suporte@ingestia.io o por la pantalla Soporte. Primera respuesta: Starter 1 día hábil · Growth 8 horas hábiles · Business 4 horas hábiles · Scale 2 horas hábiles · Enterprise según contrato.

Detalles en Centro de Soporte.

Superficies de integración#

SuperficieEstadoObservación
Autenticación por clave de APIdisponiblealcance a nivel de workspace; solo el dueño crea/revoca
OData v4 (feed)disponiblesubconjunto OData; ver límites abajo
Kit Power BI / Exceldisponiblefolding + refresh incremental
Embed SDK (panel embebido)disponibleallowlist de origen global hoy
API de consulta REST (/api/v1/query, /api/v1/tables)acceso anticipadotodavía no abierta para uso externo; use OData
Suscripción de webhooks (eventos → su endpoint)planificadouse polling/OData
API de escritura (INSERT/UPDATE/…)planificadola plataforma es solo lectura hoy
Clave de API por miembro (con seguridad por fila)planificadohoy la clave es a nivel de workspace

Recursos en homologación#

Conectores

El catálogo creció con un motor declarativo: ERPs, tiendas, medios de pago, CRMs, plataformas de marketing, herramientas de productividad, datos públicos brasileños, warehouses consultados por HTTP, carpetas y buckets remotos y bases compatibles (MariaDB, Redshift, CockroachDB, Supabase, Neon, TimescaleDB, AlloyDB, Azure SQL). La lista completa, con el estado de cada uno, está en Conectores.

  • Un conector nuevo entra en Acceso limitado: la primera ejecución con credencial real la acompaña nuestro equipo antes de la liberación completa, un conector a la vez.
  • Planificados (la configuración se rechaza con el motivo): TOTVS Protheus, Senior y PagBank — la API no es pública/estable o no lista registros. NetSuite sigue rechazado hasta la verificación de la firma.
  • S3 y Google Cloud Storage como fuente están en Acceso limitado (adaptador de archivos remotos), con la misma regla.
  • La extracción por API es completa en cada ejecución (todavía sin ventana incremental desde el programador) y corre dentro del límite de tiempo de la función — fuentes muy grandes pueden necesitar recorte por recurso.

Limitaciones conocidas#

Datos y pipelines

  • Cero a la izquierda: un identificador solo con dígitos (CPF sin puntuación, CEP, código 00123) se lee como número en Bronze y pierde el cero a la izquierda — vale para CSV y para base de datos. Envíe el campo formateado. Ver Importar archivo.
  • Dato personal (PII): se encuentra por el nombre y por el valor y se marca solo en cada carga; la marca vale por el nombre de la columna en todo el workspace (el mismo nombre en otra tabla también sale enmascarado). Ver Gobernanza.
  • Ejecución parcial (una tarea falló) no se reintenta ni va a la DLQ; salir de la DLQ es por soporte. Ver Programación, retry y DLQ.
  • Recuperar dato borrado: 7 días de time travel, por la consola SQL — sin botón de restaurar. Ver Recuperar datos.

BI, Agentes y Aiô

  • Suscripción del panel: adjuntos en Excel, PowerPoint y PDF; el PDF exige el panel publicado con enlace para compartir — sin eso, el correo avisa y va con los otros dos.
  • Agentes: no exportan datos en archivo; hablan con otros sistemas solo por MCP.
  • Aiô: no crea conexión ni pipeline; la Silver que crea solo copia columnas.
  • Modelo de panel (.json): los nombres de las páginas pueden no aplicarse (cree las páginas con + Página y los visuales aparecen); las segmentaciones no entran por el modelo; aplicar decenas de visuales toma algunos minutos con la pantalla abierta.

Alcance y credenciales

  • La clave de API lee todos los marts publicados del workspace; no hay recorte por miembro/grupo en este canal. Las columnas PII nunca salen por la API.
  • Solo el dueño crea/revoca claves.

OData / Power BI / Excel

  • Subconjunto OData: sin $expand, $apply, $search, $compute, lambdas (any/all) ni aritmética en filtro; texto solo contains/startswith/endswith. Fuera del subconjunto = 501 explícito. $format: solo JSON.
  • Las columnas STRUCT/RECORD no se publican; los arrays llegan como string JSON — evite columnas repeated en los marts.
  • Paginación: página de hasta 1.000 filas; profundidad máxima de 1.000.000 de filas/consulta (arriba → 400, filtre).
  • DATETIME se trata como UTC (el datalake no guarda zona horaria).

Embed

  • La allowlist de orígenes es global de la instancia (por workspace está planificado).
  • aplicarFiltros no vacío recarga el iframe; los eventos de cross-filter todavía no se emiten.

Costo y límites

  • Los valores en BRL (x-ingestia-cost-brl) son una estimación de la consulta; el valor cobrado es el de la factura.
  • Rate limit: lectura 120/min por clave (240/min por workspace); SQL libre 60/min por clave (120/min por workspace).

Seguridad#

  • Ninguna información sensible (secretos, datos de clientes, detalles internos de infraestructura) se publica aquí. Reportes de seguridad: ver Soporte (trate una sospecha de filtración como Crítica).

Troubleshooting#

SíntomaCausaQué hacer
"La doc dice X pero la app hace Y"posible divergencia de estadoabra un ticket citando la página y la URL
Recurso listado como planificado o en acceso anticipadotodavía no abierto para uso generalsiga las Novedades; hable con soporte si lo necesita
Sistema caídoposible incidenterevise /status y hable con Aiô o con suporte@ingestia.io

Próximos pasos: Centro de Soporte · Desarrolladores · Troubleshooting.

Enlaces relacionados