Monitoramento de execuções
Toda vez que um gatilho dispara, o GCM cria uma execução de fluxo de trabalho — uma única tentativa de execução para um único sujeito. A página de Execuções mostra o histórico, filtrável por fluxo de trabalho, status, data e sujeito.
Abrir a página de execuções
Em Fluxos de trabalho → Execuções. A visão padrão mostra todas as execuções dos últimos 7 dias, ordenadas pela mais recente.
Status da execução
Uma execução pode estar em um dos estados:
| Status | Significado |
|---|---|
| Na fila | Criada, ainda não iniciada |
| Em execução | Executando ações ativamente |
| Aguardando | Pausada em um wait_delay, wait_until ou wait_event |
| Concluída | Todas as ações terminaram |
| Falhou | Uma ação falhou e a execução foi abortada |
| Cancelada | Um humano cancelou |
| Pulada | O gatilho disparou mas um filtro no nível do fluxo de trabalho excluiu o sujeito |
O status atualiza quase em tempo real. Atualize a página ou espere alguns segundos para ver mudanças.
Filtragem
A barra de filtros permite estreitar por:
- Fluxo de trabalho — um ou vários
- Status
- Faixa de datas
- Sujeito — um membro específico
- Disparado por — execuções manuais mostram o admin que iniciou
O estado do filtro codificado na URL significa que você pode compartilhar um link para uma visão filtrada específica.
A página de detalhe da execução
Clique em qualquer execução para ver a linha do tempo das execuções de ações. Para cada etapa:
- Nome da ação — o que rodou.
- Iniciada em — quando começou.
- Terminada em — quando terminou (ou "Ainda em execução…").
- Status — sucesso, falha, pulada.
- Saída — os dados de resultado que a ação produziu.
- Mensagem de erro — para falhas.
Se a execução está pausada em um atraso, a linha do tempo mostra a etapa de espera com um carimbo "retoma em".
Depurar uma falha
Uma execução falha geralmente tem um de:
| Padrão de erro | Causa provável |
|---|---|
Permission denied | O fluxo de trabalho tentou modificar um registro fora da sua organização ou escopo. |
Provider returned 4xx | Um provedor de mensageria rejeitou o envio (número ruim, opt-out, conta suspensa). |
Merge token resolved to empty | Um token referenciou um campo que está nulo no sujeito. |
Condition evaluation failed | Uma expressão de condição tinha um problema de sintaxe. |
Webhook timeout | Um sistema externo não respondeu dentro do timeout. |
A página de detalhes mostra o erro completo da ação incluindo qualquer código de resposta do provedor. Clique no nó da ação para pular de volta para o construtor e inspecionar a configuração.
Tentar de novo
Para falhas transitórias (provedor 500, queda de rede), você pode tentar de novo uma execução falha pela página de detalhes. A nova tentativa começa na ação que falhou — etapas anteriores bem-sucedidas não são re-executadas.
WARNING
Para fluxos não idempotentes que você já completou parcialmente (ex.: mensagem meio enviada), tentar de novo pode produzir efeitos colaterais duplicados. O botão de tentar de novo te avisa quando o fluxo de trabalho já produziu efeitos colaterais.
Cancelar
Uma execução nos status Na fila, Em execução ou Aguardando pode ser cancelada. A ação que estava prestes a rodar é pulada; a execução termina no status Cancelada. Ações subsequentes não disparam.
Use o cancelamento quando você notar um bug em pleno deploy e não quiser que centenas de mensagens erradas saiam.
Cancelamento em massa
Se você perceber que um fluxo de trabalho tem um bug e 500 execuções estão em andamento, pode cancelar em massa pela página de detalhes do fluxo de trabalho. Cancelar todas as execuções pendentes para tudo daquele fluxo de trabalho.
Painel de insights
O topo da página de Execuções tem insights agregados:
- Execuções nas últimas 24 horas — contagem total
- Taxa de sucesso — concluídas vs falhas
- Duração média — para execuções síncronas (excluindo atrasos)
- Ações com mais falha — quais ações falham com mais frequência (bom para priorizar correções)
Esses tiles são filtrados pela sua seleção de filtro no topo da página.
Permissões
| Ação | Admin | Pastor | Membro |
|---|---|---|---|
| Ver lista de execuções | sim | restrito à unidade | não |
| Ver detalhe da execução | sim | restrito | não |
| Tentar de novo uma execução falha | sim | não | não |
| Cancelar uma execução | sim | não | não |
Pastores veem execuções para membros no seu escopo — útil quando querem confirmar "o novo visitante recebeu a mensagem de boas-vindas" sem acesso de admin.
Retenção
O histórico de execuções é mantido por 90 dias. Execuções mais antigas são purgadas todas as noites. As estatísticas agregadas (contagens de execuções, taxa de sucesso) são mantidas indefinidamente para que relatórios continuem precisos, mas o detalhe por etapa some.
TIP
Se você precisa de auditoria de longo prazo dos efeitos dos fluxos de trabalho, os próprios efeitos colaterais (mensagens, atualizações de membros) são mantidos em seus respectivos logs (log de comunicação, log de atividades). O limite de 90 dias é só para o encanamento da execução do fluxo de trabalho.
Perguntas comuns
Por que minha execução está presa em "Aguardando"? Confira a etapa ativa — quase sempre é um wait_delay ou wait_event. A página de detalhes mostra quando vai retomar.
Por que execuções para um fluxo de trabalho são muito mais lentas que outro? Geralmente porque o fluxo de trabalho tem ações lentas (webhooks externos, loops grandes de segmentos). A divisão de duração na página de detalhe da execução mostra qual etapa está demorando mais.
Posso ver execuções para um fluxo de trabalho excluído? Sim — fluxos de trabalho excluídos ficam no filtro de execuções (acinzentados). Execuções históricas são mantidas por 90 dias independentemente da exclusão do fluxo de trabalho.
Próximos passos
- Construtor visual — corrigir os problemas que você encontrar aqui.
- Multi-etapa e atrasos — entender os estados de espera.
- Ações — depurar falhas específicas de ações.