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.
Na criação do aplicativo lógico de Consumo, habilite o Log Analytics e especifique o workspace do Log Analytics.
-ou-
Para um aplicativo lógico de Consumo existente, instale a solução Gerenciamento de Aplicativos Lógicos no workspace do Log Analytics. Esta solução fornece informações agregadas sobre as execuções de seu aplicativos lógicos e inclui detalhes específicos como status, tempo de execução, status de reenvio e IDs de correlação.
Adicione uma configuração de diagnóstico para habilitar a coleta de dados.
Envie dados de diagnóstico para o Armazenamento do Azure e os Hubs de Eventos do Azure.
Pré-requisitos
Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.
Para um recurso de aplicativo lógico de Consumo, você precisa ter permissões de Proprietário ou de Colaborador da assinatura do Azure para instalar a solução Gerenciamento de Aplicativos Lógicos do Azure Marketplace. Para saber mais, confira a seguinte documentação:
O recurso de destino para o qual deseja enviar os dados de diagnóstico:
O recurso de aplicativo lógico e o fluxo de trabalho
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
No portal do Azure, no painel Criar Aplicativo Lógico, siga estas etapas:
Em Plano, selecione Consumo para que apenas as opções de fluxos de trabalho de Consumo sejam exibidas.
Em Habilitar análise de log, selecione Sim.
Na lista Workspace do Log Analytics, selecione o workspace no qual deseja enviar dados para as execuções de fluxo de trabalho.
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.
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:
Na caixa de pesquisa do portal do Azure, insira Workspaces do Log Analytics e selecione Workspaces do Log Analytics nos resultados.
Em Workspaces do Log Analytics, selecione o workspace.
No painel Visão Geral, em Introdução ao Log Analytics>Configurar soluções de monitoramento, selecione Exibir soluções.
Em Visão geral, selecione Adicionar, que adiciona uma nova solução ao seu workspace.
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.
No bloco Gerenciamento de Aplicativos Lógicos, na lista Criar, selecione Gerenciamento de Aplicativos Lógicos.
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.
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.
Adicionar uma configuração de diagnóstico
No portal do Azure, abra o recurso de aplicativo lógico de Consumo.
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.
Em Nome da configuração de diagnóstico, forneça o nome desejado para a configuração.
Em Logs>Categorias, selecione Eventos de diagnóstico de runtime de fluxo de trabalho. Em Métricas, selecione AllMetrics.
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:
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.
No portal do Azure, abra o workspace do Log Analytics.
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.
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.
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:
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.
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:
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.
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:
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:
- Arquivar logs de recursos do Azure na conta de armazenamento
- Transmitir logs de plataforma do Azure para um Hub de Eventos do Azure
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:
- Transmitir dados dos Hubs de Eventos para o Stream Analytics
- Analisar dados de streaming com o Stream Analytics e criar um painel de análise em tempo real no Power BI
Observação
Os períodos de retenção se aplicam somente quando você opta por usar uma conta de armazenamento.
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:
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.
Selecione a linha do fluxo de trabalho que deseja analisar.
Na página Execuções, na tabela Execuções de Aplicativo Lógico, encontre a coluna ID de Rastreamento e a coluna Propriedades Rastreadas.
Para pesquisar as propriedades rastreadas, use o filtro de coluna. Para ver as propriedades, selecione Exibir.