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 criar e executar um fluxo de trabalho de aplicativo lógico, você pode verificar o status de execuções, o histórico de gatilhod, o histórico de execuções do fluxo de trabalho e o desempenho do fluxo de trabalho.
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 monitorar e examinar o status de execução do fluxo de trabalho para fluxos de trabalho Standard, confira as seções a seguir em Criar um exemplo de fluxo de trabalho de aplicativo lógico Standard nos Aplicativos Lógicos do Azure de locatário único:
- Examinar histórico de gatilho
- Examine o histórico de execuções do fluxo de trabalho.
- Habilite ou abra o Application Insights após a implantação.
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 de aplicativo lógico e o fluxo de trabalho no designer.
No menu do aplicativo lógico, selecione Visão geral. No painel Visão geral, selecione Histórico 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 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 do painel Visão geral ou na barra de ferramentas do designer, selecione Executar Gatilho>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 é disparado com êxito, os Aplicativos Lógicos do Azure criam uma instância de fluxo de trabalho e a executa. 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 de aplicativo lógico 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.
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 restrita devido a 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 tempo de execução, que é controlado pela configuração Retenção do histórico de execuções em dias. A duração de uma execução é calculada usando a hora de início e o limite de tempo de execução na hora de início.
Observação: se o runtime também exceder o limite de retenção do histórico de execução atual, que também é controlado pela configuração Retenção do histórico de execução em dias, a execução será 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á em pausa, 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.
Dica
Se o status de execução não for exibido, tente atualizar o painel de visão geral selecionando Atualizar. A execução de um gatilho ignorado não é realizada devido a critérios não cumpridos ou se não localizar dados.
O painel execução do aplicativo lógico mostra cada etapa na execução selecionada, o status de execução de cada etapa e o tempo necessário para cada etapa ser executada, por exemplo:
Para exibir essas informações em formulário de lista, na barra de ferramentas de execução do aplicativo lógico , selecione detalhes da execução.
Os Detalhes de Execução listam cada etapa, seu status e outras informações.
Por exemplo, você pode obter a ID de Correlação adequado da execução, que pode ser útil ao usar a API REST dos Aplicativos Lógicos.
Para obter mais informações sobre uma etapa específica, selecione uma das opções:
No painel de execução do aplicativo lógico, selecione a etapa para que a forma se expanda. Agora você pode exibir informações como entradas, saídas e erros que ocorreram nessa etapa.
Por exemplo, suponha sua ação falhou e você queria examinar quais entradas podem ter causado a falha dessa etapa. Ao expandir a forma, você pode exibir as entradas, as saídas e o erro dessa etapa:
No painel de detalhes de execução do aplicativo lógico, selecione a etapa desejada.
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ção ou controlar o acesso do usuário a essas informações usando o controle de acesso baseado em função do Azure (RBAC 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 de aplicativo lógico 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.
No painel Histórico de execuções, selecione a execução que você deseja reenviar.
Na barra de ferramentas Executar aplicativo lógico, selecione Reenviar e, em seguida, selecione Sim.
O painel Histórico de execuções agora mostra a execução reenviada.
Dica
Se a execução reenviada não aparecer, na barra de ferramentas do painel Histórico de execuções, selecione Atualizar. A execução de um gatilho ignorado não é realizada devido a critérios não cumpridos ou se não localizar dados.
Para examinar as entradas e saídas da execução do fluxo de trabalho reenviado, na guia Histórico de Execuções, selecione essa execução.
Repetir a partir de uma ação específica
O recurso de repetição está disponível para todas as ações, exceto para cenários de simultaneidade não sequenciais e complexos e de acordo com 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 |
Abra o recurso de aplicativo lógico no portal do Azure.
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 você deseja reenviar.
A página de detalhes da execução é aberta e mostra o status de cada etapa na execução.
Na página de detalhes da execução, localize a ação de onde você deseja reenviar a execução do fluxo de trabalho, abra o menu de atalho e selecione Enviar desta ação.
A página de detalhes da execução é atualizada e mostra a nova execução. 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 geralmente coloridos. Para obter mais informações, consulte Examinar o histórico de execução do fluxo de trabalho.
Dica
Se a execução ainda não tiver sido totalmente concluída, na barra de ferramentas da página de detalhes da execução, selecione Atualizar.
Configurar alertas de monitoramento
Para obter alertas baseados em métricas específicas ou limites excedidos do aplicativo lógico, configure alertas no Azure Monitor. Para obter mais informações, examine as 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 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 disponíveis diferem entre o consumo e os aplicativos lógicos 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.