Exportar registros de auditoria
A maioria das orgs nunca precisa exportar dados de auditoria — o registro no app vai longe o suficiente para qualquer investigação normal. Mas três situações tornam a exportação valiosa:
- Época de impostos. Você quer uma cópia congelada e fora da plataforma de toda edição de doação do ano fiscal para defender uma declaração que pode ser questionada depois.
- Retenção do plano Starter. O registro de auditoria da org é podado para 90 dias no Starter. Exports trimestrais mantêm seu histórico completo.
- Conformidade. Algumas denominações e seguradoras exigem trilhas de auditoria retidas por 7+ anos. Backups de banco de dados satisfazem isso; exports CSV são mais amigáveis para realmente revisar os dados.
Exportar o registro de auditoria da organização
A partir de /activity-log:
- Aplique os filtros que você quer exportar (tipo de entidade, ação, e-mail do ator). Pule filtros para obter tudo.
- Clique no botão Exportar CSV no cabeçalho da página.
- O export roda no servidor e te envia por e-mail um link de download quando estiver pronto. Exports grandes (100.000+ linhas) levam alguns minutos; pequenos completam em segundos.
As colunas do CSV espelham a tabela:
created_at,actor_email,actor_name,action,entity_type,entity_id,changed_columns,reasonchanged_columns é separado por vírgula dentro da célula (entre aspas). reason é a justificativa em texto livre quando uma foi fornecida (ex. motivo de execução de workflow); vazio caso contrário.
TIP
O export tem limite de taxa de 5 exports por hora por org para manter a fila de e-mail sã. Se você está fazendo runs de arquivo anual, agende-os — não dispare dez de uma vez.
Exportar atividade do membro
O registro de atividade do membro não tem botão de export por membro — é projetado para leitura humana, não puxadas em massa. Se você precisa dos dados subjacentes:
- Use a API para consultar
member_activity_logfiltrado pormember_idou janela decreated_at. - Ou exporte o registro de auditoria da org e faça join com seu CSV de membros externamente.
Exportar histórico de importações
Em Dados e Registros → Histórico de Importações, o botão Exportar escreve um CSV de cada job de importação (status, contagens de linha, created_at). Não inclui os registros de erro por linha — esses são baixados por job pelo botão Baixar CSV de erros em cada linha.
Se você precisa dos erros em nível de linha para muitos jobs, o endpoint da API /api/import-jobs/{id}/errors os retorna como JSON.
Cadência sugerida de export
| Plano | O quê | Quando | Por quê |
|---|---|---|---|
| Starter | Registro de auditoria da org | Mensal | Bater a poda de 90 dias |
| Growth+ | Registro de auditoria da org | Anual | Arquivo de época de impostos |
| Qualquer | Histórico de importações | Após cada lote grande de importação | Para ter o CSV de erros de linha antes da janela de 30 dias de deleção de arquivo |
| Qualquer | Atividade do membro para casos de RH | Ad-hoc | Documentar o ciclo de vida de uma pessoa específica |
O que você não pode exportar
- O registro de auditoria da plataforma não é acessível a orgs; apenas equipe Genius Church Manager. Se você tem uma solicitação regulatória que o requer, contate o suporte — podemos fornecer um extrato com escopo para seu tenant.
- Valores antes/depois das colunas não são armazenados, então não estão no export. O campo
changed_columnsdiz o quê mudou; o estado atual da linha mais backups de banco de dados dizem os valores. - Registros de acesso de leitura não existem neste produto. Rastreamento de visualização é um add-on enterprise; contate o suporte se seu programa de conformidade o exige.
Armazenar exports com segurança
Dados CSV de auditoria contêm nomes de membros, histórico de edição, e (em histórico de importações) potencialmente PII dos seus arquivos de origem. Trate exports da mesma forma que um backup de banco de dados de membros:
- Criptografe em repouso se você está armazenando fora de um serviço gerenciado.
- Mantenha-os em uma pasta com acesso restrito — não um drive compartilhado que todos podem ler.
- Retenha apenas pelo tempo que sua política de retenção exigir; exclua execuções mais antigas uma vez que uma mais recente é arquivada.
WARNING
Não cole linhas de registro de auditoria em e-mails, Slack ou ferramentas de IA. Elas contêm e-mails de atores e IDs de entidade que podem ser cruzados de volta para pessoas. Se você precisa compartilhar uma entrada para um caso de suporte, redija o e-mail do ator e ID da entidade primeiro — a equipe de suporte pode procurar a mesma linha por id ou created_at.
E quanto a backups?
Tabelas de registro de auditoria estão incluídas no backup diário do Postgres que protege os dados da sua org. Backups são recuperáveis ponto-no-tempo por 7 dias no Growth, 14 dias no Network, e 30 dias no Unlimited. Backups são a ferramenta certa para "preciso do banco de dados como estava nessa data"; exports CSV são a ferramenta certa para "preciso revisar o registro em uma planilha."
Veja também
- Registro de auditoria da organização para a fonte do export
- Histórico de importações para o CSV por job
- API para acesso programático