Onde a plataforma roda, o que garantimos em contrato, onde acompanhar a disponibilidade e quais recursos ainda estão em homologação.
Onde a plataforma roda#
- Infraestrutura: nuvem de hiperescala, região São Paulo. O datalake de cada workspace (recebimento, Bronze, Silver e Gold) e o processamento das cargas ficam no Brasil.
- Seus dados sob seu controle: cada workspace tem o próprio datalake, isolado dos demais. No modelo de nuvem própria (incluso a partir do Scale, add-on no Business), o datalake roda no projeto de nuvem da sua empresa — os dados ficam na sua conta.
Disponibilidade e SLA#
| Plano | Disponibilidade mensal |
|---|---|
| Starter | melhor esforço, sem percentual |
| Growth, Business e Scale | 99,5% |
| Enterprise | 99,5% ou o percentual do contrato, o que for maior |
- Crédito de serviço: mês abaixo de 99,5% dá 10% da mensalidade; abaixo de 99,0%, 25%. O crédito tem teto de 25% da mensalidade e é abatido na fatura seguinte. Regras completas em Nível de serviço (SLA).
- Medição pública: a disponibilidade de cada dia dos últimos 90 dias fica em /status. É a mesma série usada para calcular o crédito.
- Monitor próprio:
GET /api/healthé público e responde200quando a aplicação e o banco de metadados respondem, ou503quando uma dependência obrigatória está fora. - Metas internas de engenharia: 99,9% de disponibilidade da aplicação, 99,0% de sucesso de execução de pipeline e consulta de painel abaixo de 8 segundos no p95. O compromisso contratual é o da tabela acima.
Atendimento#
- Aiô — 24 horas, 7 dias, dentro do sistema (botão em todas as telas ou ⌘/). Investiga execuções, logs, tabelas e painéis do seu workspace e propõe a correção, que você confirma.
- Atendimento humano — das 9h às 18h, de segunda a sexta (horário de Brasília), por suporte@ingestia.io ou pela tela Suporte. Primeira resposta: Starter 1 dia útil · Growth 8 horas úteis · Business 4 horas úteis · Scale 2 horas úteis · Enterprise conforme contrato.
Detalhes em Central de Suporte.
Superfícies de integração#
| Superfície | Estado | Observação |
|---|---|---|
| Autenticação por chave de API | disponível | escopo de nível workspace; só o dono cria/revoga |
| OData v4 (feed) | disponível | subset OData; ver limites abaixo |
| Kit Power BI / Excel | disponível | folding + refresh incremental |
| Embed SDK (painel embutido) | disponível | allowlist de origem global hoje |
API de consulta REST (/api/v1/query, /api/v1/tables) | acesso antecipado | ainda não aberta para uso externo; use OData |
| Assinatura de webhooks (eventos → seu endpoint) | planejado | use polling/OData |
API de escrita (INSERT/UPDATE/…) | planejado | a plataforma é somente leitura hoje |
| Chave de API por membro (com segurança por linha) | planejado | hoje a chave é de nível workspace |
Recursos em homologação#
Conectores
O catálogo cresceu por um motor declarativo: ERPs, lojas, meios de pagamento, CRMs, plataformas de marketing, ferramentas de produtividade, dados públicos brasileiros, warehouses consultados por HTTP, pastas e buckets remotos e bancos compatíveis (MariaDB, Redshift, CockroachDB, Supabase, Neon, TimescaleDB, AlloyDB, Azure SQL). A lista completa, com o estado de cada um, está em Conectores.
- Conector novo entra em Acesso limitado: a primeira execução com credencial real é acompanhada pela nossa equipe antes da liberação completa, um conector por vez.
- Planejados (a configuração é recusada com o motivo): TOTVS Protheus, Senior e PagBank — a API não é pública/estável ou não lista registros. NetSuite segue recusado até a verificação da assinatura.
- S3 e Google Cloud Storage como fonte estão em
Acesso limitado(adaptador de arquivos remotos), com a mesma regra. - A extração por API é completa a cada execução (sem janela incremental pelo agendador ainda) e roda dentro do limite de tempo da função — fontes muito grandes podem precisar de recorte por recurso.
Limitações conhecidas#
Dados e pipelines
- Zero à esquerda: identificador só com dígitos (CPF sem pontuação, CEP, código
00123) é lido como número na Bronze e perde o zero à esquerda — vale para CSV e para banco. Envie o campo formatado. Ver Importar arquivo. - Dado pessoal (PII): é encontrado pelo nome e pelo valor e marcado sozinho a cada carga; a marca vale pelo nome da coluna no workspace inteiro (um mesmo nome em outra tabela também sai mascarado). Ver Governança.
- Execução parcial (uma tarefa falhou) não é tentada de novo nem vai para a DLQ; sair da DLQ é pelo suporte. Ver Agendamento, retry e DLQ.
- Recuperar dado apagado: 7 dias de time travel, pelo console SQL — sem botão de restaurar. Ver Recuperar dados.
BI, Agentes e Aiô
- Assinatura do painel: Excel, PowerPoint e PDF anexos; o PDF exige o painel publicado com link de compartilhamento — sem isso, o e-mail avisa e vai com os outros dois.
- Agentes: não exportam dados em arquivo; falam com outros sistemas só por MCP.
- Aiô: não cria conexão nem pipeline; a Silver que ele cria só copia colunas.
- Modelo de painel (.json): os nomes das páginas podem não ser aplicados (crie as páginas com + Página e os visuais aparecem); segmentações não entram pelo modelo; aplicar dezenas de visuais leva alguns minutos com a tela aberta.
Escopo e credenciais
- A chave de API lê todos os marts publicados do workspace; não há recorte por membro/grupo neste canal. Colunas PII nunca saem pela API.
- Só o dono cria/revoga chaves.
OData / Power BI / Excel
- Subset OData: sem
$expand,$apply,$search,$compute, lambdas (any/all) e aritmética em filtro; texto sócontains/startswith/endswith. Fora do subset =501explícito.$format: apenas JSON. - Colunas
STRUCT/RECORDnão são publicadas; arrays chegam como string JSON — evite colunas repeated nos marts. - Paginação: página de até 1.000 linhas; profundidade máxima 1.000.000 de
linhas/consulta (acima →
400, filtre). DATETIMEé tratado como UTC (o datalake não guarda fuso).
Embed
- Allowlist de origens é global da instância (por workspace está planejado).
aplicarFiltrosnão-vazio recarrega o iframe; eventos de cross-filter ainda não são emitidos.
Custo e limites
- Valores em BRL (
x-ingestia-cost-brl) são estimativa da consulta; o valor cobrado é o da fatura. - Rate limit: leitura 120/min por chave (240/min por workspace); SQL livre 60/min por chave (120/min por workspace).
Segurança#
- Nenhuma informação sensível (segredos, dados de cliente, detalhes internos de infraestrutura) é publicada aqui. Relatos de segurança: ver Suporte (trate suspeita de vazamento como Crítica).
Troubleshooting#
| Sintoma | Causa | O que fazer |
|---|---|---|
| "A doc diz X mas o app faz Y" | possível divergência de estado | abra chamado citando a página e a URL |
| Recurso listado como planejado ou em acesso antecipado | ainda não aberto para uso geral | acompanhe as Novidades; fale com o suporte se precisar dele |
| Sistema fora do ar | possível incidente | confira /status e fale com o Aiô ou com suporte@ingestia.io |
Próximos passos: Central de Suporte · Desenvolvedores · Troubleshooting.