Criar um exemplo de fluxo de trabalho de aplicativo lógico Standard usando o portal do Azure

  • Artigo

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

Este guia de instruções mostra como criar um exemplo de fluxo de trabalho executado nos Aplicativos Lógicos do Azure de locatário único. O fluxo de trabalho aguarda uma solicitação da Web de entrada e depois envia uma mensagem para uma conta de email. Especificamente, você criará um recurso de aplicativo lógico Standard e um fluxo de trabalho que contém os seguintes itens:

  • O gatilho Solicitação, que cria um ponto de extremidade que pode ser chamado e que pode lidar com as solicitações de entrada de qualquer chamador.
  • O conector do Outlook do Office 365, que fornece uma ação para enviar um email.

Quando você terminar, seu fluxo de trabalho irá se parecer com o seguinte exemplo de alto nível:

Captura de tela que mostra o portal do Azure, o exemplo de fluxo de trabalho de Consumo com o gatilho Solicitação e a ação do Outlook do Office 365.

É possível ter vários fluxos de trabalho em um aplicativo lógico Standard. Os fluxos de trabalho do mesmo aplicativo lógico e locatário são executados no mesmo processo que o runtime dos Aplicativos Lógicos do Azure. Portanto, eles têm recursos em comum e fornecem um melhor desempenho.

Dica

Para saber mais, você pode fazer estas perguntas ao Copilot no Azure:

  • O que são os Aplicativos Lógicos do Azure?
  • O que é um fluxo de trabalho de aplicativo lógico Standard?
  • O que é o gatilho Solicitação?
  • O que é o conector do Outlook do Office 365?

Para localizar o Azure Copilot, na barra de ferramentas do portal do Azure, selecione Copilot.

Os conectores deste exemplo são apenas dois conectores entre mais de 1.000 conectores que você pode usar em um fluxo de trabalho. Embora este exemplo seja baseado em nuvem, você pode criar fluxos de trabalho que integram uma ampla gama de aplicativos, dados, serviços e sistemas em ambientes de nuvem, locais e híbridos.

Para saber mais, confira a seguinte documentação:

Para criar um fluxo de trabalho de aplicativo lógico Padrão a partir de um modelo predefinido que siga um padrão comumente usado, confira Criar um fluxo de trabalho de aplicativo lógico Padrão a partir de um modelo predefinido.

Para criar e gerenciar um fluxo de trabalho de aplicativo lógico Standard usando outras ferramentas, confira Criar fluxos de trabalho Standard com o Visual Studio Code. Com o Visual Studio Code, você pode desenvolver, testar e executar fluxos de trabalho no seu ambiente de desenvolvimento local.

Pré-requisitos

Melhores práticas e recomendações

Para obter a capacidade de resposta e o desempenho ideais do designer, examine e siga estas diretrizes:

  • Use no máximo 50 ações por fluxo de trabalho. Exceder esse número de ações gera a possibilidade de desempenho mais lento do designer.

  • Considere dividir a lógica de negócios em vários fluxos de trabalho quando necessário.

  • Não tenha mais de 10 a 15 fluxos de trabalho por recurso de aplicativo lógico.

Mais fluxos de trabalho em seu aplicativo lógico aumentam o risco de tempos de carga mais longos, o que afeta negativamente o desempenho. Se você tiver aplicativos lógicos críticos que exigem implantações sem tempo de inatividade, considere configurar slots de implantação.

Criar um recurso de aplicativo lógico Padrão

  1. Entre no portal do Azure com sua conta do Azure.

  2. Na caixa de pesquisa do portal do Azure, insira aplicativos lógicos e selecione Aplicativos lógicos.

    Captura de tela que mostra a caixa de pesquisa do portal do Microsoft Azure com as palavras “aplicativos lógicos” e mostrando a seleção de “Aplicativos lógicos”.

  3. Na barra de ferramentas da página Aplicativos lógicos, selecione Adicionar.

    A página Criar Aplicativo Lógico é exibida e mostra as seguintes opções:

    Planejar Descrição
    Consumo Cria um recurso de aplicativo lógico compatível com apenas um fluxo de trabalho, que é executado em Aplicativos Lógicos do Azure multilocatário e usa o modelo de Consumo para cobrança.
    Standard Cria um recurso de aplicativo lógico compatível com vários fluxos de trabalho. Você tem as seguintes opções:

    - Plano de Serviço de Fluxo de Trabalho: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure com locatário único e usam o modelo Standard para cobrança.

    - Ambiente do Serviço de Aplicativo V3: os fluxos de trabalho são executados em Aplicativos Lógicos do Azure com locatário único e usam um plano de Ambiente do Serviço de Aplicativo para cobrança.

  4. Na página Criar Aplicativo Lógico, selecione Standard (Plano de Serviço de Fluxo de Trabalho).

  5. Na página Criar Aplicativo Lógico, na guia Básico, forneça as seguintes informações sobre seu recurso de aplicativo lógico:

    Propriedade Obrigatório Valor Descrição
    Assinatura Sim <Azure-subscription-name> Seu nome da assinatura do Azure.

    Este exemplo usa Pagamento Conforme o Uso.
    Grupo de Recursos Sim <Azure-resource-group-name> O grupo de recursos do Azure em que o seu aplicativo lógico e os recursos relacionados são criados. O nome desse recurso precisa ser exclusivo em todas as regiões e pode conter somente letras, números, hífens (-), sublinhados (_), parênteses (()) e pontos (.).

    Este exemplo cria um grupo de recursos chamado Fabrikam-Workflows-RG.
    Nome do Aplicativo Lógico Sim <logic-app-name> O nome do recurso do seu aplicativo lógico, que deve ser exclusivo em todas as regiões e pode conter apenas letras, números, hifens (-), sublinhados (_), parênteses (()) e pontos (.).

    Observação: o nome do seu aplicativo lógico recebe automaticamente o sufixo .azurewebsites.net, porque o recurso do aplicativo lógico Standard é alimentado pelo runtime dos Aplicativos Lógicos do Azure de locatário único, que usa o modelo de extensibilidade do Azure Functions e é hospedado como uma extensão no runtime do Azure Functions. O Azure Functions usa a mesma convenção de nomenclatura de aplicativo.

    Este exemplo cria um recurso de aplicativo lógico chamado Fabrikam-Workflows.
    Região Sim <Azure-region> A região do datacenter do Azure para o aplicativo lógico.

    Este exemplo usa Oeste dos EUA.
    Plano do Windows Yes <plan-name> O nome do plano a ser usado. Selecione o nome de um plano existente ou forneça o nome para um novo plano.

    Este exemplo usa o nome My-App-Service-Plan.

    Observação: não use um Plano de Serviço de Aplicativo baseado em Linux. Só há suporte para o Plano do Serviço de Aplicativo baseado no Windows.
    Plano de preços Yes <pricing-tier> A nível de preço a ser usado no seu aplicativo lógico e fluxos de trabalho. Sua seleção afeta o preço, a computação, a memória e o armazenamento que o aplicativo lógico e os fluxos de trabalho usam.

    Para saber mais, confira Planos de hospedagem e tipos de preço.

    Observação

    Se você selecionar uma região do Azure que dê suporte à redundância de zona de disponibilidade, a seção Redundância de zona estará habilitada. Esta seção oferece a opção de habilitar a redundância das zonas de disponibilidade do aplicativo lógico. No entanto, as regiões do Azure com suporte atualmente não incluem o Oeste dos EUA, portanto, você pode ignorar esta seção para este exemplo. Para obter mais informações, confira Proteger aplicativos lógicos contra falhas de região com redundância de zonas e zonas de disponibilidade.

    Depois que você terminar, as configurações serão semelhantes ao seguinte exemplo:

    Captura de tela que mostra o portal do Azure e a página chamada Criar Plano de Serviço de Fluxo de Trabalho de Aplicativo Lógico.

    Observação

    Por padrão, o valor do runtime do trabalho de idioma para seu aplicativo lógico Standard é dotnet. Anteriormente, node era o valor padrão. No entanto, dotnet é agora o valor padrão para todos os aplicativos lógicos Standard novos e existentes implantados, mesmo para aplicativos que tinham um valor diferente. Essa alteração não deve afetar o runtime do fluxo de trabalho e tudo deve funcionar da mesma maneira que antes. Para obter mais informações, consulte a configuração do aplicativo FUNCTIONS_WORKER_RUNTIME .

    A configuração de aplicativo APP_KIND para o seu aplicativo lógico Padrão é definida como workflowApp, mas em alguns cenários essa configuração de aplicativo está ausente — por exemplo, devido à automação que usa modelos do Azure Resource Manager ou outros cenários em que a configuração não está incluída. Se determinadas ações — como a ação Executar Código JavaScript não funcionarem ou o fluxo de trabalho parar de funcionar, verifique se a configuração de aplicativo APP_KIND existe e está definida como workflowApp. Para obter mais informações, confira a configuração de aplicativo APP_KIND.

  6. Quando terminar, selecione Próximo: Armazenamento.

  7. Na guia Armazenamento, forneça as informações a seguir sobre a solução de armazenamento e o plano de hospedagem a serem usados para o aplicativo lógico.

    Propriedade Obrigatório Valor Descrição
    Tipo de armazenamento Sim - Armazenamento do Azure
    - SQL (Versão prévia) e Armazenamento do Microsoft Azure    		 O tipo de armazenamento que você deseja usar para dados e artefatos relacionados ao fluxo de trabalho.

    - Para implantar somente no Azure, selecione Armazenamento do Microsoft Azure.

    - Para usar o SQL como o armazenamento primário e o Armazenamento do Microsoft Azure como o armazenamento secundário, selecione SQL (Versão prévia) e Armazenamento do Microsoft Azure e confira Configurar o armazenamento de dados SQL para aplicativos lógicos Standard em Aplicativos Lógicos do Azure de locatário único.

    observação: se você estiver implantando em uma região do Azure, ainda precisará de uma conta de Armazenamento do Microsoft Azure, que é usada para concluir a hospedagem única da configuração do aplicativo lógico na plataforma Aplicativos Lógicos do Azure. O estado do fluxo de trabalho, o histórico de execução e outros artefatos de tempo de execução são armazenados no banco de dados SQL.

    Para implantações em um local personalizado hospedado em um cluster de Azure Arc, você só precisa SQL como seu provedor de armazenamento.
    Conta de armazenamento Sim <Azure-storage-account-name> A conta de Armazenamento do Microsoft Azure a ser usada para transações de armazenamento.

    Esse nome de recurso deve ser exclusivo entre regiões e ter de 3 a 24 caracteres, com apenas números e letras minúsculas. Selecione uma conta existente ou crie uma nova.

    Este exemplo cria uma conta de armazenamento chamada mystorageacct.

  8. Na guia Rede, você pode deixar as opções padrão para esse exemplo.

    Para seus cenários específicos do mundo real, certifique-se de revisar e selecionar as opções apropriadas. Você também pode alterar essa configuração depois de implantar seu recurso de aplicativo lógico. Para saber mais, confira Proteger o tráfego entre aplicativos lógicos Standard e redes virtuais do Azure usando pontos de extremidade privados.

    Permitir o acesso público Comportamento
    Ativado Seu aplicativo lógico tem um ponto de extremidade público com um endereço de entrada aberto à Internet e não pode acessar uma rede virtual do Azure.
    Desativado Seu aplicativo lógico não tem um ponto de extremidade público, mas tem um ponto de extremidade privado para comunicação dentro de uma rede virtual do Azure e está isolado nessa rede virtual. O ponto de extremidade privado pode se comunicar com pontos de extremidade na rede virtual, mas apenas de clientes dentro dessa rede. Essa configuração também significa que o tráfego do aplicativo lógico pode ser controlado por grupos de segurança de rede ou afetado por rotas de rede virtual.

    Para permitir que seu aplicativo lógico acesse pontos de extremidade em uma rede virtual, verifique se você a opção apropriada está selecionada:

    Habilitar a injeção de rede Comportamento
    Ativado Seus fluxos de trabalho de aplicativo lógico podem se comunicar de forma privada e segura com pontos de extremidade na rede virtual.
    Desativado Seus fluxos de trabalho de aplicativo lógico não podem se comunicar com pontos de extremidade na rede virtual.

  9. Se as suas configurações de criação e implantação derem suporte ao uso do Application Insights, você poderá, opcionalmente, habilitar o log e o rastreamento de diagnóstico para os fluxos de trabalho de aplicativo lógico seguindo estas etapas:

    1. Na guia Monitoramento, em Application insights, defina Habilitar o Application Insights como Sim.

    2. Para a configuração do Application Insights, escolha uma instância do Application insights ou, se desejar criar uma nova, selecione Criar nova e especifique o nome que deseja usar.

  10. Depois que o Azure validar as configurações do aplicativo lógico, na guia Revisar + criar, selecione Criar, por exemplo:

    Captura de tela que mostra o portal do Azure e as novas configurações do recurso de aplicativo lógico.

    Observação

    Se você receber um erro de validação depois dessa etapa, abra e examine os detalhes do erro. Por exemplo, se a região selecionada atingir uma cota de recursos que você está tentando criar, talvez seja necessário tentar uma região diferente.

    Após o Azure concluir a implantação, seu recurso de aplicativo lógico é automaticamente publicado, mas ainda não faz nada porque o recurso está vazio e você ainda não adicionou nenhum os fluxos de trabalho.

  11. Na página de conclusão da implantação, selecione Ir para o recurso para adicionar um fluxo de trabalho em branco.

    Captura de tela mostrando o portal do Azure e a conclusão da implantação.

Adicione um fluxo de trabalho em branco

Depois de criar o recurso de aplicativo lógico vazio, você precisa adicionar o primeiro fluxo de trabalho.

  1. Depois que o Azure abrir o recurso, no menu do aplicativo lógico, em Fluxos de Trabalho, selecione Fluxos de Trabalho. Na barra de ferramentas Fluxos de trabalho, selecione Adicionar.

    Captura de tela que mostra o menu do aplicativo lógico com Fluxos de Trabalho selecionados. A barra de ferramentas mostra a opção selecionada para Adicionar.

  2. Depois que o painel Novo fluxo de trabalho for aberto, forneça um nome para o fluxo de trabalho e selecione o tipo de estado, Com estado ou Sem estado. Quando terminar, selecione Criar.

    Este exemplo adiciona um fluxo de trabalho com estado em branco chamado Stateful-Workflow. O fluxo de trabalho é habilitado por padrão, mas não faz nada até que você adicione um gatilho e ações.

    Captura de tela mostrando o novo fluxo de trabalho com estado em branco chamado Stateful-Workflow.

  3. Na lista de fluxo de trabalho, selecione o fluxo de trabalho com estado em branco.

  4. No menu fluxo de trabalho, em Desenvolvedor, selecione Designer.

    A superfície do designer mostra um prompt para selecionar uma operação de gatilho. Por padrão, o prompt já está selecionado para que um painel com os gatilhos disponíveis já apareça aberto.

Agora, adicione um gatilho que inicia o fluxo de trabalho.

Adicionar um gatilho

Esse exemplo de fluxo de trabalho começa com o gatilho de Solicitação integrado chamado Quando uma solicitação HTTP é recebida. Esse gatilho cria um ponto de extremidade que outros serviços ou fluxos de trabalho de aplicativo lógico podem chamar e aguarda a chegada dessas chamadas ou solicitações de entrada. As operações internas são executadas nativamente e diretamente no runtime dos Aplicativos Lógicos do Azure.

  1. No designer de fluxo de trabalho, verifique se o fluxo de trabalho em branco está aberto e se o prompt Adicionar um gatilho está selecionado na superfície do designer.

  2. Usando solicitação como termo de pesquisa, siga essas etapas para adicionar o gatilho de Solicitação integrado chamado Quando uma solicitação HTTP é recebida ao seu fluxo de trabalho.

    Quando o gatilho aparece no designer, o painel de informações do gatilho é aberto para mostrar as propriedades, configurações e outras ações do gatilho.

    Captura de tela mostrando o designer de fluxo de trabalho e o painel de informações do gatilho.

  3. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

    Ao salvar um fluxo de trabalho pela primeira vez, se esse fluxo de trabalho começar com um gatilho de Solicitação, os Aplicativos Lógicos do Azure geram uma URL automaticamente para um ponto de extremidade que é criado pelo gatilho de Solicitação. Posteriormente, ao testar o fluxo de trabalho, você envia uma solicitação para essa URL, que dispara o gatilho e inicia a execução do fluxo de trabalho.

Adicionar uma ação

Este exemplo de fluxo de trabalho continua com a ação do conector gerenciado do Office 365 Outlook chamada Enviar um email. As operações do conector gerenciado são executadas no Azure, em vez de serem executadas nativamente e diretamente no runtime dos Aplicativos Lógicos do Azure.

  1. No designer, no gatilho que você adicionou, selecione o sinal de adição (+) >Adicionar uma ação.

    O painel Adicionar uma ação é aberto para que você possa selecionar a próxima ação.

  2. Usando office 365 enviar um email como termo de pesquisa, siga estas etapas para adicionar a ação do Office 365 Outlook chamada Enviar um email (V2) ao fluxo de trabalho.

  3. No painel de informações da ação, na guia Criar Conexão, selecione Entrar para que você possa criar uma conexão com sua conta de email.

    Captura de tela mostrando o designer, o painel chamado Enviar um email (V2) com o botão Entrar.

  4. Quando for solicitado o acesso à sua conta de email, entre com as credenciais da sua conta.

    Observação

    Se você receber a mensagem de erro, "Falha com o erro: 'O navegador está fechado.'. Entre novamente", verifique se o navegador está bloqueando cookies de terceiros. Se esses cookies estiverem bloqueados, tente adicionar https://portal.azure.com à lista de sites que podem usar cookies. Se estiver usando a janela anônima, verifique se os cookies de terceiros não estão bloqueados enquanto trabalha nesse modo.

    Se necessário, atualize a página, abra o fluxo de trabalho, adicione a ação de email novamente e tente criar a conexão.

    Depois que o Azure criar a conexão, a ação Enviar um email aparece no Designer e é selecionada por padrão. Se a ação não estiver selecionada, selecione-a para que o painel de informações também esteja aberto.

  5. No painel de informações da ação, na guia Parâmetros, forneça as informações necessárias para a ação, por exemplo:

    Captura de tela mostrando o designer e o painel de informações

    Propriedade Obrigatório Valor Descrição
    Para Sim <your-email-address> O destinatário do email, que pode ser seu endereço de email para fins de teste. Este exemplo usa o endereço de email fictício sophiaowen@fabrikam.com.
    Assunto Sim Um email do seu fluxo de trabalho de exemplo O assunto do email
    Corpo Sim Olá do seu exemplo de fluxo de trabalho! O conteúdo do corpo do email

    Observação

    Ao fazer qualquer alteração no painel de informações nas guias Configurações, Resultado estático ou Executar após, selecione Concluído para confirmar essas alterações antes de alternar as guias ou alterar o foco para o designer. Caso contrário, o Designer não manterá suas alterações.

  6. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

  7. Se o ambiente tiver requisitos rigorosos de rede, ou firewalls que limitam o tráfego, será preciso configurar permissões para qualquer conexão de gatilho ou ação do seu fluxo de trabalho. Para encontrar os nomes de domínio totalmente qualificados, confira Localizar nomes de domínio para acesso ao firewall.

    Caso contrário, para testar o fluxo de trabalho, acione manualmente uma execução.

Exclua os itens do Designer

Para excluir um item no fluxo de trabalho do Designer, siga qualquer uma dessas etapas:

  • Selecione o item, abra o menu de atalho do item (Shift + F10) e selecione Excluir. Para confirmar, selecione OK.

  • Selecione o item e pressione a tecla Excluir. Para confirmar, selecione OK.

  • Selecione o item para que o painel de informações seja aberto para esse item. No canto superior direito do painel, abra o menu de reticências ( ... ) e selecione Excluir. Para confirmar, selecione OK.

    Captura de tela mostrando um item selecionado no designer com o painel de informações aberto mais o botão de elipses selecionado e o comando

    Dica

    Se o menu de elipses não estiver visível, expanda a janela do navegador o suficiente para que o painel de informações mostre o botão de elipses (...) no canto superior direito.

Localize os nomes de domínio para acesso ao firewall

Antes de implantar seu aplicativo lógico e executar o fluxo de trabalho no portal do Azure, se o ambiente tiver requisitos rigorosos de rede ou firewalls que limitem o tráfego, será preciso configurar as permissões de rede ou firewall para qualquer conexão de gatilho ou ação nos fluxos de trabalho do seu aplicativo lógico.

Para encontrar os endereços IP de entrada e de saída usados pelo aplicativo lógico e pelos fluxos de trabalho, siga estas etapas:

  1. No menu do aplicativo lógico, em Configurações, selecione Rede.

  2. Na página de rede, encontre e revise as seções Tráfego de Entrada e Tráfego de Saída.

Para localizar os FQDNs (nomes de domínio totalmente qualificados) das conexões, siga estas etapas:

  1. No menu do aplicativo lógico, em Fluxos de trabalho, selecione Conexões. Na guia Conexões de API, selecione o nome do recurso da conexão, por exemplo:

    Captura de tela que mostra o portal do Azure e o menu do aplicativo lógico com o nome do recurso de conexão

  2. Amplie o navegador de forma que, quando a Exibição JSON aparecer no canto superior direito do navegador, seja possível selecionar a Exibição JSON.

    Captura de tela que mostra o portal do Azure e o painel de Conexão de API com a

  3. Copie e salve o valor da propriedade connectionRuntimeUrl em algum lugar seguro para que você possa configurar seu firewall com essas informações.

    Captura de tela mostrando o valor de propriedade selecionado nomeada connectionRuntimeUrl.

  4. Para cada conexão, repita as etapas relevantes.

Disparar um fluxo de trabalho

Nesse exemplo, o fluxo de trabalho é executado quando o gatilho de Solicitação recebe uma solicitação de entrada, que é enviada para a URL do ponto de extremidade criado pelo gatilho. Ao salvar o fluxo de trabalho pela primeira vez, os Aplicativos Lógicos do Azure geram automaticamente esse URL. Portanto, antes de enviar essa solicitação para disparar o fluxo de trabalho, é preciso encontrar esse URL.

  1. No designer de fluxo de trabalho, selecione o gatilho de Solicitação chamado Quando uma solicitação HTTP é recebida.

  2. Depois que o painel de informações for aberto, na guia Parâmetros, encontre a propriedade HTTP POST URL. Para copiar o URL gerado, selecione o Copiar URL (ícone Copiar arquivo) e salve o URL em outro lugar, por enquanto. O URL segue este formato:

    https://<*logic-app-name*>.azurewebsites.net:443/api/<*workflow-name*>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*shared-access-signature*>

    Captura de tela que mostra o Designer com o Gatilho de solicitação e o URL do ponto de extremidade na propriedade

    Nesse exemplo, o URL tem esta aparência:

    https://fabrikam-workflows.azurewebsites.net:443/api/Fabrikam-Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxxxxXXXXxxxxxXXXXxxxXXXXxxxxXXXX

    Dica

    Você também pode encontrar o URL do ponto de extremidade no painel de Visão geral do aplicativo lógico na propriedade URL do fluxo de trabalho.

    1. No Menu de recursos, selecione Visão geral.
    2. No painel Visão geral, localize a propriedade URL do fluxo de trabalho.
    3. Para copiar o URL do ponto de extremidade, passe o ponteiro do mouse por cima do final do texto do URL do ponto de extremidade e selecione Copiar para a área de transferência (ícone Copiar arquivo).

  3. Para testar a URL do ponto de extremidade e disparar o fluxo de trabalho, envie uma solicitação HTTP para a URL, incluindo o método que o gatilho de Solicitação espera, usando sua ferramenta de solicitação HTTP e as respectivas instruções.

    Esse exemplo usa o método GET com a URL copiada, que se parece com a seguinte amostra:

    GET https://fabrikam-workflows.azurewebsites.net:443/api/Fabrikam-Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxxxxXXXXxxxxxXXXXxxxXXXXxxxxXXXX

    Quando o gatilho é acionado, o fluxo de trabalho de exemplo é executado e envia um email semelhante a este exemplo:

    Captura de tela que mostra o email do Outlook, como descrito no exemplo

Avalie o histórico de execução do fluxo de trabalho

Depois que um fluxo de trabalho com monitoração de estado terminar de ser executado, você poderá exibir o histórico de execução do fluxo de trabalho, incluindo o status da execução geral, do gatilho e de cada ação, juntamente com suas entradas e saídas. No portal do Azure, o histórico de execução do fluxo de trabalho e o histórico de gatilhos aparecem no nível do fluxo de trabalho, não no nível de recurso do aplicativo lógico. Para obter mais informações, consulte Revisar histórico de execução do fluxo de trabalho e Revisar histórico de gatilhos.

Para este exemplo de fluxo de trabalho, o histórico de execução do fluxo de trabalho é semelhante ao seguinte exemplo:

Captura de tela mostra a exibição de detalhes da execução com o status de cada etapa no fluxo de trabalho.

Captura de tela mostra entradas e saídas na ação selecionada chamada Enviar um email.

Examinar histórico de gatilho

Para um fluxo de trabalho com monitoração de estado, você pode revisar o histórico de gatilhos para cada execução, incluindo o status do gatilho junto com entradas e saídas, separadamente do histórico de execução do fluxo de trabalho. No portal do Azure, históricos de execução e de gatilho aparecem no nível do fluxo de trabalho, não no nível do aplicativo lógico. Para obter mais informações, consulte Revisar histórico de gatilhos.

Reenviar fluxo de trabalho executado com as mesmas entradas

Para uma execução de fluxo de trabalho com monitoração de estado existente, você pode executar novamente todo o fluxo de trabalho com as mesmas entradas que foram usadas anteriormente para essa execução. Para obter mais informações, consulte Executar novamente um fluxo de trabalho com as mesmas entradas.

Habilite o histórico de execuções para fluxos de trabalho sem estado

Para depurar um fluxo de trabalho sem estado com mais facilidade, habilite o histórico de execução para esse fluxo de trabalho e desabilite o histórico de execução quando terminar. Siga essas etapas para o portal do Azure ou, se estiver trabalhando no Visual Studio Code, consulte Criar fluxos de trabalho com e sem estado no Visual Studio Code.

  1. No portal do Azure, abra seu recurso de aplicativo lógico Padrão.

  2. No menu do aplicativo lógico, acesse Configurações e selecione Configuração.

  3. Na guia Configurações de aplicativo, selecione Novas configurações de aplicativo.

  4. No painel Adicionar/Editar configurações do aplicativo, acesse a caixa Nome e digite este nome de opção de operação:

    Fluxos de trabalho.{yourWorkflowName }.OperationOptions

  5. Na caixa Valor, insira o seguinte valor: WithStatelessRunHistory

    Captura de tela mostrando o aplicativo lógico Standard e o painel nomeado Adicionar/Editar configuração do aplicativo com fluxos de trabalho.{yourWorkflowName}.OperationOptions definido como WithStatelessRunHistory.

  6. Para concluir essa tarefa, selecione OK. Na barra de ferramentas do painel de Configuração, selecione Salvar.

  7. Para desabilitar o histórico de execução quando terminar, defina a propriedade nomeada Fluxos de trabalho.{ your-workflow-name }.OperationOptions como Nenhum ou exclua a propriedade e seu valor.

Após a implantação, habilite ou abra o Application Insights

Durante a execução do fluxo de trabalho, o aplicativo lógico emite telemetria junto com outros eventos. Use a telemetria para visualizar o desempenho do fluxo de trabalho e como o tempo de execução dos Aplicativos Lógicos do Azure funciona de várias maneiras. É possível monitorar o fluxo de trabalho usando o Application insights, que fornece telemetria quase em tempo real (métricas ao vivo). Esse recurso pode ajudar a investigar falhas e problemas de desempenho mais facilmente ao usar esses dados para diagnosticar problemas, configurar alertas e criar gráficos.

Se as configurações de criação e implantação do aplicativo lógico forem compatíveis com o uso do Application Insights, será possível habilitar o log de diagnóstico e o rastreamento para o fluxo de trabalho do seu aplicativo lógico. Isso pode ser feito ao criar o recurso de aplicativo lógico no portal do Azure ou após a implantação. É necessário ter uma instância do Application Insights, mas esse recurso pode ser criado com antecedência ao criar seu aplicativo lógico, ou após a implantação. Opcionalmente, também poderá habilitar a telemetria melhorada no Application Insights para fluxos de trabalho Standard.

Habilitar o Application Insights em um aplicativo lógico implantado

  1. No portal do Azure, localize o aplicativo lógico implantado.

  2. No menu do aplicativo lógico, em Configurações, selecione Application Insights.

  3. No painel do Application Insights, selecione Ativar o Application Insights.

  4. Depois que o painel for atualizado, na parte inferior, selecione Aplicar>Sim.

  5. No painel do Application Insights, selecione Exibir dados do Application Insights.

    Após o painel do Application Insights ser aberto, examine as métricas ou os logs do fluxo de trabalho do aplicativo lógico. Por exemplo, para mapear ou consultar dados, no menu de recursos do Application Insights, em Monitoramento, selecione Métricas ou Logs.

Abrir o Application Insights

  1. No portal do Azure, localize o aplicativo lógico implantado.

  2. No menu do aplicativo lógico, em Configurações, selecione Application Insights.

  3. No painel do Application Insights, selecione Exibir dados do Application Insights.

    Após o painel do Application Insights ser aberto, examine as métricas ou os logs do fluxo de trabalho do aplicativo lógico. Por exemplo, para mapear ou consultar dados, no menu de recursos do Application Insights, em Monitoramento, selecione Métricas ou Logs.

Exibir conexões

Quando você cria conexões em um fluxo de trabalho usando conectores gerenciados pela Microsoft, essas conexões são, na verdade, recursos separados do Azure com suas próprias definições de recurso e são hospedadas no Azure global multilocatário. Os fluxos de trabalho de aplicativo lógico padrão também podem usar conectores internos do provedor de serviços que são executados nativamente e são alimentados pelo runtime dos Aplicativos Lógicos do Azure de locatário único. Para exibir e gerenciar essas conexões, consulte Exibir conexões.

Parar ou iniciar recursos do aplicativo lógico

Siga as etapas em Desabilitar ou habilitar aplicativos lógicos.

Solucionar problemas e erros

Novos gatilhos e ações ausentes no seletor do Designer para fluxos de trabalho criados anteriormente

Os Aplicativos Lógicos do Azure com locatário único dão suporte a ações internas para operações do Azure Functions, do Liquid e de XML, como Validação de XML e Transformação XML. No entanto, para aplicativos lógicos criados anteriormente, essas ações podem não aparecer no designer para que você selecione se seu aplicativo lógico usa uma versão desatualizada do pacote de extensão, Microsoft.Azure.Functions.ExtensionBundle.Workflows.

Para corrigir esse problema, siga as etapas para excluir a versão desatualizada. Assim, o pacote de extensão poderá ser atualizado automaticamente para a versão mais recente.

Observação

Essa solução específica se aplica apenas aos recursos do aplicativo lógico Standard que você cria usando o portal do Azure, não aos aplicativos lógicos que você cria e implanta usando o Visual Studio Code e a extensão Aplicativos Lógicos do Azure (Standard). Consulte Gatilhos e ações compatíveis não estão presentes no Designer no Visual Studio Code.

  1. No portal do Azure, interrompa o aplicativo lógico.

    1. No menu do aplicativo lógico, selecione Visão geral.

    2. Na barra de ferramentas do painel Visão Geral, selecione Interromper.

  2. No menu do aplicativo lógico, acesse Ferramentas de desenvolvimento e selecione Ferramentas avançadas.

  3. No painel Ferramentas avançadas, selecione Ir. O ambiente Kudu será aberto no seu aplicativo lógico.

  4. Na barra de ferramentas do Kudu, abra o menu do Console de depuração e selecione CMD.

    A janela do console será aberta. Navegue até a pasta do pacote usando o prompt de comando. Se preferir, procure a estrutura de diretório exibida acima da janela do console.

  5. Navegue até a seguinte pasta, que contém pastas de versão para o pacote existente:

    ...\home\data\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

  6. Exclua a pasta de versão do pacote existente. Na janela do console, você pode executar esse comando substituindo {bundle-version} pela versão existente:

    rm -rf {bundle-version}

    Por exemplo: rm -rf 1.1.3

    Dica

    Se você receber um erro como "permissão negada" ou "arquivo em uso", atualize a página no navegador e tente as etapas anteriores novamente até que a pasta seja excluída.

  7. No portal do Azure, retorne à página de Visão geral do aplicativo lógico e selecione Reiniciar.

    O portal obtém e usa automaticamente o pacote mais recente.

Próximas etapas