Pular para o conteúdo

Status e disponibilidade

Nesta página (8)

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#

PlanoDisponibilidade mensal
Startermelhor esforço, sem percentual
Growth, Business e Scale99,5%
Enterprise99,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 responde 200 quando a aplicação e o banco de metadados respondem, ou 503 quando 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ícieEstadoObservação
Autenticação por chave de APIdisponívelescopo de nível workspace; só o dono cria/revoga
OData v4 (feed)disponívelsubset OData; ver limites abaixo
Kit Power BI / Exceldisponívelfolding + refresh incremental
Embed SDK (painel embutido)disponívelallowlist de origem global hoje
API de consulta REST (/api/v1/query, /api/v1/tables)acesso antecipadoainda não aberta para uso externo; use OData
Assinatura de webhooks (eventos → seu endpoint)planejadouse polling/OData
API de escrita (INSERT/UPDATE/…)planejadoa plataforma é somente leitura hoje
Chave de API por membro (com segurança por linha)planejadohoje 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 = 501 explícito. $format: apenas JSON.
  • Colunas STRUCT/RECORD nã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).
  • aplicarFiltros nã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#

SintomaCausaO que fazer
"A doc diz X mas o app faz Y"possível divergência de estadoabra chamado citando a página e a URL
Recurso listado como planejado ou em acesso antecipadoainda não aberto para uso geralacompanhe as Novidades; fale com o suporte se precisar dele
Sistema fora do arpossível incidenteconfira /status e fale com o Aiô ou com suporte@ingestia.io

Próximos passos: Central de Suporte · Desenvolvedores · Troubleshooting.

Links relacionados