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
Um espaço de trabalho do Log Analytics. Se você não tiver um espaço de trabalho do Log Analytics, saibacomo criar um espaço de trabalho do Log Analytics.
Um aplicativo lógico que é configurado com o registro em log do Azure Monitor e envia essas informações para um espaço de trabalho do Log Analytics. Saiba como configurar os logs do Azure Monitor para seu aplicativo lógico.
Uma conta de integração vinculada ao aplicativo lógico. Saiba como vincular sua conta de integração ao aplicativo lógico.
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.
Na caixa de pesquisa do portal do Azure, digite
log analytics workspacese selecione Workspaces do Log Analytics.
Em Workspaces do Log Analytics, selecione o workspace.
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 Adicionar.
Depois que o Marketplace for aberto, na caixa de pesquisa, digite
logic apps b2be selecione Aplicativos Lógicos B2B.
No painel de descrição da solução, selecione Criar.
Revise e confirme o workspace do Log Analytics onde deseja instalar a solução e selecione Criar novamente.
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.
Configurar os logs do Azure Monitor
Você pode habilitar o registro em log do Azure Monitor diretamente na sua conta de integração.
No portal do Azure, encontre e selecione sua conta de integração.
No menu da sua conta de integração, em Monitoramento, selecione Configurações de diagnóstico. Selecione Adicionar configuração de diagnóstico.
Para criar a configuração, siga estas etapas:
Forneça um nome para a configuração.
Selecione Enviar para o Log Analytics.
Para Assinatura, selecione a assinatura do Azure associada ao seu workspace do Log Analytics.
Para Workspace do Log Analytics, selecione o workspace que você quer usar.
Em log, selecione a categoria IntegrationAccountTrackingEvents, que especifica a categoria de evento que você quer registrar.
Quando terminar, selecione Salvar.
Por exemplo:
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.
Na caixa de pesquisa do portal do Azure, localize e abra seu workspace do Log Analytics.
No menu do seu workspace, selecione Resumo do workspace>Aplicativos Lógicos B2B.
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:
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.
Uma lista de mensagens é exibida para o bloco escolhido. Por exemplo, veja abaixo a aparência de uma lista 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 |