---
title: Conexões e sincronização
description: Coleta de dados da Cloudflare pelo Advisor, tipos de sincronização, agendamento e estados da conexão.
updated: 2026-09-27
---

Uma conexão é o vínculo, somente leitura, entre o seu tenant e uma conta Cloudflare. Por meio dela, o Advisor coleta métricas, configuração, alterações e registros DNS.

## Estados da conexão

| Estado | Significado |
|---|---|
| **Conectada** | A coleta funciona normalmente. |
| **Pendente** | A conexão foi criada e ainda não concluiu a primeira coleta. |
| **Erro** | A última tentativa falhou, por exemplo por token revogado. A coleta fica pausada até a correção. |
| **Desativada** | A conexão está desativada e não coleta dados. |

Atualmente, cada tenant tem uma conexão por provedor.

## Os quatro tipos de sincronização

| Tipo | O que traz | Onde aparece |
|---|---|---|
| **Métricas** | Tráfego, WAF e planos do período | Visão Geral, Zonas, Tráfego |
| **Postura** | Configurações e regras de segurança das zonas; recalcula a nota | Score, Riscos, Postura consolidada |
| **Alterações** | O registro de quem mudou o quê na conta Cloudflare | Alterações |
| **DNS** | Registros das zonas e sondagem de exposição das origens. É o tipo mais demorado | Inventário, aba Registros DNS |

## Quando a coleta roda

- **Primeira coleta:** entra na fila assim que a conexão é criada. As métricas são buscadas retroativamente até 12 meses.
- **Coleta agendada:** uma vez por dia, às 02:00 (horário de Brasília), com os quatro tipos. O horário não é configurável.
- **Sincronização manual:** acesse **Integrações** > **Sincronizar**, escolha os tipos e selecione **Iniciar sync**.

:::availability
A sincronização manual exige a permissão `connections.scan`, que não vem nos papéis padrão do tenant. Sem ela, os dados são atualizados na coleta das 02:00. Para obter a permissão, entre em contato com a Guardnet.
:::

Enquanto uma coleta roda, o Advisor mostra **Sincronização em andamento**, e o menu mostra os tipos em **Sincronizando** e **Na fila**.

## Coleta incompleta

Uma coleta pode terminar sem parte dos dados, por exemplo quando falta uma permissão no token. A tela **Integrações** avisa "coleta(s) vieram incompletas" e a linha da conexão mostra **Coleta incompleta** com o motivo. Somente os dados ausentes ficam defasados nas telas. Os demais estão atualizados.

Quando a coleta falha por completo, o aviso é "sincronização(ões) falharam" e a conexão passa a **Erro**.

## Histórico guardado

| Dado | Janela |
|---|---|
| Métricas nas telas | 24 meses |
| Alterações da conta Cloudflare | Até 18 meses (limite da Cloudflare) |

Para criar a conexão, consulte [Conectar a Cloudflare](/pt-br/advisor/primeiros-passos/conectar-cloudflare/). Outros prazos estão em [Limites e prazos](/pt-br/advisor/referencia/limites-e-prazos/).

---

> Guardnet Docs · https://docs.guardnet.com.br/pt-br/advisor/conceitos/conexoes-e-sincronizacao/
> Índice da documentação: https://docs.guardnet.com.br/pt-br/llms.txt