Configurar os registos do Azure Monitor e recolher dados de diagnóstico para mensagens B2B no Azure Logic Apps
Aplica-se a: Aplicativos Lógicos do Azure (Consumo)
Nota
Este artigo aplica-se apenas a aplicações lógicas de consumo. Para obter informações sobre como monitorar aplicativos lógicos padrão, revise Habilitar ou abrir o Application Insights após a implantação de aplicativos lógicos padrão.
Depois de configurar a comunicação B2B entre parceiros comerciais em sua conta de integração, esses parceiros podem trocar mensagens usando protocolos como AS2, X12 e EDIFACT. Para verificar se essa comunicação funciona da maneira esperada, você pode configurar os logs do Azure Monitor para sua conta de integração. O Azure Monitor ajuda-o a monitorizar os seus ambientes na nuvem e no local para que possa manter mais facilmente a sua disponibilidade e desempenho. Usando logs do Azure Monitor, você pode registrar e armazenar dados sobre dados e eventos de tempo de execução, como eventos de gatilho, eventos de execução e eventos de ação em um espaço de trabalho do Log Analytics. Para mensagens, o registro também coleta informações como:
- Contagem e status de mensagens
- Status de agradecimentos
- Correlações entre mensagens e agradecimentos
- Descrições detalhadas de erros para falhas
O Azure Monitor permite criar consultas de log para ajudá-lo a localizar e revisar essas informações. Você também pode usar esses dados de diagnóstico com outros serviços do Azure, como o Armazenamento do Azure e os Hubs de Eventos do Azure.
Para configurar o registo para a sua conta de integração, instale a solução B2B das Aplicações Lógicas no portal do Azure. Esta solução fornece informações agregadas para eventos de mensagens B2B. Em seguida, para habilitar o registro em log e criar consultas para essas informações, configure os logs do Azure Monitor.
Este artigo mostra como habilitar o log do Azure Monitor para sua conta de integração.
Nota
Este artigo foi atualizado recentemente para usar o termo logs do Azure Monitor em vez de Log Analytics. Os dados de log ainda são armazenados em um espaço de trabalho do Log Analytics e ainda são coletados e analisados pelo mesmo serviço do Log Analytics. Estamos atualizando a terminologia para refletir melhor a função dos logs no Azure Monitor. Consulte Alterações de terminologia do Azure Monitor para obter detalhes.
Pré-requisitos
Uma área de trabalho do Log Analytics. Se você não tiver um espaço de trabalho do Log Analytics, saiba como criar um espaço de trabalho do Log Analytics.
Um aplicativo lógico que é configurado com o log do Azure Monitor e envia essas informações para um espaço de trabalho do Log Analytics. Saiba como configurar os logs do Azure Monitor para seu aplicativo lógico.
Uma conta de integração vinculada ao seu aplicativo lógico. Saiba como vincular sua conta de integração ao seu aplicativo lógico.
Instalar a solução B2B do Logic Apps
Antes que os logs do Azure Monitor possam rastrear as mensagens B2B do seu aplicativo lógico, adicione a solução B2B dos Aplicativos Lógicos ao seu espaço de trabalho do Log Analytics.
Na caixa de pesquisa do portal do Azure, digite
log analytics workspaces
e selecione Espaços de trabalho do Log Analytics.Em Espaços de trabalho do Log Analytics, selecione seu espaço de trabalho.
No painel Visão geral, em Introdução ao Log Analytics>Configurar soluções de monitoramento, selecione Exibir soluções.
No painel Visão geral, selecione Adicionar.
Depois que o Marketplace abrir, na caixa de pesquisa, digite
logic apps b2b
e selecione Aplicativos lógicos B2B.No painel de descrição da solução, selecione Criar.
Revise e confirme o espaço de trabalho do Log Analytics onde deseja instalar a solução e selecione Criar novamente.
Depois que o Azure implanta a solução no grupo de recursos do Azure que contém seu espaço de trabalho do Log Analytics, a solução aparece no painel de resumo do seu espaço de trabalho. Quando as mensagens B2B são processadas, a contagem de mensagens neste painel é atualizada.
Configurar logs do Azure Monitor
Você pode habilitar o log do Azure Monitor diretamente de sua conta de integração.
No portal do Azure, localize e selecione sua conta de integração.
No menu da sua conta de integração, em Monitoramento, selecione Configurações de diagnóstico. Selecione Adicionar definição de diagnóstico.
Para criar a definição, siga estes passos:
Forneça um nome para a configuração.
Selecione Enviar para o Log Analytics.
Em Assinatura, selecione a assinatura do Azure associada ao seu espaço de trabalho do Log Analytics.
Para Espaço de trabalho do Log Analytics, selecione o espaço de trabalho que você deseja usar.
Em log, selecione a categoria IntegrationAccountTrackingEvents , que especifica a categoria de evento que você deseja registrar.
Quando tiver terminado, selecione Guardar.
Por exemplo:
Ver estado da mensagem
Depois que seu aplicativo lógico for executado, você poderá exibir o status e os dados sobre essas mensagens em seu espaço de trabalho do Log Analytics.
Na caixa de pesquisa do portal do Azure, localize e abra seu espaço de trabalho do Log Analytics.
No menu do seu espaço de trabalho, selecione Resumo>do espaço de trabalho Aplicativos lógicos B2B.
Nota
Se o bloco B2B dos Aplicativos Lógicos não mostrar resultados imediatamente após uma execução, tente selecionar Atualizar ou aguarde um curto período de tempo antes de tentar novamente.
Por padrão, o bloco B2B dos Aplicativos Lógicos mostra dados baseados em um único dia. Para alterar o escopo de dados para um intervalo diferente, selecione o controle de escopo na parte superior da página:
Depois que o painel de status da mensagem for exibido, você poderá exibir mais detalhes de um tipo de mensagem específico, que mostra dados baseados em um único dia. Selecione o bloco para AS2, X12 ou EDIFACT.
Uma lista de mensagens é exibida para o bloco escolhido. Por exemplo, aqui está a aparência de uma lista de mensagens AS2:
Para saber mais sobre as propriedades de cada tipo de mensagem, consulte estas descrições de propriedades de mensagem:
Descrições de propriedades e formatos de nome para mensagens AS2, X12 e EDIFACT
Para cada tipo de mensagem, aqui estão as descrições de propriedade e os formatos de nome para arquivos de mensagem baixados.
Descrições das propriedades da mensagem AS2
Aqui estão as descrições das propriedades para cada mensagem AS2.
Property | Description |
---|---|
Remetente | O parceiro convidado especificado em Configurações de recebimento ou o parceiro host especificado em Configurações de envio para um contrato AS2 |
Recetor | O parceiro anfitrião especificado em Definições de Receção ou o parceiro convidado especificado em Definições de Envio para um contrato AS2 |
Aplicação Lógica | O aplicativo lógico onde as ações AS2 são configuradas |
Status | O status da mensagem AS2 Êxito = Recebeu ou enviou uma mensagem AS2 válida. Nenhum MDN está configurado. Êxito = Recebeu ou enviou uma mensagem AS2 válida. MDN é configurado e recebido, ou MDN é enviado. Falha = Recebeu uma mensagem AS2 inválida. Nenhum MDN está configurado. Pendente = Recebeu ou enviou uma mensagem AS2 válida. O MDN está configurado e o MDN é esperado. |
ACK | O status da mensagem MDN Aceito = Recebeu ou enviou um MDN positivo. Pendente = Aguardando para receber ou enviar um MDN. Rejeitado = Recebeu ou enviou um MDN negativo. Não necessário = MDN não está configurado no contrato. |
Direção | A direção da mensagem AS2 |
ID de rastreamento | A ID que correlaciona todos os gatilhos e ações em um aplicativo lógico |
ID da mensagem | O ID da mensagem AS2 dos cabeçalhos de mensagem AS2 |
Carimbo de data/hora | A hora em que a ação AS2 processou a mensagem |
Descrições das propriedades da mensagem X12
Aqui estão as descrições das propriedades para cada mensagem X12.
Property | Description |
---|---|
Remetente | O parceiro convidado especificado em Configurações de recebimento ou o parceiro host especificado em Configurações de envio para um contrato X12 |
Recetor | O parceiro anfitrião especificado em Definições de Receção ou o parceiro convidado especificado em Definições de Envio para um contrato X12 |
Aplicação Lógica | O aplicativo lógico onde as ações X12 são configuradas |
Status | O status da mensagem X12 Êxito = Recebeu ou enviou uma mensagem X12 válida. Nenhum ack funcional está configurado. Êxito = Recebeu ou enviou uma mensagem X12 válida. O ack funcional é configurado e recebido, ou um ack funcional é enviado. Falha = Recebeu ou enviou uma mensagem X12 inválida. Pendente = Recebeu ou enviou uma mensagem X12 válida. Funcional ack é configurado, e um ack funcional é esperado. |
ACK | Estado funcional Ack (997) Aceito = Recebeu ou enviou um ack funcional positivo. Rejeitado = Recebeu ou enviou um ack funcional negativo. Pendente = Esperando um ack funcional, mas não recebido. Pendente = Gerou um ack funcional, mas não pode enviar para o parceiro. Não necessário = O ack funcional não está configurado. |
Direção | A direção da mensagem X12 |
ID de rastreamento | A ID que correlaciona todos os gatilhos e ações em um aplicativo lógico |
Tipo de Msg | O tipo de mensagem EDI X12 |
RIC | O número de controle de intercâmbio para a mensagem X12 |
TSCN | O número de controle do conjunto de transações para a mensagem X12 |
Carimbo de data/hora | A hora em que a ação X12 processou a mensagem |
Descrições das propriedades da mensagem EDIFACT
Aqui estão as descrições das propriedades para cada mensagem EDIFACT.
Property | Description |
---|---|
Remetente | O parceiro convidado especificado em Configurações de recebimento ou o parceiro host especificado em Configurações de envio para um contrato EDIFACT |
Recetor | O parceiro anfitrião especificado em Configurações de recebimento ou o parceiro convidado especificado em Configurações de envio para um contrato EDIFACT |
Aplicação Lógica | O aplicativo lógico onde as ações EDIFACT são configuradas |
Status | O status da mensagem EDIFACT Sucesso = Recebeu ou enviou uma mensagem EDIFACT válida. Nenhum ack funcional está configurado. Sucesso = Recebeu ou enviou uma mensagem EDIFACT válida. O ack funcional é configurado e recebido, ou um ack funcional é enviado. Falha = Recebeu ou enviou uma mensagem EDIFACT inválida Pendente = Recebeu ou enviou uma mensagem EDIFACT válida. Funcional ack é configurado, e um ack funcional é esperado. |
ACK | Estado de Ack funcional (CONTRL) Aceito = Recebeu ou enviou um ack funcional positivo. Rejeitado = Recebeu ou enviou um ack funcional negativo. Pendente = Esperando um ack funcional, mas não recebido. Pendente = Gerou um ack funcional, mas não pode enviar para o parceiro. Não necessário = Ack funcional não está configurado. |
Direção | A direção da mensagem EDIFACT |
ID de rastreamento | A ID que correlaciona todos os gatilhos e ações em um aplicativo lógico |
Tipo de Msg | O tipo de mensagem EDIFACT |
RIC | O número de controle de intercâmbio para a mensagem EDIFACT |
TSCN | O número de controle do conjunto de transações para a mensagem EDIFACT |
Carimbo de data/hora | A hora em que a ação EDIFACT processou a mensagem |