Monitorar e coletar dados de diagnóstico para fluxos de trabalho nos Aplicativos Lógicos do Azure

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

Para obter dados mais avançados para depuração e diagnóstico dos seus fluxos de trabalho nos Aplicativos Lógicos do Azure, você pode registrar em log dados e eventos de runtime do fluxo de trabalho, como eventos de gatilho, eventos de execução e eventos de ação, que podem ser enviado para um workspace do Log Analytics, uma conta de armazenamento do Azure, um hub de eventos do Azure, outro destino de parceiro ou todos esses destinos durante a configuração e o uso dos Logs do Azure Monitor.

Observação

Os Logs de Recursos do Azure Monitor não são 100% sem perdas. Os Logs de Recursos são baseados em uma arquitetura de armazenamento e encaminhamento projetada para mover petabytes de dados por dia em escala. Essa funcionalidade inclui redundância interna e novas tentativas em toda a plataforma, mas não fornece garantias transacionais. O monitoramento transacional pode reduzir a confiabilidade e o desempenho do serviço monitorado. Além disso, erros transitórios de log devem interromper o serviço upstream quando não for possível confirmar a entrega de logs. Sempre que a equipe do Azure Monitor pode confirmar uma fonte persistente de perda de dados, a equipe considera a resolução e a prevenção sua prioridade mais alta. No entanto, pequenas perdas de dados ainda podem ocorrer devido a problemas de serviço temporários e não repetidos distribuídos pelo Azure e nem todos podem ser capturados.

Este guia de instruções mostra como concluir as tarefas a seguir, dependendo se você tem um recurso de aplicativo lógico de Consumo ou Standard.

Pré-requisitos

Habilitar o Log Analytics

Para um aplicativo lógico de Consumo, primeiro, você precisa habilitar o Log Analytics.

Habilitar o Log Analytics na criação do aplicativo lógico

  1. No portal do Azure, no painel Criar Aplicativo Lógico, siga estas etapas:

    1. Em Plano, selecione Consumo para que apenas as opções de fluxos de trabalho de Consumo sejam exibidas.

    2. Em Habilitar análise de log, selecione Sim.

    3. Na lista Workspace do Log Analytics, selecione o workspace no qual deseja enviar dados para as execuções de fluxo de trabalho.

      Captura de tela que mostra o portal do Azure e a página de criação do aplicativo lógico de Consumo.

  2. Termine de criar o recurso de aplicativo lógico.

    Quando terminar, ele será associado ao workspace do Log Analytics. Esta etapa também instala automaticamente a solução de Gerenciamento de Aplicativos Lógicos no workspace.

  3. Depois de executar o fluxo de trabalho, veja o status de execução de fluxo de trabalho.

Instalar a solução de Gerenciamento dos Aplicativos Lógicos

Se você já ativou o Log Analytics durante a criação do recurso de aplicativo lógico, ignore esta seção. Você já tem a solução de Gerenciamento de Aplicativos Lógicos instalada no workspace do Log Analytics. Caso contrário, continue com as seguintes etapas para um aplicativo lógico de Consumo existente:

  1. Na caixa de pesquisa do portal do Azure, insira Workspaces do Log Analytics e selecione Workspaces do Log Analytics nos resultados.

    Captura de tela que mostra a caixa de pesquisa do portal do Azure com os workspaces do Log Analytics selecionados.

  2. Em Workspaces do Log Analytics, selecione o workspace.

    Captura de tela que mostra o portal do Azure, a lista de workspaces do Log Analytics e um workspace específico selecionado.

  3. No painel Visão Geral, em Introdução ao Log Analytics>Configurar soluções de monitoramento, selecione Exibir soluções.

    Captura de tela que mostra o portal do Azure, a página de visão geral do workspace e a opção Exibir soluções selecionadas.

  4. Em Visão geral, selecione Adicionar, que adiciona uma nova solução ao seu workspace.

  5. Depois que a página Marketplace for aberta, na caixa de pesquisa, insira gerenciamento de aplicativos lógicos e selecione Gerenciamento de Aplicativos Lógicos.

    Captura de tela que mostra o portal do Azure, a caixa de pesquisa da página Marketplace com 'gerenciamento de aplicativos lógicos' inserido e 'Gerenciamento de Aplicativos Lógicos' selecionado.

  6. No bloco Gerenciamento de Aplicativos Lógicos, na lista Criar, selecione Gerenciamento de Aplicativos Lógicos.

    Captura de tela que mostra o portal do Azure, a página Marketplace, o bloco 'Gerenciamento de Aplicativos Lógicos', com a lista Criar aberta e o Gerenciamento de Aplicativos Lógicos (versão prévia) selecionado.

  7. No painel Criar Solução de Gerenciamento de Aplicativos Lógicos (versão prévia), selecione o workspace do Log Analytics em que deseja instalar a solução. Escolha Revisar + criar, revise as informações e selecione Criar.

    Captura de tela que mostra o portal do Azure, a página Criar Solução de Gerenciamento de Aplicativos Lógicos (Versão Prévia) e as informações do workspace.

    Depois que o Azure implantar a solução no grupo de recursos do Azure que contém seu workspace do Log Analytics, a solução será exibida no painel de resumo do workspace em Visão geral.

    Captura de tela que mostra o portal do Azure e o painel de resumo do workspace com a solução Gerenciamento de Aplicativos Lógicos.

Adicionar uma configuração de diagnóstico

  1. No portal do Azure, abra o recurso de aplicativo lógico de Consumo.

  2. No menu de recurso do aplicativo lógico, em Monitoramento, selecione Configurações de diagnóstico. Na página Configurações de diagnóstico, selecione Adicionar configuração de diagnóstico.

    Captura de tela que mostra o portal do Azure e o menu de recursos do aplicativo lógico de Consumo com a opções 'Configurações de diagnóstico' e 'Adicionar configuração de diagnóstico' selecionadas.

  3. Em Nome da configuração de diagnóstico, forneça o nome desejado para a configuração.

  4. Em Logs>Categorias, selecione Eventos de diagnóstico de runtime de fluxo de trabalho. Em Métricas, selecione AllMetrics.

  5. Em Detalhes de destino, escolha um ou mais destinos, de acordo com o local em que deseja enviar os logs.

    Destino Instruções
    Enviar para o workspace do Log Analytics Selecione a assinatura do Azure para o workspace do Log Analytics e o workspace.
    Arquivar em uma conta de armazenamento Escolha a assinatura do Azure da sua conta de armazenamento do Azure e a conta de armazenamento. Para obter mais informações, confira Enviar dados de diagnóstico para o Armazenamento do Azure e os Hubs de Eventos do Azure.
    Transmitir por streaming para um hub de eventos Selecione a assinatura do Azure do namespace do hub de eventos, o hub de eventos e o nome da política do hub de eventos. Para obter mais informações, confira Enviar dados de diagnóstico para o Armazenamento do Azure e os Hubs de Eventos do Azure e Integrações de parceiros do Azure Monitor.
    Enviar para uma solução de parceiro Escolha sua assinatura do Azure e o destino. Para saber mais, confira Visão geral dos Serviços de ISV Nativo do Azure.

    O seguinte exemplo seleciona um workspace do Log Analytics como destino:

    Captura de tela que mostra o portal do Azure, o workspace do Log Analytics e os dados a serem coletados.

  6. Para concluir a adição da configuração de diagnóstico, selecione Salvar.

Exibir o status de execução do fluxo de trabalho

Após a execução do fluxo de trabalho, veja os dados sobre essas execuções no workspace do Log Analytics.

  1. No portal do Azure, abra o workspace do Log Analytics.

  2. No menu do workspace, em Clássico, selecione Resumo do workspace. Na página Visão geral, escolha Gerenciamento de Aplicativos Lógicos.

    Observação

    Se o bloco Gerenciamento de Aplicativos Lógicos não mostrar imediatamente os resultados após uma execução, tente selecionar Atualizar ou aguarde um breve momento antes de tentar novamente.

    Captura de tela que mostra o portal do Azure e o workspace do Log Analytics com o status e a contagem de execuções do fluxo de trabalho de aplicativo lógico de Consumo.

    A página de resumo mostra os fluxos de trabalho agrupados por nome ou por status de execução. Essa página também mostra detalhes sobre as falhas nas ações ou nos gatilhos para as execuções de fluxo de trabalho.

    Captura de tela que mostra o resumo do status das execuções do fluxo de trabalho do aplicativo lógico de Consumo.

  3. Para ver todas as execuções de um fluxo de trabalho ou um status específico, selecione a linha do fluxo de trabalho ou do status em questão.

    Este exemplo mostra todas as execuções de um fluxo de trabalho específico:

    Captura de tela que mostra as execuções e o status de um fluxo de trabalho específico do aplicativo lógico de Consumo.

    Para as ações em que você adicionou propriedades rastreadas, procure as propriedades rastreadas usando o filtro de colunas. Para ver as propriedades, na coluna Propriedades Rastreadas, selecione Exibir.

    Captura de tela que mostra as propriedades rastreadas para um fluxo de trabalho de aplicativo lógico de Consumo específico.

  4. Para filtrar esses resultados, execute a filtragem tanto no lado do cliente quanto no lado do servidor.

    • Filtro do lado do cliente: para cada coluna, escolha os filtros que desejar, por exemplo:

      Captura de tela que mostra um exemplo de filtro do lado do cliente usando filtros de coluna.

    • Filtro no lado do servidor: para escolher um período específico, ou para limitar o número de execuções exibidas, use o controle de escopo na parte superior da página. Por padrão, apenas 1.000 registros aparecem por vez.

      Captura de tela que mostra um exemplo de filtro do lado do servidor que altera a janela de tempo.

  5. Para ver todas as ações e os detalhes de uma execução específica, selecione uma linha de uma execução de fluxo de trabalho de aplicativo lógico.

    O seguinte exemplo mostra todas as ações e os gatilhos de uma execução específica de fluxo de trabalho de aplicativo lógico:

    Captura de tela que mostra todas as operações e os detalhes de uma execução específica de fluxo de trabalho de aplicativo lógico.

Enviar dados de diagnóstico para o Armazenamento do Azure e Hubs de Eventos do Azure

Acompanhado dos Logs do Azure Monitor, você pode enviar os dados coletados para outros destinos, por exemplo:

Depois, obtenha o monitoramento em tempo real usando a telemetria e a análise de outros serviços, como o Azure Stream Analytics e o Power BI, por exemplo:

Observação

Os períodos de retenção se aplicam somente quando você opta por usar uma conta de armazenamento.

Captura de tela que mostra o portal do Azure, o recurso de aplicativo lógico de Consumo e a configuração de diagnóstico com as opções de conta de armazenamento e hub de eventos.

Incluir propriedades personalizadas na telemetria

No fluxo de trabalho, os gatilhos e as ações têm a capacidade de adicionar as propriedades personalizadas a seguir para que os valores delas sejam exibidos com a telemetria emitida no seu workspace do Log Analytics.

ID de rastreamento personalizada

A maioria dos gatilhos tem uma propriedade ID de Rastreamento Personalizada, na qual você pode especificar uma ID de rastreamento usando uma expressão. Use essa expressão para obter dados do conteúdo da mensagem recebida ou para gerar valores exclusivos, por exemplo:

Se você não especificar essa ID de rastreamento personalizada, o Azure vai gerar automaticamente essa ID e correlacionar os eventos em uma execução de fluxo de trabalho, incluindo os fluxos de trabalho aninhados que são chamados do fluxo de trabalho pai. Você pode especificar essa ID manualmente em um gatilho, passando um cabeçalho x-ms-client-tracking-id com o valor de ID personalizado na solicitação de gatilho. Use um gatilho de solicitação, um gatilho HTTP ou um gatilho baseado em webhook.

Propriedades rastreadas

As ações têm uma seção Propriedades Rastreadas, em que você pode especificar um nome e um valor de propriedade personalizada inserindo uma expressão ou um valor embutido em código para acompanhar entradas ou saídas específicas, por exemplo:

As propriedades rastreadas só podem acompanhar as entradas e as saídas de uma ação individual, mas você pode usar as propriedades correlation dos eventos para correlacioná-los entre as ações em uma execução de fluxo de trabalho.

As propriedades controladas só podem fazer referência aos parâmetros, entradas e saídas para seu próprio gatilho ou ação.

As propriedades controladas não são permitidas em um gatilho ou ação que tenha entradas seguras, saídas seguras ou ambas. Eles também não têm permissão para fazer referência a outro gatilho ou ação que tenha entradas seguras, saídas seguras ou ambas.

Os seguintes exemplos mostram o local em que as propriedades personalizadas são exibidas no workspace do Log Analytics:

  1. No menu do workspace do Log Analytics, em Clássico, selecione Resumo do workspace. Na página Visão geral, escolha Gerenciamento de Aplicativos Lógicos.

  2. Selecione a linha do fluxo de trabalho que deseja analisar.

  3. Na página Execuções, na tabela Execuções de Aplicativo Lógico, encontre a coluna ID de Rastreamento e a coluna Propriedades Rastreadas.

    Captura de tela que mostra as execuções e o status de um fluxo de trabalho de Consumo específico.

  4. Para pesquisar as propriedades rastreadas, use o filtro de coluna. Para ver as propriedades, selecione Exibir.

    Captura de tela que mostra exemplos de propriedades rastreadas para um fluxo de trabalho de Consumo específico.

Próximas etapas