Flow Logging no Salesforce: pare de debugar Flow às cegas

Todo mundo que mantém Flow em produção já viveu a mesma cena: um registro não foi atualizado, o cliente reclama, e você não tem a menor ideia de por onde o Flow passou. O debug log tradicional não ajuda, porque ele expira e você teria que adivinhar o problema antes dele acontecer. O Flow Logging resolve exatamente esse ponto cego.

O Flow Logging é o recurso nativo do Salesforce que grava de forma persistente os dados de execução de cada Flow no Data Cloud. Uma vez ligado, ele registra tempo de conclusão, status e erros de cada elemento, sem você precisar prever a falha. Você monta relatórios com os report types FlowRun e FlowElementRun.

O problema real: Flow em produção sempre foi uma caixa-preta

O Flow ganhou terreno sobre o Apex porque é declarativo e rápido de montar. O preço escondido disso aparece quando algo falha em produção. O debug log padrão é volátil: você precisa ligar uma trace flag antes, ele cobre uma janela curta e depois some. Se o erro é intermitente, ou acontece só com um perfil específico às três da manhã, você fica tentando reproduzir no escuro. Não existia um registro contínuo de quantas vezes aquele Flow rodou, quanto tempo levou e onde parou.

O que o Flow Logging captura

Ligado, o Flow Logging grava para cada execução o horário de conclusão, o status e os erros, descendo até o nível de elemento. Esses dados vão para o Data Cloud, e é lá que a parte interessante acontece: você usa os dois report types que o recurso cria. E se a sua análise vive no Tableau, vale conhecer o Tableau MCP, que deixa agentes de IA consultarem esses dashboards com as permissões do usuário.

O FlowRun registra a execução inteira: cada vez que o Flow disparou, se terminou bem e quanto durou. Já o FlowElementRun quebra a mesma execução elemento por elemento, então você vê exatamente em qual decisão, atualização ou chamada o Flow gastou tempo ou estourou. Com isso, achar o elemento culpado deixa de ser adivinhação e vira um filtro de relatório.

Como ativar, na ordem certa

A ativação tem dois níveis, e pular o primeiro é o erro mais comum. No nível da org, você liga o log persistente em Flow Settings, na seção Advanced, ou pela aba Flow Logs dentro do app Automation. Só depois disso, dentro de cada Flow que você quer observar, aparece a caixa para ativar o log daquele Flow específico. Ative só nos Flows que importam, não em todos. Feito isso, um botão Open Details passa a dar acesso direto aos dados de execução daquele Flow.

O custo que ninguém lê na release note

Aqui está a parte que muda a decisão: ligar o Flow Logging consome créditos de Data Cloud. Ele exige uma org com Data Cloud habilitado e cobra pelo volume que grava. Em um Flow que dispara milhares de vezes por dia, isso não é detalhe de rodapé, é linha de custo. A recomendação prática é tratar o log persistente como ferramenta de investigação, não como monitoramento ligado o tempo todo em tudo. Ative no Flow suspeito, colete a evidência, resolva e desligue.

A alternativa gratuita que resolve 80% dos casos

Antes de gastar crédito, vale conhecer o Flow Embedded Analytics, que é gratuito. Ele mostra o total de execuções em cada elemento direto no canvas do Flow Builder, além de contagem de sucesso e falha e duração média por elemento na aba Analytics. Funciona em modo auto-layout para todos os tipos de Flow menos Screen Flows. Para a pergunta do dia a dia, qual elemento está falhando mais, ele já responde sem custo. O Flow Logging entra quando você precisa do detalhe execução a execução, com data e hora, para cruzar com um chamado específico.

O que vi ativando na org de demonstração

Na Vetra Distribuidora, a empresa fictícia que uso como org de demonstração deste portfólio, liguei o log num Flow de escalonamento de follow-up que às vezes não criava a tarefa esperada. Com o FlowElementRun, o elemento que falhava apareceu na primeira consulta: uma decisão que só entrava no caminho certo quando um campo estava preenchido, e em parte dos registros ele vinha vazio. Sem o log, isso seria uma tarde inteira tentando reproduzir. A lição que fica é sobre disciplina de custo: deixei o log ligado só naquele Flow, o tempo de coletar a evidência, e desliguei. Para monitoramento contínuo e proativo, o caminho continua sendo alertas em tempo real com Platform Events, que avisam no momento da falha em vez de esperar você abrir um relatório. Se algum termo aqui passou rápido, o glossário de Salesforce tem as definições curtas.

Perguntas frequentes

O Flow Logging é gratuito?

Não. O log persistente grava no Data Cloud e consome créditos enquanto está ligado, por isso exige uma org com Data Cloud habilitado. O Flow Embedded Analytics, que mostra execuções e duração por elemento no canvas, é a opção sem custo.

Como eu ativo?

Primeiro no nível da org, em Flow Settings na seção Advanced ou pela aba Flow Logs no app Automation. Depois, marque a caixa de log em cada Flow que você quer monitorar. Um botão Open Details passa a abrir os dados de execução.

Onde ficam os dados?

No Data Cloud. De lá você monta relatórios com os report types FlowRun, que registra a execução completa, e FlowElementRun, que detalha elemento por elemento.

Qual a diferença para o debug log tradicional?

O debug log é volátil e precisa de trace flag ligada antes do problema. O Flow Logging é persistente e contínuo, então captura a falha mesmo sem você ter previsto que ela ia acontecer.