Partilhar via


Monitorar e rastrear mensagens B2B em fluxos de trabalho de Consumo para Aplicativos Lógicos do Azure usando o Azure Monitor

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

Observação

Este artigo aplica-se apenas aos fluxos de trabalho da aplicação lógica de consumo. Para fluxos de trabalho de aplicativos lógicos padrão, consulte:

Depois de configurar a comunicação B2B entre parceiros comerciais em uma conta de integração, esses parceiros podem 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-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 de logs também coleta as seguintes informações:

  • Contagem e status de mensagens
  • Status de agradecimentos
  • Correlações entre mensagens e agradecimentos
  • Descrições detalhadas de erros para avarias

O Azure Monitor permite-lhe criar consultas de registo que o ajudam a localizar e rever estas 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 de Aplicativos Lógicos 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 a criação de consultas, você aprenderá a configurar os 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. Consulte Alterações de terminologia do Azure Monitor para obter detalhes.

Pré-requisitos

Instalar a solução B2B do Logic Apps

Antes de os logs do Azure Monitor poderem rastrear as mensagens B2B do seu logic app, adicione a solução Aplicativos Lógicos B2B ao seu espaço de trabalho do Log Analytics.

  1. Na caixa de pesquisa do portal do Azure , insira espaços de trabalho de análise de log e selecione espaços de trabalho do Log Analytics.

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

  2. Em Espaços de trabalho do Log Analytics, selecione seu espaço de trabalho.

    A captura de tela mostra os espaços de trabalho 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, selecione Exibir soluções.

    A captura de tela mostra a página Visão geral do seu espaço de trabalho, onde você pode selecionar Exibir soluções.

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

  5. Depois que o Marketplace abrir, na caixa de pesquisa, digite aplicativos lógicos b2b e selecione Aplicativos lógicos B2B.

    A captura de ecrã mostra o Marketplace onde pode pesquisar e selecionar Logic Apps B2B.

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

    A captura de tela mostra que a opção Criar está selecionada para que a solução B2B do Logic Apps seja adicionada.

  7. Revise e confirme o espaço de trabalho do Log Analytics onde deseja instalar a solução e selecione Criar novamente.

    A captura de tela mostra a página da solução B2B do Logic Apps, onde você pode selecionar assinatura e plano e, em seguida, Criar.

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

  8. Vá para o espaço de trabalho 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 espaço de trabalho com o gráfico de status da mensagem.

Configurar logs do Azure Monitor

Você pode habilitar o log do Azure Monitor diretamente de 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, onde 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, onde você pode adicionar uma configuração de diagnóstico.

  3. Para criar a definição, siga estes passos:

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

    2. Em Detalhes do destino, selecione Enviar para o espaço de trabalho do Log Analytics.

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

    4. Para Espaço de trabalho do Log Analytics, selecione o espaço de trabalho que você deseja usar.

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

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

    Por exemplo:

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

Ver estado da mensagem

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

  1. Na caixa de pesquisa do portal do Azure , localize e abra o grupo de recursos para seu espaço de trabalho 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 curto período de tempo antes de tentar novamente.

    Por padrão, o bloco Logic Apps B2B mostra dados referente a 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 de um tipo de mensagem específico, que mostra dados baseados 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, aqui está 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, 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.

Propriedade Descrição
Sender O parceiro convidado especificado em Configurações de recebimento ou o parceiro host especificado em Configurações de envio para um contrato AS2
Receiver 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. Nenhuma notificação de disposição de mensagem (MDN) está configurada.
Ê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 acordo.
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 presente nos cabeçalhos de mensagem AS2
Marca temporal 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.

Propriedade Descrição
Sender O parceiro convidado especificado em Configurações de recebimento ou o parceiro host especificado em Configurações de envio para um contrato X12
Receiver 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. O ack funcional está configurado, e um ack funcional é esperado.
ACK Estado funcional Ack (997)
Aceito = Recebeu ou enviou um reconhecimento 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
ICN 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
Marca temporal 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.

Propriedade Descrição
Sender O parceiro convidado especificado em Configurações de recebimento ou o parceiro host especificado em Configurações de envio para um contrato EDIFACT
Receiver 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)
Aceite = Recebeu ou enviou um reconhecimento 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 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
ICN 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
Marca temporal A hora em que a ação EDIFACT processou a mensagem