Verificar o status do fluxo de trabalho, exibir o histórico de execuções e configurar alertas nos Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)
Depois de executar um fluxo de trabalho de aplicativo lógico, você pode verificar o status de execução do fluxo de trabalho, o histórico de gatilhos, o histórico de execuções de fluxo de trabalho e o desempenho.
Este guia mostra como executar as seguintes tarefas:
- Examine o histórico de gatilhos.
- Examine o histórico de execuções do fluxo de trabalho.
- Configure alertas para receber notificações sobre falhas ou outros possíveis problemas. Por exemplo, você pode criar um alerta que detecte "quando mais de cinco execuções falharem em uma hora".
Para monitoramento de eventos em tempo real e depuração mais avançada, você pode configurar o log de diagnósticos para o fluxo de trabalho do aplicativo lógico usando os logs do Azure Monitor. O Azure Monitor ajuda a monitorar os ambientes locais e na nuvem para que seja possível manter, mais facilmente, a disponibilidade e o desempenho deles. Dessa forma, você poderá encontrar e exibir eventos, como eventos de gatilho, execução e ação. Ao armazenar essas informações em logs do Azure Monitor, é possível criar consultas de log que ajudam a localizar e analisar tais informações. Também é possível usar esses dados de diagnóstico com outros serviços do Azure, como o Armazenamento e os Hubs de Eventos do Azure. Para obter mais informações, consulte monitorar aplicativos lógicos usando Azure monitor.
Examinar histórico de gatilho
Cada execução de fluxo de trabalho começa com um gatilho, que é acionado em um agendamento ou aguarda uma solicitação ou evento de entrada. Esse histórico de gatilhos relaciona todas as tentativas de disparo que o fluxo de trabalho realizou e informações sobre as entradas e saídas para cada tentativa de disparo.
No portal do Azure, abra o recurso do aplicativo lógico de consumo e o fluxo de trabalho no designer.
No menu do aplicativo lógico, selecione Visão geral. Na página de Visão geral, selecione Históricos de gatilhos.
No Histórico de gatilho, todas as tentativas de gatilho são exibidas. Sempre que o gatilho for acionado com êxito, os Aplicativos Lógicos do Azure criam uma instância de fluxo de trabalho individual e executam essa instância. Por padrão, cada instância é executada em paralelo para que nenhum fluxo de trabalho precise esperar para iniciar uma execução. Se o fluxo de trabalho acionar vários eventos ou itens ao mesmo tempo, uma entrada de gatilho será exibida para cada item com a mesma data e hora.
A tabela seguinte lista os possíveis status do gatilho:
Status do gatilho Descrição Falha Ocorreu um erro. Para examinar as mensagens de erro geradas para um gatilho com falha, selecione essa tentativa do gatilho e escolha Saídas. Por exemplo, você pode descobrir entradas que não são válidas. Ignorado O gatilho verificou o ponto de extremidade, mas não encontrou dados que atendem aos critérios especificados. Êxito O gatilho verificou o ponto de extremidade e encontrou dados disponíveis. Normalmente, um status de Disparado também é exibida junto com esse status. Caso contrário, a definição do gatilho pode ter uma condição ou um comando SplitOn que não foi atendido.
Esse status pode se aplicar a um gatilho manual, gatilho baseado em recorrência ou gatilho de sondagem. Um gatilho pode ser executado com êxito, mas a execução em si ainda pode falhar quando as ações gerarem erros sem tratamento.Dica
Você pode verificar novamente o gatilho sem aguardar a próxima recorrência. Na barra de ferramentas da página Visão geral ou na barra de ferramentas do designer, selecione Executar, Executar.
Para exibir informações sobre uma tentativa de gatilho específica, selecione esse evento de gatilho.
Se a lista mostrar muitas tentativas de disparo e não for possível localizar a entrada que você deseja, experimente filtrá-la. Se você não encontrar os dados esperados, experimente selecionar Atualizar na barra de ferramentas.
Agora você pode examinar informações sobre o evento de gatilho selecionado, por exemplo:
Avalie o histórico de execução do fluxo de trabalho
Sempre que um gatilho é acionado com êxito, os Aplicativos Lógicos do Azure criam uma instância de fluxo de trabalho e executam essa instância. Por padrão, cada instância é executada em paralelo para que nenhum fluxo de trabalho precise esperar para iniciar uma execução. É possível examinar o que aconteceu durante cada execução, incluindo o status, as entradas e as saídas de cada etapa no fluxo de trabalho.
No portal do Azure, abra o recurso do aplicativo lógico de consumo e o fluxo de trabalho no designer.
No menu do aplicativo lógico, selecione Visão geral. Na página de Visão Geral, selecione Histórico de execuções.
No Histórico de execuções, todas as execuções passadas, atuais e em espera são exibidas. Se o gatilho acionar vários eventos ou itens ao mesmo tempo, uma entrada será exibida para cada item com a mesma data e hora.
Dica
Se o status de execução não aparecer, tente atualizar a página Visão Geral selecionando Atualizar. Nenhuma execução ocorre para um gatilho que é ignorado devido a critérios não atendidos ou não encontrando dados.
A tabela seguinte lista os possíveis status de execução:
Status da execução Descrição Anulado A execução foi interrompida ou não foi concluída devido a problemas externos, como uma interrupção do sistema ou uma assinatura do Azure vencida. Cancelado A execução foi disparada e iniciada, mas recebeu uma solicitação de cancelamento. Com falha Falha em pelo menos uma ação na execução. Não foi configurada nenhuma ação subsequente no fluxo de trabalho para lidar com a falha. Executando A execução foi disparada e está em andamento. No entanto, esse status também pode aparecer para uma execução limitada devido aos limites de ação ou ao plano de preços atual.
Dica: ao configurar o log de diagnósticos, é possível receber informações sobre os eventos de restrição que ocorrerem.Êxito A execução foi bem-sucedida. Se alguma ação falhar, uma ação subsequente no fluxo de trabalho lidou com essa falha. Tempo limite atingido A execução atingiu o tempo limite porque a duração atual excedeu o limite de duração da execução, que é controlado pela configuração chamada Retenção do histórico de execuções em dias. A duração da execução é calculada usando a hora de início da execução e o limite de duração da execução nessa hora de início.
Observação: se a duração da execução também exceder o limite de retenção do histórico de execuções atual, que também é controlado pela configuração chamada Retenção do histórico de execuções em dias, a execução é desmarcada do histórico de execuções por um trabalho de limpeza diário. Se a execução atingir o tempo limite ou for concluída, o período de retenção será calculado usando a hora de início e o limite de retenção atual da execução. Portanto, se você reduzir o limite de duração de uma execução no voo, a execução atingirá o tempo limite. No entanto, a execução permanece ou é desmarcada do histórico de execuções com base em se a duração da execução excedeu o limite de retenção.Aguardando A execução ainda não foi iniciada ou está pausada, por exemplo, devido a uma instância de fluxo de trabalho anterior que ainda está em execução. Para examinar as etapas e outras informações de uma execução específica, em histórico de execuções, selecione essa execução. Se a lista mostrar muitas execuções e não for possível localizar a entrada que você deseja, experimente filtrá-la.
A página de histórico de execuções é aberta e mostra o status de cada etapa na execução selecionada, por exemplo:
A tabela a seguir mostra os possíveis status que cada ação de fluxo de trabalho poderá ter e mostrar no portal:
Status da ação Ícone Descrição Anulado 
A ação foi interrompida ou não foi concluída devido a problemas externos, como uma interrupção do sistema ou uma assinatura do Azure vencida. Cancelado 
A ação estava em execução, mas recebeu uma solicitação de cancelamento. Com falha 
Falha na ação. Em execução 
A ação está em execução no momento. Ignorado 
A ação foi ignorada porque suas condições runAfter não foram atendidas, por exemplo, uma ação anterior falhou. Cada ação tem um objeto runAfterem que você pode configurar condições que devem ser atendidas antes que a ação atual possa ser executada.Êxito 
A ação foi concluída. Êxito com novas tentativas 
A ação foi concluída com êxito, mas somente após uma ou mais tentativas. Para examinar o histórico de repetição, na página de histórico de execuções, selecione essa ação para que você possa exibir as entradas e saídas. Tempo limite atingido 
A ação foi interrompida devido ao tempo limite especificado pelas configurações dessa ação. Aguardando 
Aplica-se a uma ação de webhook que está aguardando uma solicitação de entrada de um chamador. Para exibir as informações no formulário de lista, na barra de ferramentas do histórico de execuções, selecione Detalhes da execução.
O painel Detalhes de execução do aplicativo lógico lista cada etapa, seu status e outras informações.
Por exemplo, você pode obter a propriedade ID de Correlação da execução, que talvez seja necessária ao usar a API REST para Aplicativos Lógicos.
Para obter mais informações sobre uma etapa específica, selecione uma das opções:
Na página histórico de execuções, selecione uma etapa para abrir um painel que mostra as entradas, as saídas e os erros que ocorreram nessa etapa.
Por exemplo, suponha que você tenha um fluxo de trabalho com uma etapa com falha. Você deseja examinar as entradas que podem ter causado a falha da etapa.
Nesse cenário, a falha resultou de uma conexão inválida ou ausente com uma conta de email usada para enviar um email.
Na barra de ferramentas da página de histórico de execuções, selecione Detalhes da execução. No painel Detalhes de execução do aplicativo lógico que é aberto, selecione a etapa desejada, por exemplo:
Observação
Todos os detalhes e eventos de runtime são criptografados nos Aplicativos Lógicos do Azure e são descriptografados somente quando um usuário solicita a exibição desses dados. Você pode ocultar entradas e saídas no histórico de execuções do fluxo de trabalho ou controlar o acesso do usuário a essas informações usando o RBAC do Azure (controle de acesso baseado em função do Azure).
Executar novamente um fluxo de trabalho com as mesmas entradas
Você pode executar novamente um fluxo de trabalho concluído anteriormente com as mesmas entradas que o fluxo de trabalho usou anteriormente das seguintes maneiras:
Execute novamente todo o fluxo de trabalho.
Execute novamente o fluxo de trabalho começando em uma ação específica. A ação reenviada e todas as ações subsequentes são executadas normalmente.
Concluir essa tarefa cria e adiciona uma nova execução de fluxo de trabalho ao histórico de execução do fluxo de trabalho.
Limitações e considerações
Por padrão, há suporte apenas para fluxos de trabalho de Consumo e fluxos de trabalho com estado Standard, que registram e armazenam o histórico de execução. Para usar esses recursos com um fluxo de trabalho Standard sem estado, habilite o modo com estado. Para obter mais informações, consulte Habilitar o histórico de execuções para fluxos de trabalho sem estado e Habilitar o modo com estado para conectores sem estado.
O reenvio executa a mesma versão de fluxo de trabalho da execução original, mesmo que você tenha atualizado a definição do fluxo de trabalho.
Você pode reenviar somente ações de fluxos de trabalho sequenciais. Atualmente, não há suporte para fluxos de trabalho com caminhos paralelos.
O fluxo de trabalho deve ter um estado concluído, como Êxito, De Falha ou Cancelado.
O fluxo de trabalho deve ter 40 ações ou menos para você executar novamente a partir de uma ação específica.
Se o fluxo de trabalho tiver operações como operações de criação ou exclusão, reenviar uma execução poderá criar dados duplicados ou tentar excluir dados que não existem mais, resultando em um erro.
Atualmente, esses recursos não estão disponíveis com o Visual Studio Code ou a CLI do Azure.
Executar novamente todo o fluxo de trabalho
No portal do Azure, abra o recurso do aplicativo lógico de consumo e o fluxo de trabalho no designer.
No menu do aplicativo lógico, selecione Visão geral. Na página de Visão Geral, selecione Histórico de execuções.
No Histórico de execuções, todas as execuções passadas, atuais e em espera são exibidas. Se o gatilho acionar vários eventos ou itens ao mesmo tempo, uma entrada será exibida para cada item com a mesma data e hora.
Na página Histórico de execuções, selecione a execução que você deseja executar novamente e selecione Reenviar.
A guia Histórico de execuções adiciona a execução reenviada à lista de execuções.
Dica
Se a execução reenviada não aparecer, na barra de ferramentas da página Histórico de execuções, selecione Atualizar. Nenhuma execução ocorre para um gatilho que é ignorado devido a critérios não atendidos ou não encontrando dados.
Para examinar as entradas e saídas após a conclusão da execução reenviada, na guia Histórico de Execuções, selecione essa execução.
Repetir a partir de uma ação específica
A funcionalidade de ação de nova execução está disponível para a maioria das ações, exceto para fluxos de trabalho não sequenciais, cenários de simultaneidade complexos e as seguintes limitações:
| Ações | Reenviar disponibilidade e limitações |
|---|---|
| Ações e ações de condição nos caminhos True e False | - Sim para a ação Condição - Não para ações nos caminhos True e False |
| Para cada ação mais todas as ações dentro do loop, e após o loop | Não para todas as ações |
| Alternar a ação e todas as ações nos caminhos Padrão e Caso | - Sim para a ação Switch - Não para ações no caminho Padrão e caminhos Caso |
| Até a ação mais todas as ações dentro do loop, e após o loop | Não para todas as ações |
No portal do Azure, abra o recurso de aplicativo lógico de Consumo.
No menu de recurso do aplicativo lógico, selecione Visão Geral. No painel Visão geral, selecione Histórico de execuções, que mostra o histórico de execuções do fluxo de trabalho atual.
Na guia Histórico de execuções, selecione a execução que tem a ação de onde você deseja executar novamente o fluxo de trabalho.
A página histórico de execuções é aberta e mostra o status de cada etapa na execução selecionada.
Para executar novamente o fluxo de trabalho a partir de uma ação específica, escolha uma das opções:
Localize a ação de onde começar a executar novamente o fluxo de trabalho, abra o menu de atalho e selecione Enviar desta ação.
Selecione a ação de onde começar a executar novamente o fluxo de trabalho. No painel que é aberto, no nome da ação, selecione Enviar desta ação.
A página de histórico de execuções é atualizada e mostra a execução reenviada. Todas as operações que precedem a ação reenviada mostram um ícone de status de cor mais clara, representando entradas e saídas reutilizados. A ação reenviada e as ações subsequentes mostram os ícones de status coloridos. Para obter mais informações, consulte Examinar o histórico de execução do fluxo de trabalho.
Dica
Se a execução reenviada não terminar totalmente, na barra de ferramentas da página de detalhes da execução, selecione Atualizar.
Configurar alertas de monitoramento
Para obter alertas com base em métricas específicas ou limites excedidos em seu fluxo de trabalho, configure seu recurso de aplicativo lógico com alertas no Azure Monitor. Para obter mais informações, consulte Métricas no Azure.
Para configurar alertas sem usar o Azure Monitor, siga estas etapas, que se aplicam aos recursos de aplicativos lógicos Standard e de Consumo:
No menu de recursos do aplicativo lógico, em Monitoramento, selecione Alertas. Na barra de ferramentas, selecione Criar>Regra de alerta.
Na página Criar uma regra de alerta, na lista Nome do sinal, selecione o sinal para o qual você quer obter um alerta.
Observação
Os sinais de alerta diferem entre os aplicativos lógicos Consumo e Standard. Por exemplo, os aplicativos lógicos de Consumo têm muitos sinais relacionados a gatilhos, como Gatilhos concluídos e Gatilhos com falha, enquanto os fluxos de trabalho Standard têm os sinais Contagem concluída de gatilhos de fluxo de trabalho e Taxa de falha de gatilhos de fluxo de trabalho.
Por exemplo, para enviar um alerta quando um gatilho falhar em um fluxo de trabalho de Consumo, siga estas etapas:
Na lista Nome do sinal, selecione o sinal Gatilhos com Falha.
Em Lógica de alerta, configure sua condição, por exemplo:
Propriedade Valor de exemplo Limite Estático Tipo de agregação Count Operador Maior ou igual a Unidade Count Valor limite 1 A seção Versão prévia agora mostra a condição que você configurou, por exemplo:
Sempre que a contagem de Gatilhos com Falha for maior ou igual a 1
Em Quando avaliar, defina o agendamento para verificar a condição:
Propriedade Valor de exemplo Verificar a cada 1 minuto Período de retrospectiva 5 minutos Por exemplo, a condição finalizada é semelhante ao exemplo a seguir, e a página Criar uma regra de alerta agora mostra o custo de execução desse alerta:
Quando estiver pronto, selecione Examinar + Criar.
Para obter informações gerais, confiraCriar uma regra de alerta a partir de um recurso específico – Azure Monitor.