Compartilhar via


Monitorar e acompanhar mensagens B2B nos fluxos de trabalho de Consumo para o Azure Logic Apps usando o Azure Monitor

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

Observação

Este artigo se aplica somente aos fluxos de trabalho do aplicativo lógico de Consumo. Para fluxos de trabalho do aplicativo lógico Standard, consulte:

Depois de configurar a comunicação B2B entre parceiros comerciais em uma conta de integração, esses parceiros poderão trocar mensagens usando protocolos como AS2, X12 e EDIFACT. Para confirmar se essa comunicação funciona conforme o esperado, configure os logs do Azure Monitor para sua conta de integração.

O Azure Monitor ajuda você a monitorar seus ambientes locais e de nuvem para que você possa manter mais facilmente sua disponibilidade e desempenho. Usando logs do Azure Monitor, você pode gravar e armazenar dados sobre dados e eventos de runtime, como eventos de gatilho, eventos de execução e eventos de ação em um workspace do Log Analytics.

Para mensagens, o log também coleta as seguintes informações:

  • Contagem e status de mensagens
  • Status de confirmações
  • Correlações entre mensagens e confirmações
  • Descrições detalhadas de erro para falhas

O Azure Monitor permite criar consultas de log que ajudam você a encontrar e examinar 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.

Este guia mostra como configurar o log do Azure Monitor para sua conta de integração. Primeiro, instale a solução B2B dos Aplicativos Lógicos no portal do Azure. Essa solução fornece informações agregadas para eventos de mensagem B2B. Em seguida, para habilitar o registro em log e a criação de consultas, você aprenderá a configurar logs do Azure Monitor.

Para obter mais informações, consulte:

Observação

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. Confira as alterações de terminologia do Azure Monitor para obter detalhes.

Pré-requisitos

Instalar a solução B2B do Logic Apps

Antes que os logs do Azure Monitor possam rastrear mensagens B2B para seu aplicativo lógico, inclua a solução Aplicativos Lógicos B2B no workspace do Log Analytics.

  1. Na caixa de pesquisa do portal do Azure, digite workspaces do Log Analytics e selecione Workspaces do Log Analytics.

    A captura de tela mostra a caixa de pesquisa no portal do Azure com os espaços de trabalho do Log Analytics destacados.

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

    A captura de tela mostra os workspaces do Log Analytics que você pode selecionar.

  3. Na página Visão geral , em Introdução ao Log Analytics>Configurar soluções de monitoramento, selecioneExibir soluções.

    A captura de tela mostra a página Visão geral do workspace em que você pode selecionar Exibir soluções.

  4. Na página Visão geral , selecione Adicionar.

  5. Depois que o Marketplace for aberto, na caixa de pesquisa, insira os aplicativos lógicos b2b e selecione Aplicativos Lógicos B2B.

    A captura de tela mostra o Marketplace no qual você pode pesquisar e selecionar Aplicativos Lógicos B2B.

  6. No painel de descrição da solução, selecione Criar.

    A captura de tela mostra a opção "Criar" selecionada para adicionar a solução B2B de Logic Apps.

  7. Examine e confirme o workspace do Log Analytics no qual você deseja instalar a solução e selecione Criar novamente.

    A captura de tela mostra a página de solução B2B dos Aplicativos Lógicos, na qual você pode selecionar a assinatura e o plano e, em seguida, criar.

    O Azure implanta a solução no grupo de recursos do Azure que contém seu workspace do Log Analytics.

  8. Vá para o workspace do Log Analytics, na página Visão geral , na guia Introdução , selecione Exibir soluções novamente para ver a solução instalada. Selecione o bloco da solução para exibir mais detalhes da mensagem.

    Quando o fluxo de trabalho processa mensagens B2B, os gráficos são atualizados com a contagem de mensagens.

    A captura de tela mostra a página Visão geral do workspace com o gráfico de status da mensagem.

Configurar os logs do Azure Monitor

Você pode ativar o log do Azure Monitor diretamente na sua conta de integração.

  1. No portal do Azure, localize e selecione sua conta de integração.

    A captura de tela mostra a página Contas de integração em que você pode selecionar sua conta de integração.

  2. Na barra lateral da conta de integração, em Monitoramento, selecione Configurações de diagnóstico. Na tabela Configurações de diagnóstico , selecione Adicionar configuração de diagnóstico.

    A captura de tela mostra a página configurações de diagnóstico em que você pode adicionar uma configuração de diagnóstico.

  3. Para criar a configuração, siga estas etapas:

    1. Para o nome da configuração de diagnóstico, forneça um nome.

    2. Em Detalhes do destino, selecione Enviar para o workspace do Log Analytics.

    3. Para Assinatura, selecione a assinatura do Azure para o seu espaço de trabalho do Log Analytics.

    4. Para Workspace do Log Analytics, selecione o workspace que você quer usar.

    5. Em Logs, selecione eventos de acompanhamento da Conta de Integração, que especifica a categoria de evento que você deseja gravar.

    6. Quando terminar, na barra de ferramentas, selecione Salvar.

    Por exemplo:

    A captura de tela mostra a página Configuração de diagnóstico em que você pode configurar logs do Azure Monitor para coletar dados de diagnóstico.

Exibir o status da mensagem

Depois que o fluxo de trabalho for executado, você poderá exibir o status e os dados sobre as mensagens B2B trocadas por parceiros.

  1. Na caixa de pesquisa do portal do Azure , localize e abra o grupo de recursos para seu workspace do Log Analytics.

  2. No grupo de recursos, selecione a solução B2B de Aplicativos Lógicos que você instalou anteriormente.

  3. Na barra lateral da solução, selecione Resumo.

    A captura de tela mostra a página Resumo da solução.

    Observação

    Se o bloco B2B dos Aplicativos Lógicos não mostrar resultados imediatamente após uma execução, tente atualizar o navegador ou aguarde um pouco antes de tentar novamente.

    Por padrão, o bloco Logic Apps B2B mostra dados com base 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:

    A captura de tela mostra o controle para alterar o intervalo.

  4. Depois que o painel de status da mensagem for exibido, você poderá exibir mais detalhes para um tipo de mensagem específico, que mostra dados com base em um único dia. Selecione o bloco para AS2, X12 ou EDIFACT.

    A captura de tela mostra as mensagens de status.

    Uma lista de mensagens é exibida para o bloco escolhido. Por exemplo, veja a aparência de uma lista de mensagens AS2:

    A captura de tela mostra os status e os detalhes das mensagens AS2.

    Para saber mais sobre as propriedades de cada tipo de mensagem, confira estas descrições de propriedade de mensagem:

Descrições de propriedade 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 mensagens baixados.

Descrições do atributo de mensagem AS2

Estas são as descrições de propriedade para cada mensagem AS2.

Propriedade 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
Receptor O parceiro host especificado em Configurações de Recebimento ou o parceiro convidado especificado em Configurações de Envio para um contrato AS2
Aplicativo Lógico O aplicativo lógico em que as ações AS2 são configuradas
Status O status da mensagem AS2
Êxito = Recebeu ou enviou uma mensagem AS2 válida. Nenhuma MDN (Notificação de Disposição de Mensagem) está configurada.
Êxito = Recebeu ou enviou uma mensagem AS2 válida. O MDN está configurado e é recebido ou o 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 = Recebido ou enviado com um MDN positivo.
Pendente = Esperando para receber ou enviar um MDN.
Rejeitado = recebimento ou envio de um MDN negativo.
Não Obrigatório = O MDN não está especificado 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 ID da mensagem AS2 dos cabeçalhos da mensagem AS2
Timestamp A hora em que a ação AS2 processou a mensagem

Descrições das propriedades de mensagens X12

Estas são as descrições de propriedade para cada mensagem X12.

Propriedade 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
Receptor O parceiro host especificado em Configurações de Recebimento ou o parceiro convidado especificado em Configurações de Envio para um contrato X12
Aplicativo Lógico O aplicativo lógico em que as ações X12 são configuradas
Status O status da mensagem X12
Êxito = Recebeu ou enviou uma mensagem X12 válida. Nenhuma confirmação funcional está configurada.
Êxito = Recebeu ou enviou uma mensagem X12 válida. Uma confirmação funcional está configurada e é recebida ou uma confirmação funcional é enviada.
Falha = Recebeu ou enviou uma mensagem X12 inválida.
Pendente = Recebeu ou enviou uma mensagem X12 válida. Uma confirmação funcional está configurada e uma confirmação funcional é esperada.
ACK Status da Confirmação Funcional (997)
Aceito = recebimento ou envio de uma confirmação funcional positiva.
Rejeitado = recebimento ou envio de uma confirmação funcional negativa.
Pendente = aguardando uma confirmação funcional, mas não recebida.
Pendente = geração de uma confirmação funcional, mas não foi possível enviá-la ao parceiro.
Não Obrigató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 mensagem O tipo de mensagem EDI X12
ICN O Número de Controle de Intercâmbio da mensagem X12
TSCN O Número de Controle do Conjunto de Transações da mensagem X12
Timestamp A hora em que a ação X12 processou a mensagem

Descrições das propriedades de mensagens EDIFACT

Estas são as descrições de propriedade para cada mensagem EDIFACT.

Propriedade 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
Receptor O parceiro host especificado em Configurações de Recebimento ou o parceiro convidado especificado em Configurações de Envio para um contrato EDIFACT
Aplicativo Lógico O aplicativo lógico em que as ações EDIFACT são configuradas
Status O status da mensagem EDIFACT
Êxito = Recebeu ou enviou uma mensagem EDIFACT válida. Nenhuma confirmação funcional está configurada.
Êxito = Recebeu ou enviou uma mensagem EDIFACT válida. Uma confirmação funcional está configurada e é recebida ou uma confirmação funcional é enviada.
Falha = Recebeu ou enviou uma mensagem EDIFACT inválida
Pending = Mensagem EDIFACT válida recebida ou enviada, aguardando processamento. Uma confirmação funcional está configurada e uma confirmação funcional é esperada.
ACK Status funcional do Ack (CONTRL)
Aceito = recebimento ou envio de uma confirmação funcional positiva.
Rejeitado = recebimento ou envio de uma confirmação funcional negativa.
Pendente = aguardando uma confirmação funcional, mas não recebida.
Pendente = geração de uma confirmação funcional, mas não foi possível enviá-la ao parceiro.
Não Obrigatório = O 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 mensagem O tipo de mensagem EDIFACT
ICN Número de Controle de Intercâmbio para a mensagem EDIFACT
TSCN O Número de Controle do Conjunto de Transações da mensagem EDIFACT
Timestamp A hora em que a ação EDIFACT processou a mensagem