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

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, reveja o Enable ou open Application Informações após a implementação de 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 utilizando protocolos como AS2, X12 e EDIFACT. Para verificar se esta comunicação funciona da forma que espera, pode configurar registos do Azure Monitor para a sua conta de integração. O Azure Monitor ajuda-o a monitorizar os ambientes da nuvem e do local para que possa manter mais facilmente a sua disponibilidade e desempenho. Ao utilizar registos do Azure Monitor, pode gravar e armazenar dados sobre dados e eventos de tempo de execução, tais como eventos de desencadeamento, eventos de execução e eventos de ação num espaço de trabalho do Log Analytics. Para mensagens, o registo também recolhe informações como:

  • Contagem de mensagens e estado
  • Estatuto de agradecimento
  • Correlações entre mensagens e reconhecimentos
  • Descrições detalhadas de erros para falhas

O Azure Monitor permite 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 Azure, como a Azure Armazenamento e Hubs de Eventos do Azure.

Para configurar o registo para a sua conta de integração, instale a solução Logic Apps B2B no portal do Azure. Esta solução fornece informações agregadas para eventos de mensagens B2B. Em seguida, para permitir o registo e a criação de consultas para esta informação, crie 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 recentemente atualizado para utilizar os registos do Azure Monitor em vez de Log Analytics. Os dados de registo ainda são armazenados num espaço de trabalho do Log Analytics e ainda são recolhidos e analisados pelo mesmo serviço Log Analytics. Estamos a atualizar a terminologia para melhor refletir o papel dos registos no Azure Monitor. Consulte as alterações da terminologia do Azure Monitor para obter mais detalhes.

Pré-requisitos

Instalar a solução B2B de Aplicativos Lógicas

Antes que os registos do Azure Monitor possam rastrear as mensagens B2B para a sua aplicação lógica, adicione a solução Logic Apps B2B ao seu espaço de trabalho Log Analytics.

  1. Na caixa de pesquisa do portal do Azure, insira e, em log analytics workspacesseguida, selecione log analytics espaços de trabalho.

    Select

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

    Select your Log Analytics workspace

  3. No painel de visão geral, sob Introdução comsoluções de monitorização Log AnalyticsConfigure>, selecione Ver soluções.

    On Overview pane, select

  4. No painel de visão geral, selecione Add.

    On overview pane, add new solution

  5. Depois de o Marketplace abrir, na caixa de pesquisa, insira logic apps b2be selecione As Aplicações Lógicas B2B.

    From Marketplace, select

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

    Select

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

    Select

    Depois de o Azure implementar a solução para o grupo de recursos Azure que contém o seu espaço de trabalho 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.

    Workspace summary pane

Configurar registos do Monitor Azure

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

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

    Find and select your integration account

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

    Under

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

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

    2. Selecione Enviar para Registar Analítico.

    3. Para subscrição, selecione a subscrição Azure que está associada ao seu espaço de trabalho Log Analytics.

    4. Para Log Analytics Workspace, selecione o espaço de trabalho que pretende utilizar.

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

    6. Quando tiver terminado, selecione Guardar.

    Por exemplo:

    Set up Azure Monitor logs to collect diagnostic data

Ver estado da mensagem

Após a execução da sua aplicação lógica, pode visualizar o estado e os dados sobre essas mensagens no seu espaço de trabalho Log Analytics.

  1. Na caixa de pesquisa portal do Azure, encontre e abra o seu espaço de trabalho Log Analytics.

  2. No menu do seu espaço de trabalho, selecione Workspace ResumoLogic>Apps B2B.

    Workspace summary pane

    Nota

    Se o azulejo B2B das Aplicações Lógicas não apresentar imediatamente resultados após uma execução, tente selecionar Refresh ou aguarde um curto período de tempo antes de tentar novamente.

    Por padrão, o azulejo de Aplicações Lógicas B2B mostra dados baseados num único dia. Para alterar o âmbito de dados para um intervalo diferente, selecione o controlo de âmbito na parte superior da página:

    Change interval

  3. Depois de aparecer o painel de estado da mensagem, pode ver mais detalhes para um tipo de mensagem específico, que mostra dados baseados num único dia. Selecione o azulejo para AS2, X12 ou EDIFACT.

    View statuses for messages

    Aparece uma lista de mensagens para o seu azulejo escolhido. Por exemplo, aqui está o que uma lista de mensagens AS2 pode parecer:

    Statuses and details for AS2 messages

    Para saber mais sobre as propriedades de cada tipo de mensagem, consulte estas descrições da propriedade da 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 da propriedade e os formatos de nome para ficheiros de mensagens descarregados.

Descrições de propriedade de mensagens AS2

Aqui estão as descrições da propriedade para cada mensagem AS2.

Propriedade Descrição
Remetente O parceiro convidado especificado em Receber Definições, ou o parceiro anfitrião especificado em Enviar Definições para um acordo AS2
Recetor O parceiro anfitrião especificado em Receber Definições, ou o parceiro convidado especificado em Send Definições para um acordo AS2
Aplicação Lógica A aplicação lógica onde as ações as2 são criadas
Estado O estado da mensagem AS2
Sucesso = Recebeu ou enviou uma mensagem AS2 válida. Não está configurado nenhum MDN.
Sucesso = Recebeu ou enviou uma mensagem AS2 válida. MDN é configurado e recebido, ou MDN é enviado.
Failed = Recebeu uma mensagem AS2 inválida. Não está configurado nenhum MDN.
Pendente = Recebeu ou enviou uma mensagem AS2 válida. A MDN está configurada, e a MDN é esperada.
Rio ACK O estado da mensagem MDN
Aceite = Recebido ou enviado um MDN positivo.
Pendente = Esperando para receber ou enviar um MDN.
Rejeitado = Recebido ou enviado um MDN negativo.
Não É Necessário = MDN não é estabelecido no acordo.
Direção A direção da mensagem AS2
ID de Controlo O ID que correlaciona todos os gatilhos e ações numa aplicação lógica
ID da Mensagem O ID da mensagem AS2 dos cabeçalhos de mensagens AS2
CarimboDeDataEHora O momento em que a ação AS2 processou a mensagem

Descrições da propriedade de mensagens X12

Aqui estão as descrições da propriedade para cada mensagem X12.

Propriedade Descrição
Remetente O parceiro convidado especificado em Receber Definições, ou o parceiro anfitrião especificado em Send Definições para um acordo X12
Recetor O parceiro anfitrião especificado em Receber Definições, ou o parceiro convidado especificado em Send Definições para um acordo X12
Aplicação Lógica A aplicação lógica onde as ações X12 são criadas
Estado O estado da mensagem X12
Sucesso = Recebeu ou enviou uma mensagem X12 válida. Não está configurado nenhum ack funcional.
Sucesso = Recebeu ou enviou uma mensagem X12 válida. Ack funcional é configurada e recebida, ou um ack funcional é enviado.
Falhou = Recebeu ou enviou uma mensagem X12 inválida.
Pendente = Recebido ou enviado uma mensagem X12 válida. Ack funcional é configurado, e espera-se um ack funcional.
Rio ACK Estado funcional do Ack (997)
Aceite = Recebido ou enviado um ack funcional positivo.
Rejeitado = Recebido ou enviado 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 é configurado.
Direção A direção da mensagem X12
ID de Controlo O ID que correlaciona todos os gatilhos e ações numa aplicação lógica
Tipo 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 O tempo em que a ação X12 processou a mensagem

Descrições de propriedades de mensagens EDIFACT

Aqui estão as descrições da propriedade para cada mensagem EDIFACT.

Propriedade Descrição
Remetente O parceiro convidado especificado em Receber Definições, ou o parceiro anfitrião especificado em Send Definições para um acordo EDIFACT
Recetor O parceiro anfitrião especificado em Receber Definições, ou o parceiro convidado especificado em Send Definições para um acordo EDIFACT
Aplicação Lógica A aplicação lógica onde as ações do EDIFACT são criadas
Estado O estado da mensagem EDIFACT
Sucesso = Recebeu ou enviou uma mensagem EDIFACT válida. Não está configurado nenhum ack funcional.
Sucesso = Recebeu ou enviou uma mensagem EDIFACT válida. Ack funcional é configurada e recebida, ou um ack funcional é enviado.
Falhado = Recebido ou enviado uma mensagem EDIFACT inválida
Pendente = Recebeu ou enviou uma mensagem EDIFACT válida. Ack funcional é configurado, e espera-se um ack funcional.
Rio ACK Estado funcional do Ack (CONTRL)
Aceite = Recebido ou enviado um ack funcional positivo.
Rejeitado = Recebido ou enviado 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 Controlo O ID que correlaciona todos os gatilhos e ações numa aplicação lógica
Tipo Msg O tipo de mensagem EDIFACT
ICN O Número de Controlo Intercambial para a mensagem EDIFACT
TSCN O número de controlo do conjunto de transações para a mensagem EDIFACT
CarimboDeDataEHora O tempo em que a ação EDIFACT processou a mensagem

Passos seguintes