Configurar os registos do Azure Monitor e recolher dados de diagnóstico para mensagens B2B no Azure Logic Apps

  • Artigo

Aplica-se a: Azure Logic Apps (Consumo)

Nota

Este artigo aplica-se apenas às aplicações lógicas de Consumo. Para obter informações sobre a monitorização de aplicações lógicas Standard, veja Ativar ou abrir o Application Insights após a implementação para aplicações lógicas Standard.

Depois de configurar a comunicação B2B entre parceiros comerciais na sua conta de integração, esses parceiros podem trocar mensagens através de protocolos como AS2, X12 e EDIFACT. Para verificar se esta comunicação funciona como esperado, pode configurar os registos do Azure Monitor para a sua conta de integração. O Azure Monitor ajuda-o a monitorizar os seus ambientes na cloud e no local para que possa manter mais facilmente a disponibilidade e o desempenho. Ao utilizar os registos do Azure Monitor, pode registar e armazenar dados sobre dados e eventos de runtime, tais como eventos de acionador, eventos de execução e eventos de ação numa área de trabalho do Log Analytics. Para mensagens, o registo também recolhe informações como:

  • Contagem de mensagens e estado
  • Estado das confirmações
  • Correlações entre mensagens e confirmações
  • Descrições detalhadas de erros para falhas

O Azure Monitor permite-lhe criar consultas de registo para o ajudar a encontrar e rever estas informações. Também pode utilizar estes dados de diagnóstico com outros serviços do Azure, como o Armazenamento do Azure e Hubs de Eventos do Azure.

Para configurar o registo para a sua conta de integração, instale a solução B2B do Logic Apps no portal do Azure. Esta solução fornece informações agregadas para eventos de mensagens B2B. Em seguida, para ativar o registo e a criação de consultas para estas informações, configure os registos do Azure Monitor.

Este artigo mostra como ativar o registo do Azure Monitor para a sua conta de integração.

Nota

Este artigo foi atualizado recentemente para utilizar o termo registos do Azure Monitor em vez do Log Analytics. Os dados de registo continuam a ser armazenados numa área de trabalho do Log Analytics e ainda são recolhidos e analisados pelo mesmo serviço do Log Analytics. Estamos a atualizar a terminologia para refletir melhor a função dos registos no Azure Monitor. Veja Alterações de terminologia do Azure Monitor para obter detalhes.

Pré-requisitos

Instalar a solução B2B do Logic Apps

Antes de os registos do Azure Monitor poderem controlar as mensagens B2B da sua aplicação lógica, adicione a solução B2B do Logic Apps à área de trabalho do Log Analytics.

  1. Na caixa de pesquisa do portal do Azure, introduza log analytics workspacese, em seguida, selecione Áreas de trabalho do Log Analytics.

    Selecione

  2. Em Áreas de trabalho do Log Analytics, selecione a área de trabalho.

    Selecione a área de trabalho do Log Analytics

  3. No painel Descrição Geral, em Introdução ao Log Analytics>Configurar soluções de monitorização, selecioneVer soluções.

    No painel Descrição Geral, selecione

  4. No painel Descrição geral, selecione Adicionar.

    No painel de descrição geral, adicione uma nova solução

  5. Depois de o Marketplace abrir, na caixa de pesquisa, introduza logic apps b2be selecione Logic Apps B2B.

    No Marketplace, selecione

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

    Selecione

  7. Reveja e confirme a área de trabalho do Log Analytics onde pretende instalar a solução e selecione Criar novamente.

    Selecione

    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. Quando as mensagens B2B são processadas, a contagem de mensagens neste painel é atualizada.

    Painel de resumo da área de trabalho

Configurar registos do Azure Monitor

Pode ativar o registo do Azure Monitor diretamente a partir da sua conta de integração.

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

    Localizar e selecionar a sua conta de integração

  2. No menu da conta de integração, em Monitorização, selecione Definições de diagnóstico. Selecione Adicionar definição de diagnóstico.

    Em

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

    1. Indique um nome para a definição.

    2. Selecione Enviar para o Log Analytics.

    3. Em Subscrição, selecione a subscrição do Azure associada à área de trabalho do Log Analytics.

    4. Para Área de Trabalho do Log Analytics, selecione a área de trabalho que pretende utilizar.

    5. Em registo, selecione a categoria IntegrationAccountTrackingEvents , que especifica a categoria de evento que pretende registar.

    6. Quando tiver terminado, selecione Guardar.

    Por exemplo:

    Configurar registos do Azure Monitor para recolher dados de diagnóstico

Ver estado da mensagem

Após a execução da aplicação lógica, pode ver o estado e os dados dessas mensagens na área de trabalho do Log Analytics.

  1. Na caixa de pesquisa portal do Azure, localize e abra a área de trabalho do Log Analytics.

  2. No menu da área de trabalho, selecione Resumo> da área de trabalhoLogic Apps B2B.

    Painel de resumo da área de trabalho

    Nota

    Se o mosaico B2B do Logic Apps não mostrar imediatamente os resultados após uma execução, tente selecionar Atualizar ou aguarde um pouco antes de tentar novamente.

    Por predefinição, o mosaico B2B do Logic Apps mostra dados com base num único dia. Para alterar o âmbito de dados para um intervalo diferente, selecione o controlo de âmbito na parte superior da página:

    Alterar intervalo

  3. Depois de o dashboard de estado da mensagem ser apresentado, pode ver mais detalhes de um tipo de mensagem específico, que mostra os dados com base num único dia. Selecione o mosaico para AS2, X12 ou EDIFACT.

    Ver estados de mensagens

    É apresentada uma lista de mensagens para o mosaico escolhido. Por exemplo, eis o aspeto de uma lista de mensagens AS2:

    Estados e detalhes das mensagens AS2

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

Descrições de propriedades e formatos de nome para mensagens AS2, X12 e EDIFACT

Para cada tipo de mensagem, seguem-se as descrições de propriedades e formatos de nome para ficheiros de mensagens transferidos.

Descrições de propriedades de mensagens AS2

Eis as descrições de propriedades para cada mensagem AS2.

Propriedade Descrição
Remetente O parceiro convidado especificado em Definições de Receção ou o parceiro de anfitrião especificado em Definições de Envio para um contrato AS2
Recetor O parceiro de 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 A aplicação lógica onde as ações as2 estão configuradas
Estado O estado da mensagem AS2
Êxito = Recebeu ou enviou uma mensagem AS2 válida. Não está configurada nenhuma MDN.
Êxito = Recebeu ou enviou uma mensagem AS2 válida. A MDN é configurada e recebida ou a MDN é enviada.
Falha = Recebeu uma mensagem AS2 inválida. Não está configurada nenhuma MDN.
Pendente = Recebido ou enviado uma mensagem AS2 válida. A MDN está configurada e a MDN é esperada.
ACK O estado da mensagem MDN
Aceite = Recebeu ou enviou uma MDN positiva.
Pendente = A aguardar para receber ou enviar uma MDN.
Rejeitado = Recebido ou enviado um MDN negativo.
Não Obrigatório = A MDN não está configurada no contrato.
Direção A direção da mensagem AS2
ID de Controlo O ID que correlaciona todos os acionadores e ações numa aplicação lógica
ID da Mensagem O ID da mensagem AS2 dos cabeçalhos de mensagens AS2
CarimboDeDataEHora A hora em que a ação AS2 processou a mensagem

Descrições de propriedades de mensagens X12

Eis as descrições de propriedades para cada mensagem X12.

Propriedade Descrição
Remetente O parceiro convidado especificado em Definições de Receção ou o parceiro de anfitrião especificado em Definiçõ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 A aplicação lógica onde as ações X12 estão configuradas
Estado O estado da mensagem X12
Êxito = Recebeu ou enviou uma mensagem X12 válida. Não está configurado nenhum ack funcional.
Êxito = Recebeu ou enviou uma mensagem X12 válida. O ack funcional é configurado e recebido ou é enviado um ack funcional.
Falhou = Recebeu ou enviou uma mensagem X12 inválida.
Pendente = Recebido ou enviado uma mensagem X12 válida. O ack funcional está configurado e é esperado um ack funcional.
ACK Estado funcional do Ack (997)
Aceite = Recebido ou enviado um ack funcional positivo.
Rejeitado = Recebido ou enviado um ack funcional negativo.
Pendente = Espera um ack funcional, mas não recebido.
Pendente = Gerou um ack funcional, mas não consegue enviar para o parceiro.
Não Necessário = Ack funcional não está configurado.
Direção A direção da mensagem X12
ID de Controlo O ID que correlaciona todos os acionadores e ações numa aplicação lógica
Tipo de Msg O tipo de mensagem EDI X12
ICN O Número de Controlo de Intercâmbio para a mensagem X12
TSCN O Número de Controlo do Conjunto de Transações para a mensagem X12
CarimboDeDataEHora A hora em que a ação X12 processou a mensagem

Descrições de propriedades de mensagens EDIFACT

Eis as descrições das propriedades de cada mensagem EDIFACT.

Propriedade Descrição
Remetente O parceiro convidado especificado em Definições de Receção ou o parceiro de anfitrião especificado em Definições de Envio para um contrato EDIFACT
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 EDIFACT
Aplicação Lógica A aplicação lógica onde as ações EDIFACT estão configuradas
Estado O estado da mensagem EDIFACT
Success = Recebeu ou enviou uma mensagem EDIFACT válida. Não está configurado nenhum ack funcional.
Success = Recebeu ou enviou uma mensagem EDIFACT válida. O ack funcional é configurado e recebido ou é enviado um ack funcional.
Falhou = Recebeu ou enviou uma mensagem EDIFACT inválida
Pendente = Recebido ou enviado uma mensagem EDIFACT válida. O ack funcional está configurado e é esperado um ack funcional.
ACK Estado funcional do Ack (CONTRL)
Aceite = Recebido ou enviado um ack funcional positivo.
Rejeitado = Recebido ou enviado um ack funcional negativo.
Pendente = Espera um ack funcional, mas não recebido.
Pendente = Gerou um ack funcional, mas não consegue 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 Controlo O ID que correlaciona todos os acionadores e ações numa aplicação lógica
Tipo de Msg O tipo de mensagem EDIFACT
ICN O Número de Controlo de Intercâmbio para a mensagem EDIFACT
TSCN O Número de Controlo do Conjunto de Transações para a mensagem EDIFACT
CarimboDeDataEHora A hora em que a ação EDIFACT processou a mensagem

Passos seguintes