Compartilhar via


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:

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:

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.

Observação

Se o seu fluxo de trabalho for executado em um Ambiente de serviço de integração (ISE) que foi criado para usar um ponto de extremidade de acesso interno, você poderá exibir e acessar entradas e saídas de um histórico de execuções de fluxo de trabalho somente de dentro de sua rede virtual. Verifique se você tem conectividade de rede entre os pontos de extremidade privados e o computador no qual você deseja acessar o histórico de execução. Por exemplo, o computador cliente pode existir dentro da rede virtual do ISE ou dentro de uma rede virtual conectada à rede virtual do ISE, por exemplo, por meio de emparelhamento ou de uma rede virtual privada. Para obter mais informações, confira Acesso do ponto de extremidade do ISE.

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.

  1. No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.

  2. No menu do aplicativo lógico, selecione Visão geral. No painel Visão geral, selecione Histórico de gatilhos.

    A captura de tela mostra o painel Visão geral do fluxo de trabalho do aplicativo lógico de Consumo com a opção selecionada chamada 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 captura de tela mostra o painel Visão geral com o fluxo de trabalho do aplicativo lógico de Consumo e várias tentativas do gatilho para diferentes itens.

    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.

  3. Para exibir informações sobre uma tentativa de gatilho específica, selecione esse evento de gatilho.

    A captura de tela mostra a entrada do gatilho do fluxo de trabalho de Consumo selecionada.

    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:

    A captura de tela mostra as informações do histórico de gatilhos do fluxo de trabalho de Consumo selecionado.

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.

  1. No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.

  2. 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 captura de tela mostra o fluxo de trabalho de Consumo e o painel Visão geral com a opção selecionada para Histórico de execuções.

    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.
  3. 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.

    A captura de tela mostra a execução do fluxo de trabalho de Consumo selecionado.

    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:

    A captura de tela mostra cada ação na execução do fluxo de trabalho selecionado.

    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.

    A captura de tela mostra a barra de ferramentas chamada Execução do aplicativo lógico com a opção Detalhes da execução selecionada.

    Os Detalhes de Execução listam cada etapa, seu status e outras informações.

    Captura de tela mostrando os detalhes da execução para cada etapa no fluxo de trabalho.

    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.

  4. 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:

      Captura de tela mostrando o painel

    • No painel de detalhes de execução do aplicativo lógico, selecione a etapa desejada.

      Captura de tela mostrando o painel

    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

  1. No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.

  2. 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.

  3. No painel Histórico de execuções, selecione a execução que você deseja reenviar.

  4. 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.

  5. 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.

Executar novamente de uma ação específica (versão prévia)

Observação

Essa funcionalidade está na versão prévia. Para termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou ainda não lançados em disponibilidade geral, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure. Alguns aspectos dessa funcionalidade podem mudar antes da GA (disponibilidade geral).

A funcionalidade de reenviamento 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
  1. Abra o recurso de aplicativo lógico no portal do Azure.

  2. 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.

  3. 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.

  4. 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:

  1. No menu do aplicativo lógico, em Monitoramento, selecione Alertas. Na barra de ferramentas, selecione Criar>Regra de alerta.

  2. 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:

    1. Na lista Nome do sinal, selecione o sinal Gatilhos com Falha.

    2. 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

    3. 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:

      Captura de tela que mostra o aplicativo lógico de Consumo e a condição da regra de alerta.

  3. 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.

Próximas etapas