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#
| Plan | Disponibilidad mensual |
|---|---|
| Starter | mejor esfuerzo, sin porcentaje |
| Growth, Business y Scale | 99,5% |
| Enterprise | 99,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/healthes público y responde200cuando la aplicación y la base de metadatos responden, o503cuando 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#
| Superficie | Estado | Observación |
|---|---|---|
| Autenticación por clave de API | disponible | alcance a nivel de workspace; solo el dueño crea/revoca |
| OData v4 (feed) | disponible | subconjunto OData; ver límites abajo |
| Kit Power BI / Excel | disponible | folding + refresh incremental |
| Embed SDK (panel embebido) | disponible | allowlist de origen global hoy |
API de consulta REST (/api/v1/query, /api/v1/tables) | acceso anticipado | todavía no abierta para uso externo; use OData |
| Suscripción de webhooks (eventos → su endpoint) | planificado | use polling/OData |
API de escritura (INSERT/UPDATE/…) | planificado | la plataforma es solo lectura hoy |
| Clave de API por miembro (con seguridad por fila) | planificado | hoy 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 solocontains/startswith/endswith. Fuera del subconjunto =501explícito.$format: solo JSON. - Las columnas
STRUCT/RECORDno 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). DATETIMEse trata como UTC (el datalake no guarda zona horaria).
Embed
- La allowlist de orígenes es global de la instancia (por workspace está planificado).
aplicarFiltrosno 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íntoma | Causa | Qué hacer |
|---|---|---|
| "La doc dice X pero la app hace Y" | posible divergencia de estado | abra un ticket citando la página y la URL |
| Recurso listado como planificado o en acceso anticipado | todavía no abierto para uso general | siga las Novedades; hable con soporte si lo necesita |
| Sistema caído | posible incidente | revise /status y hable con Aiô o con suporte@ingestia.io |
Próximos pasos: Centro de Soporte · Desarrolladores · Troubleshooting.