Monitorizar e recolher dados de diagnóstico para fluxos de trabalho no Azure Logic Apps
Aplica-se a: Azure Logic Apps (Consumo + Standard)
Para obter dados mais avançados para depurar e diagnosticar os seus fluxos de trabalho no Azure Logic Apps, pode registar dados e eventos de runtime de fluxo de trabalho, como eventos de acionador, eventos de execução e eventos de ação, que pode enviar para uma área de trabalho do Log Analytics, conta de armazenamento do Azure, hub de eventos do Azure, outro destino de parceiro ou todos estes destinos quando configurar e utilizar os Registos do Azure Monitor.
Nota
Os Registos de Recursos do Azure Monitor não estão 100% sem perdas. Os Registos de Recursos baseiam-se numa arquitetura de arquivo e reencaminhamento concebida para mover petabytes de dados por dia em escala. Esta capacidade inclui redundância incorporada e repetições em toda a plataforma, mas não fornece garantias transacionais. A monitorização transacional pode reduzir a fiabilidade e o desempenho do serviço monitorizado. Além disso, os erros de registo transitórios têm de parar o serviço a montante quando não é possível confirmar a entrega do registo. Sempre que a equipa do Azure Monitor pode confirmar uma origem persistente de perda de dados, a equipa considera a resolução e a prevenção a sua maior prioridade. No entanto, as pequenas perdas de dados podem continuar a ocorrer devido a problemas de serviço temporários e não repetidos distribuídos pelo Azure e nem todos podem ser apanhados.
Este guia de procedimentos mostra como concluir as seguintes tarefas, com base no facto de ter um recurso de aplicação lógica De Consumo ou Standard.
Na criação de aplicações lógicas de consumo, ative o Log Analytics e especifique a área de trabalho do Log Analytics.
-ou-
Para uma aplicação lógica de Consumo existente, instale a solução gestão do Logic Apps na área de trabalho do Log Analytics. Esta solução fornece informações agregadas para as execuções da aplicação lógica e inclui detalhes específicos, como o estado, o tempo de execução, o estado de resubmissão e os IDs de correlação.
Adicione uma definição de diagnóstico para ativar a recolha de dados.
Enviar dados de diagnóstico para o Armazenamento e Hubs de Eventos do Azure do Azure.
Pré-requisitos
Uma conta e subscrição do Azure. Se não tiver uma subscrição, inscreva-se numa conta do Azure gratuita.
Para um recurso de aplicação lógica de consumo, precisa de permissões de Proprietário ou Contribuidor da subscrição do Azure para poder instalar a solução gestão do Logic Apps a partir do Azure Marketplace. Para obter mais informações, veja a seguinte documentação:
O recurso de destino para onde pretende enviar dados de diagnóstico:
Uma área de trabalho do Log Analytics
Recurso e fluxo de trabalho da aplicação lógica
Ativar o Log Analytics
Para uma aplicação lógica de Consumo, primeiro tem de ativar o Log Analytics.
Ativar o Log Analytics na criação de aplicações lógicas
No portal do Azure, no painel Criar Aplicação Lógica, siga estes passos:
Em Plano, certifique-se de que seleciona Consumo para que sejam apresentadas apenas as opções para Fluxos de trabalho de Consumo.
Para Ativar a análise de registos, selecione Sim.
Na lista de áreas de trabalho do Log Analytics , selecione a área de trabalho para onde pretende enviar os dados a partir da execução do fluxo de trabalho.
Conclua a criação do recurso da aplicação lógica.
Quando terminar, a sua aplicação lógica está associada à área de trabalho do Log Analytics. Este passo também instala automaticamente a solução gestão do Logic Apps na área de trabalho.
Depois de executar o fluxo de trabalho, veja o estado da execução do fluxo de trabalho.
Instalar a solução de Gestão do Logic Apps
Se tiver ativado o Log Analytics quando criou o recurso da aplicação lógica, ignore esta secção. Já tem a solução gestão do Logic Apps instalada na área de trabalho do Log Analytics. Caso contrário, continue com os seguintes passos para uma aplicação lógica de Consumo existente:
Na caixa de pesquisa portal do Azure, introduza áreas de trabalho do Log Analytics e selecione Áreas de trabalho do Log Analytics nos resultados.
Em Áreas de trabalho do Log Analytics, selecione a área de trabalho.
No painel Descrição Geral , em Introdução ao Log Analytics>Configurar soluções de monitorização, selecioneVer soluções.
Em Descrição geral, selecione Adicionar, que adiciona uma nova solução à área de trabalho.
Depois de abrir a página do Marketplace , na caixa de pesquisa, introduza gestão de aplicações lógicas e selecione Gestão de Aplicações Lógicas.
No mosaico Gestão de Aplicações Lógicas , na lista Criar , selecione Gestão de Aplicações Lógicas.
No painel Criar Solução de Gestão de Aplicações Lógicas (Pré-visualização ), selecione a área de trabalho do Log Analytics onde pretende instalar a solução. Selecione Rever + criar, reveja as suas informações e selecione Criar.
Depois de o Azure implementar a solução no grupo de recursos do Azure que contém a área de trabalho do Log Analytics, a solução é apresentada no painel de resumo da área de trabalho em Descrição geral.
Adicionar uma definição de diagnóstico
No portal do Azure, abra o recurso da aplicação lógica Consumo.
No menu de recursos da aplicação lógica, em Monitorização, selecione Definições de diagnóstico. Na página Definições de diagnóstico, selecione Adicionar definição de diagnóstico.
Para Nome da definição de diagnóstico, indique o nome que pretende para a definição.
Em Categorias de Registos>, selecione Eventos de diagnóstico de runtime de fluxo de trabalho. Em Métricas, selecione AllMetrics.
Em Detalhes de destino, selecione um ou mais destinos, com base no local onde pretende enviar os registos.
Destino Instruções Enviar para a área de trabalho do Log Analytics Selecione a subscrição do Azure para a área de trabalho do Log Analytics e a área de trabalho. Arquivar numa conta de armazenamento Selecione a subscrição do Azure para a sua conta de armazenamento do Azure e a conta de armazenamento. Para obter mais informações, veja Enviar dados de diagnóstico para o Armazenamento do Azure e Hubs de Eventos do Azure. Transmitir em fluxo para um hub de eventos Selecione a subscrição do Azure para o espaço de nomes do hub de eventos, o hub de eventos e o nome da política do hub de eventos. Para obter mais informações, veja Enviar dados de diagnóstico para o Armazenamento do Azure, Hubs de Eventos do Azure e integrações de parceiros do Azure Monitor. Enviar para a solução de parceiro Selecione a sua subscrição do Azure e o destino. Para obter mais informações, veja Descrição geral dos Serviços ISV Nativos do Azure. O exemplo seguinte seleciona uma área de trabalho do Log Analytics como o destino:
Para concluir a adição da definição de diagnóstico, selecione Guardar.
Ver o estado da execução do fluxo de trabalho
Após a execução do fluxo de trabalho, pode ver os dados sobre essas execuções na área de trabalho do Log Analytics.
No portal do Azure, abra a área de trabalho do Log Analytics.
No menu da área de trabalho, em Clássico, selecione Resumo da Área de Trabalho. Na página Descrição geral , selecione Gestão de Aplicações Lógicas.
Nota
Se o mosaico Gestão de Aplicações Lógicas não mostrar imediatamente os resultados após uma execução, experimente selecionar Atualizar ou aguardar um curto período de tempo antes de tentar novamente.
A página de resumo mostra fluxos de trabalho agrupados pelo nome ou pelo estado de execução. A página também mostra detalhes sobre falhas nas ações ou acionadores para as execuções do fluxo de trabalho.
Para ver todas as execuções de um fluxo de trabalho ou estado específico, selecione a linha para esse fluxo de trabalho ou estado.
Este exemplo mostra todas as execuções de um fluxo de trabalho específico:
Para ações em que adicionou propriedades registadas, pode procurar as propriedades registadas com o filtro de coluna. Para ver as propriedades, na coluna Propriedades Registadas , selecione Ver.
Para filtrar os resultados, pode efetuar a filtragem do lado do cliente e do lado do servidor.
Filtro do lado do cliente: para cada coluna, selecione os filtros que pretende, por exemplo:
Filtro do lado do servidor: para selecionar uma janela de tempo específica ou limitar o número de execuções que aparecem, utilize o controlo de âmbito na parte superior da página. Por predefinição, apenas são apresentados 1000 registos de cada vez.
Para ver todas as ações e os respetivos detalhes para uma execução específica, selecione a linha para uma execução de fluxo de trabalho de aplicação lógica.
O exemplo seguinte mostra todas as ações e acionadores para uma execução de fluxo de trabalho de aplicação lógica específica:
Enviar dados de diagnóstico para o Armazenamento e Hubs de Eventos do Azure do Azure
Juntamente com os Registos do Azure Monitor, pode enviar os dados recolhidos para outros destinos, por exemplo:
- Arquivar registos de recursos do Azure na conta de armazenamento
- Transmitir os registos da plataforma do Azure para Hubs de Eventos do Azure
Em seguida, pode obter monitorização em tempo real com telemetria e análise de outros serviços, como o Azure Stream Analytics e o Power BI, por exemplo:
- Transmitir dados de Hubs de Eventos para o Stream Analytics
- Analisar dados de transmissão em fluxo com o Stream Analytics e criar um dashboard de análise em tempo real no Power BI
Nota
Os períodos de retenção aplicam-se apenas quando utiliza uma conta de armazenamento.
Incluir propriedades personalizadas na telemetria
No fluxo de trabalho, os acionadores e as ações têm a capacidade de adicionar as seguintes propriedades personalizadas para que os respetivos valores sejam apresentados juntamente com a telemetria emitida na área de trabalho do Log Analytics.
ID de controlo personalizado
A maioria dos acionadores tem uma propriedade ID de Controlo Personalizado onde pode especificar um ID de controlo com uma expressão. Pode utilizar esta expressão para obter dados do payload de mensagens recebidas ou para gerar valores exclusivos, por exemplo:
Se não especificar este ID de controlo personalizado, o Azure gera automaticamente este ID e correlaciona eventos numa execução de fluxo de trabalho, incluindo quaisquer fluxos de trabalho aninhados chamados a partir do fluxo de trabalho principal. Pode especificar manualmente este ID num acionador ao transmitir um x-ms-client-tracking-id
cabeçalho com o seu valor de ID personalizado no pedido de acionador. Pode utilizar um acionador De pedido, acionador HTTP ou acionador baseado em webhook.
Propriedades controladas
As ações têm uma secção Propriedades Registadas onde pode especificar um nome e um valor de propriedade personalizados ao introduzir uma expressão ou um valor codificado para controlar entradas ou saídas específicas, por exemplo:
As propriedades controladas só podem controlar as entradas e saídas de uma única ação, mas pode utilizar as correlation
propriedades dos eventos para correlacionar entre ações numa execução de fluxo de trabalho.
As propriedades controladas só podem referenciar os parâmetros, entradas e saídas para o seu próprio acionador ou ação.
As propriedades controladas não são permitidas num acionador ou ação que tenha entradas seguras, saídas seguras ou ambas. Também não estão autorizados a referenciar outro acionador ou ação que tenha entradas seguras, saídas seguras ou ambos.
Os exemplos seguintes mostram onde as propriedades personalizadas aparecem na área de trabalho do Log Analytics:
No menu da área de trabalho do Log Analytics, em Clássico, selecione Resumo da área de trabalho. Na página Descrição geral , selecione Gestão de Aplicações Lógicas.
Selecione a linha do fluxo de trabalho que pretende rever.
Na página Execuções , na tabela Execuções da Aplicação Lógica , localize a coluna ID de Controlo e a coluna Propriedades Registadas .
Para procurar as propriedades registadas, utilize o filtro de coluna. Para ver as propriedades, selecione Ver.