Quando uma página do Notion exibe um erro de sincronização ou uma visualização de banco de dados não atualiza, a causa geralmente está oculta no Activity Log. O Activity Log registra todas as alterações feitas em um espaço de trabalho, incluindo tentativas de sincronização com falha de integrações de terceiros, permissões incorretas ou edições conflitantes. Este artigo explica como localizar o Activity Log, interpretar entradas de falha de sincronização e tomar ações corretivas com base nos dados do log.
Falhas de sincronização no Notion podem ser causadas por interrupções de rede, tokens de API expirados ou alterações de permissão em bancos de dados compartilhados. O Activity Log armazena um histórico com carimbo de data/hora desses eventos, permitindo identificar exatamente quando e onde ocorreu uma falha. Ao auditar essas entradas, você pode resolver problemas mais rapidamente e evitar futuros problemas de sincronização.
Abaixo você encontrará um guia passo a passo para acessar o Activity Log, filtrar por falhas de sincronização e usar as informações para corrigir o problema subjacente. Você também aprenderá o significado de cada entrada de log e como distinguir entre uma pequena falha de sincronização e um erro crítico de integração.
Principais Conclusões: Auditando Falhas de Sincronização no Notion
- Configurações e Membros > Configurações > Activity Log: Exibe todos os eventos do espaço de trabalho, incluindo falhas de sincronização de integrações e alterações de permissão.
- Filtrar por tipo de evento ou intervalo de datas: Isola entradas relacionadas à sincronização para que você veja exatamente quando e por que uma falha ocorreu.
- Clique em uma entrada de log para ver detalhes: Revela a página afetada, o nome da integração e a mensagem de erro, como “token de API expirado” ou “página não encontrada”.
O que o Activity Log Registra e Por Que as Falhas de Sincronização Aparecem
O Activity Log no Notion é uma trilha de auditoria centralizada que captura todas as ações realizadas em um espaço de trabalho. Isso inclui edições de páginas, adições de membros, alterações de permissão e eventos de integração. Quando uma ferramenta de terceiros como Zapier, Slack ou Google Drive tenta sincronizar dados com um banco de dados do Notion, o Activity Log registra se essa sincronização foi bem-sucedida ou falhou.
Falhas de sincronização geralmente aparecem no log como entradas com status “falhou” ou “erro”. A entrada de log incluirá o nome da integração, a página ou banco de dados afetado e uma breve descrição do erro. Causas comuns para falhas de sincronização incluem:
- Tokens de API expirados ou revogados para a integração
- Alterações de permissão que removeram o acesso da integração a uma página
- Tempos limite de rede ou limites de taxa do provedor de integração
- Edições conflitantes feitas por dois usuários simultaneamente
Ao revisar regularmente o Activity Log, você pode detectar essas falhas precocemente e tomar medidas corretivas antes que os dados fiquem desatualizados. O log retém eventos por até 90 dias, dependendo do seu plano de espaço de trabalho.
Passos para Auditar Falhas de Sincronização no Activity Log
Siga estes passos para localizar, filtrar e interpretar entradas de falha de sincronização no Activity Log do Notion. Execute estas ações como proprietário ou administrador do espaço de trabalho.
- Abra o Activity Log
Vá para Configurações e Membros na barra lateral esquerda. Clique em Configurações e depois selecione Activity Log no menu à esquerda. O log exibe os eventos mais recentes primeiro. - Filtre por tipo de evento
Clique no menu suspenso Tipo de evento no topo do log. Selecione Eventos de integração ou Alterações de permissão para restringir a lista a entradas relacionadas à sincronização. Você também pode filtrar por um nome de integração específico se souber qual ferramenta está falhando. - Filtre por intervalo de datas
Clique no filtro Intervalo de datas e escolha um período como as últimas 24 horas ou os últimos 7 dias. Isso ajuda a focar em falhas recentes que ainda podem estar afetando seu fluxo de trabalho. - Identifique entradas com status de falha
Role pela lista filtrada. Procure por entradas que exibam um ícone vermelho ou a palavra Falhou ao lado da descrição do evento. Essas são falhas de sincronização. - Clique na entrada para ver detalhes
Clique em qualquer entrada com falha. Um painel lateral será aberto mostrando o nome da página afetada, o nome da integração, o carimbo de data/hora exato e a mensagem de erro. Por exemplo, você pode ver “Acesso negado: token de API para Zapier é inválido.” - Tome medidas corretivas com base no erro
Se o erro disser “token de API expirado”, vá para a página de configurações da integração no Notion em Configurações e Membros > Conexões. Desconecte a integração e reconecte-a com um token novo. Se o erro disser “Página não encontrada”, verifique se a integração ainda tem acesso à página. Compartilhe novamente a página com a integração, se necessário.
Se o Activity Log Não Mostrar a Falha de Sincronização
Às vezes, uma falha de sincronização ocorre, mas não aparece no Activity Log. Isso pode acontecer quando a própria integração não reporta a falha de volta ao Notion. Nesses casos, você deve verificar os logs da própria integração ou o painel de erros. Por exemplo, Zapier e Make fornecem um histórico de execuções de tarefas que mostram status de sucesso ou falha.
Os logs da própria integração mostram um erro diferente
Se o Activity Log mostrar uma sincronização bem-sucedida, mas seus dados estiverem ausentes ou desatualizados, o problema pode estar no lado da integração. Abra a página de histórico da integração e procure por avisos ou falhas parciais. Por exemplo, o Zapier pode mostrar que uma tarefa foi concluída, mas os dados foram enviados para o banco de dados errado do Notion. Nesse caso, atualize a configuração de mapeamento da integração.
A entrada do Activity Log é muito vaga
Algumas entradas de log exibem um erro genérico como “Falha na sincronização” sem um motivo detalhado. Quando isso acontecer, execute novamente a sincronização manualmente pela interface da integração e observe se aparece uma mensagem de erro mais específica. Você também pode tentar desconectar e reconectar a integração no Notion em Configurações e Membros > Conexões.
Alterações de permissão causam falhas silenciosas
Se as permissões de uma página forem alteradas para remover o acesso da integração, o Activity Log registrará a alteração de permissão, mas não necessariamente a marcará como uma falha de sincronização. Para capturar isso, filtre o log por Alterações de permissão e procure por eventos que removeram o acesso de uma integração ou de uma conta de convidado. Restaure o acesso da integração compartilhando novamente a página.
Limites do Activity Log do Notion para Diferentes Planos
| Plano | Período de Retenção do Log | Opção de Exportação |
|---|---|---|
| Free | 30 dias | Sem exportação |
| Plus | 90 dias | Exportação CSV disponível |
| Business | 90 dias | Exportação CSV disponível |
| Enterprise | Personalizado (até 1 ano) | Exportação CSV e acesso via API |
No plano Free, você só pode ver os últimos 30 dias de atividade. Se precisar auditar falhas de sincronização mais antigas, atualize para Plus ou Business para acessar o histórico completo de 90 dias. Clientes Enterprise podem solicitar períodos de retenção mais longos ao gerente de conta.
Exportar o Activity Log como um arquivo CSV permite que você pesquise padrões de erro específicos em uma planilha. Para exportar, vá para Configurações e Membros > Configurações > Activity Log e clique no botão Exportar no canto superior direito. O CSV inclui colunas para carimbo de data/hora, tipo de evento, usuário e nome da página.
Agora você pode usar o Activity Log para rastrear falhas de sincronização, interpretar as mensagens de erro e corrigir a causa raiz. Comece verificando o log diariamente em busca de eventos de integração com falha. Se encontrar um erro recorrente, considere configurar uma notificação no Slack ou por e-mail que o alerte quando uma nova falha for registrada. Para auditoria avançada, combine a exportação do Activity Log com um script que sinalize erros repetidos da mesma integração.