Partilhar via


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

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.

  1. Na caixa de pesquisa do portal do Azure, digite log analytics workspacese selecione Espaços de trabalho do Log Analytics.

    Selecione

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

    Selecione a sua área de trabalho do Log Analytics

  3. 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

  4. No painel Visão geral, selecione Adicionar.

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

  5. Depois que o Marketplace abrir, na caixa de pesquisa, digite logic apps b2be selecione Aplicativos lógicos B2B.

    No Marketplace, selecione

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

    Selecione

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

    Selecione

    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.

    Painel de resumo do espaço de trabalho

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.

    Encontre e selecione sua conta de integração

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

    Em

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

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

    2. Selecione Enviar para o Log Analytics.

    3. Em Assinatura, selecione a assinatura do Azure associada ao 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 log, selecione a categoria IntegrationAccountTrackingEvents , que especifica a categoria de evento que você deseja registrar.

    6. Quando tiver terminado, selecione Guardar.

    Por exemplo:

    Configurar logs do Azure Monitor para coletar dados de diagnóstico

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.

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

  2. No menu do seu espaço de trabalho, selecione Resumo>do espaço de trabalho Aplicativos lógicos B2B.

    Painel de resumo do espaço de trabalho

    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:

    Intervalo de alteração

  3. 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.

    Exibir status de mensagens

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

    Status e 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.

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

Próximos passos