Compartilhar via


Configurar logs de Azure Monitor e coletar dados de diagnóstico para mensagens B2B em aplicativos lógicos do Azure

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

Observação

Este artigo só se aplica a aplicativos lógicos de Consumo. Para obter informações sobre como monitorar aplicativos lógicos Standard, revise Habilitar ou abrir o Application Insights após a implantação para aplicativos lógicos Standard.

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 você a monitorar os ambientes locais e na nuvem para que você possa manter com mais facilidade a disponibilidade e o desempenho deles. Usando logs de Azure Monitor, você pode registrar e armazenar dados sobre dados de runtime e eventos, como eventos de gatilho, de execução e de ação, em um workspace do Log Analytics. Para mensagens, o registro em log também coleta informações como:

  • Status e contagem de mensagens
  • Status de confirmações
  • Correlações entre mensagens e confirmações
  • Descrição de erro detalhada para falhas

O Azure Monitor permite que você crie consultas de log para ajudá-lo a encontrar e examinar essas informações. Também é possível usar esses dados de diagnóstico com outros serviços do Azure, como o Armazenamento do Microsoft Azure e os Hubs de Eventos do Azure.

Para configurar o registro em log para sua conta de integração, instale a solução Aplicativos Lógicos B2B no portal do Azure. Essa 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 registro em log do Azure Monitor para sua conta de integração.

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 de B2B de aplicativos lógicos

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 log analytics workspaces e selecione Workspaces do Log Analytics.

    Selecione

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

    Selecionar o espaço 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 Visão Geral, adicione a nova solução

  5. Depois que o Marketplace for aberto, na caixa de pesquisa, digite logic apps b2b e 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 workspace do Log Analytics onde deseja instalar a solução e selecione Criar novamente.

    Selecione

    Depois que o Azure implantar a solução no grupo de recursos do Azure que contém seu workspace do Log Analytics, a solução aparecerá no painel de resumo do workspace. Quando mensagens B2B são processadas, a contagem de mensagens neste painel é atualizada.

    Painel de resumo do workspace

Configurar os logs do Azure Monitor

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

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

    Localize e selecione a conta de integração

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

    Em

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

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

    2. Selecione Enviar para o Log Analytics.

    3. Para Assinatura, selecione a assinatura do Azure associada ao seu workspace do Log Analytics.

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

    5. Em log, selecione a categoria IntegrationAccountTrackingEvents, que especifica a categoria de evento que você quer registrar.

    6. Quando terminar, selecione Salvar.

    Por exemplo:

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

Exibir status da mensagem

Depois que o aplicativo lógico for executado, você poderá exibir o status e os dados sobre essas mensagens em seu workspace do Log Analytics.

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

  2. No menu do seu workspace, selecione Resumo do workspace>Aplicativos Lógicos B2B.

    Painel de resumo do workspace

    Observação

    Se o bloco Aplicativos Lógicos B2B não mostrar imediatamente os resultados após uma execução, tente selecionar Atualizar ou aguarde um breve momento 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:

    Alterar intervalo

  3. Após a exibição do painel de status de mensagens, você poderá exibir mais detalhes de um tipo de mensagem específico, que mostra dados com base em um único dia. Selecione o bloco AS2, X12 ou EDIFACT.

    Exibir status de mensagens

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

    Status e detalhes de mensagens AS2

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

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

Para cada tipo de mensagem, estas são as descrições de propriedade e os formatos de nome dos arquivos de mensagem baixados.

Descrições de propriedade da mensagem AS2

Estas são as descrições das propriedades de cada mensagem AS2.

Propriedade Descrição
Remetente O parceiro convidado especificado em Configurações de Recebimento ou o parceiro host especificado em Configurações de Envio de um contrato do AS2
Receptor O parceiro host especificado em Configurações de Recebimento ou o parceiro convidado em Configurações de Envio de um contrato do AS2
Aplicativo Lógico O aplicativo lógico no qual as ações do AS2 são configuradas
Status O status da mensagem AS2
Êxito = recebimento ou envio de uma mensagem AS2 válida. Nenhum MDN está configurado.
Êxito = recebimento ou envio de uma mensagem AS2 válida. O MDN está configurado e é recebido ou o MDN é enviado.
Com Falha = recebimento de uma mensagem AS2 inválida. Nenhum MDN está configurado.
Pendente = recebimento ou envio de uma mensagem AS2 válida. O MDN está configurado e o MDN é esperado.
ACK O status da mensagem MDN
Aceito = recebimento ou envio de um MDN positivo.
Pendente = aguardando recebimento ou envio de um MDN.
Rejeitado = recebimento ou envio de um MDN negativo.
Não Obrigatório = o 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 todas as 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 do AS2 processou a mensagem

Descrições das propriedades da mensagem X12

Estas são as descrições das propriedades de cada mensagem X12.

Propriedade Descrição
Remetente O parceiro convidado especificado em Configurações de Recebimento ou o parceiro host especificado em Configurações de Envio de um contrato do X12
Receptor O parceiro host especificado em Configurações de Recebimento ou o parceiro convidado especificado em Configurações de Envio de um contrato do X12
Aplicativo Lógico O aplicativo lógico no qual as ações do X12 são configuradas
Status O status da mensagem X12
Êxito = recebimento ou envio de uma mensagem X12 válida. Nenhuma confirmação funcional está configurada.
Êxito = recebimento ou envio de uma mensagem X12 válida. Uma confirmação funcional está configurada e é recebida ou uma confirmação funcional é enviada.
Com Falha = recebimento ou envio de uma mensagem X12 inválida.
Pendente = recebimento ou envio de 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 = uma confirmação funcional não está configurada.
Direção A direção da mensagem X12
ID de rastreamento A ID que correlaciona todos os gatilhos e todas as 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 do X12 processou a mensagem

Descrições das propriedades da mensagem EDIFACT

Estas são as descrições das propriedades de cada mensagem EDIFACT.

Propriedade Descrição
Remetente O parceiro convidado especificado em Configurações de Recebimento ou o parceiro host especificado em Configurações de Envio de um contrato do EDIFACT
Receptor O parceiro host especificado em Configurações de Recebimento ou o parceiro convidado especificado em Configurações de Envio de um contrato do EDIFACT
Aplicativo Lógico O aplicativo lógico no qual as ações do EDIFACT são configuradas
Status O status da mensagem EDIFACT
Êxito = recebimento ou envio de uma mensagem EDIFACT válida. Nenhuma confirmação funcional está configurada.
Êxito = recebimento ou envio de uma mensagem EDIFACT válida. Uma confirmação funcional está configurada e é recebida ou uma confirmação funcional é enviada.
Com Falha = recebimento ou envio de uma mensagem EDIFACT inválida
Pendente = recebimento ou envio de uma mensagem EDIFACT válida. 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 = uma confirmação funcional não está configurada.
Direção A direção da mensagem EDIFACT
ID de rastreamento A ID que correlaciona todos os gatilhos e todas as ações em um aplicativo lógico
Tipo de mensagem O tipo da mensagem EDIFACT
ICN O Número de Controle de Intercâmbio da mensagem EDIFACT
TSCN O Número de Controle do Conjunto de Transações da mensagem EDIFACT
Timestamp A hora em que a ação do EDIFACT processou a mensagem

Próximas etapas