Selo de estado:
Preview(limite atual do produto) · Atualizado em 2026-09-08 · Fonte da verdade de estado: matriz de estados do produto. O registro de eventos é um recurso implementado; os valores de custo exibidos por evento são projeção (custo faturado em BRL não medido em produção).
Passo a passo da tela
O rótulo de cada botão e o que você deve ver no fim estão em Tela Auditoria.
A tela de Auditoria (/auditoria) é a trilha do workspace: cada ação
relevante vira um evento com quem fez, quando, sobre o quê e quanto custou.
Assim que você roda queries, pipelines ou mexe em configurações, aparece aqui.
O que é#
Um registro cronológico dos eventos do workspace (os mais recentes primeiro), com filtros e uma visão de tabela ou de log. Serve de base para investigação, conferência de custo e requisitos de compliance.
Para que serve#
- Descobrir quem disparou uma ação e quando.
- Conferir o custo associado a operações caras (query, refresh, IA, export).
- Investigar falhas (eventos marcados como erro).
Quem faz e quando#
- É área do dono: exige
requireOwnerArea. Membro convidado é levado de volta ao Workspace de BI. - Use ao investigar um custo inesperado, uma mudança de configuração ou uma falha de pipeline.
O que a tela mostra#
Cada evento traz: data/hora (em UTC, formato de log), usuário (nome/e-mail), categoria, ação, recurso, detalhe, o SQL (quando houver, clique para expandir) e o custo estimado em R$.
Categorias:
| Categoria | Cobre |
|---|---|
| Usuário | ações feitas por pessoas (login, edição, export…) |
| Sistema | eventos automáticos da plataforma |
| Pipeline | execuções de ingestão/transformação |
| Billing | cobrança, franquia, recarga |
| Segurança | eventos sensíveis (MFA, permissões, acesso) |
Filtros disponíveis#
- Busca textual (ação, recurso, usuário, detalhe, SQL).
- Categoria, usuário e recurso (listas montadas do que existe nos eventos).
- Status derivado: OK ou erro (inferido best-effort da ação/detalhe — não é um campo dedicado).
- Período (data + hora), com padrão dos últimos 7 dias.
- Alternância entre visão Tabela e visão Log.
A tela carrega os últimos 200 eventos do workspace; os filtros atuam sobre essa janela.
Passo a passo (investigar um custo)#
- Abra
/auditoria. - Filtre por período (ex.: ontem) e, se quiser, por usuário.
- Procure eventos com custo alto; clique no SQL para ver a consulta completa.
- Cruze com a Linhagem se precisar entender de onde o número veio.
Resultado esperado#
Uma lista filtrável que responde "quem, quando, o quê e quanto custou" para cada ação do workspace.
Exemplo#
Na Comércio Aurora, o dono filtra a categoria Pipeline dos últimos 7 dias,
encontra uma execução marcada como erro em aurora_silver.vendas, expande o
detalhe e confirma que a fonte veio vazia naquele dia.
Limites e custos#
- Abrir a tela: R$ 0 — lê o registro do banco, não consulta paga.
- Mostra os últimos 200 eventos; janelas maiores não são paginadas nesta tela.
- O custo por evento é estimativa (BRL faturado não medido).
- O status OK/erro é derivado do texto da ação/detalhe, não um campo garantido.
Segurança#
- Escopado por
workspaceId; a tela é restrita ao dono. - O SQL registrado ajuda a auditar consultas caras ou indevidas.
Erros comuns#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Nenhum evento ainda" | workspace novo/sem atividade | rode uma query ou um pipeline e volte |
| Não vejo eventos antigos | janela limitada a 200 | filtre por período mais recente |
| Fui mandado para o Workspace de BI | tela é área do dono | acesse com conta owner/admin |
| Custo do evento parece diferente da fatura | valor é estimativa (projeção) | trate como projeção, não fatura final |
Relacionados#
Última revisão: 2026-09-08. Estado & evidência: registro de eventos implementado; custo por evento = projeção (não medido). Teto Preview. Fonte: matriz de estados do produto.