Monitorar o status de execuções do fluxo de trabalho, examinar o histórico de execuções do gatilho e do fluxo de trabalho e configurar alertas nos Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)

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 ISE (ambiente de serviço de integração) 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.

    Screenshot shows Overview pane for Consumption logic app workflow with selected option named Trigger history.

    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.

    Screenshot shows Overview pane with Consumption logic app workflow and multiple trigger attempts for different items.

    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.

    Screenshot shows Consumption workflow trigger entry selected.

    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:

    Screenshot shows selected Consumption workflow trigger history information.

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.

    Screenshot shows Consumption workflow and Overview page with selected option for Runs history.

    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 tempo de execução 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, ao reduzir o limite da duração de uma execução em andamento, a execução atingirá o tempo limite. No entanto, ela permanecerá ou será desmarcada do histórico de execuções se o tempo de execução tiver excedido 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.

    Screenshot shows Consumption workflow run selected.

    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:

    Screenshot shows each action in the selected workflow run.

    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.

    Screenshot shows toolbar named Logic app run with the selected option Run Details.

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

    Screenshot showing the run details for each step in the workflow.

    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:

      Screenshot showing the

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

      Screenshot showing the

    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 usadas anteriormente pelo fluxo de trabalho ao reenviar a execução nos Aplicativos Lógicos do Azure. Concluir essa tarefa cria e adiciona uma nova execução de fluxo de trabalho ao histórico de execução do fluxo de trabalho.

Observação

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.

  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.

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.

    Por exemplo, para enviar um alerta quando um gatilho falhar, 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:

      Screenshot shows the alert rule condition.

  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