Configuración de registros de Azure Monitor y recopilación de datos de diagnóstico para mensajes B2B en Azure Logic Apps

Nota:

Este artículo solo se aplica a las aplicaciones lógicas de consumo. Para obtener información sobre la supervisión de aplicaciones lógicas Estándar, consulte Habilitar o abrir Application Insights después de la implementación para aplicaciones lógicas Estándar.

Después de configurar la comunicación B2B entre entidades en la cuenta de integración, los asociados pueden intercambiar mensajes mediante protocolos como AS2, X12 y EDIFACT. Para comprobar que esta comunicación funciona según lo previsto, puede configurar los registros de Azure Monitor para la cuenta de integración. Azure Monitor le ayuda a supervisar los entornos locales y en la nube para que pueda mantener más fácilmente su disponibilidad y rendimiento. Con registros de Azure Monitor puede registrar y almacenar datos sobre eventos y tiempo de ejecución, como los de desencadenamiento, ejecución y acción en un área de trabajo de Log Analytics. Para los mensajes, el registro también recopila la información siguiente:

  • Número y estado de los mensajes
  • Del estado de las confirmaciones
  • Correlaciones entre mensajes y confirmaciones
  • Descripción detallada de errores

Azure Monitor permite crear consultas de registro que le ayudarán a encontrar y revisar esta información. También puede usar estos datos de diagnóstico con otros servicios de Azure, como Azure Storage y Azure Event Hubs.

Para configurar el registro en la cuenta de integración, instale la solución Logic Apps B2B en Azure Portal. Esta solución proporciona información agregada para los eventos de los mensajes B2B. Luego, para habilitar el registro y la creación de consultas para esta información, configure los registros de Azure Monitor.

En este artículo se muestra cómo configurar el registro de Azure Monitor para la cuenta de integración.

Nota:

Este artículo se ha actualizado recientemente para usar el término registros de Azure Monitor en lugar de Log Analytics. Los datos de registro siguen almacenándose en un área de trabajo de Log Analytics y siguen recopilándose y analizándose por el mismo servicio de Log Analytics. Estamos actualizando la terminología para reflejar mejor el rol de los registros de Azure Monitor. Consulte Azure Monitor terminology changes (Cambios en la terminología de Azure Monitor) para obtener más información.

Prerrequisitos

Instalación de una solución Logic Apps B2B

Para que los registros de Azure Monitor puedan realizar el seguimiento de los mensajes B2B de la aplicación lógica, agregue la solución Logic Apps B2B al área de trabajo de Log Analytics.

  1. En el cuadro de búsqueda de Azure Portal, escriba log analytics workspaces y seleccione Áreas de trabajo de Log Analytics.

    Select

  2. En Áreas de trabajo de Log Analytics, seleccione su área de trabajo.

    Select your Log Analytics workspace

  3. En el panel Información general, en Introducción a Log Analytics>Configurar soluciones de supervisión, elija Ver soluciones.

    On Overview pane, select

  4. En el panel de información general, seleccione Agregar.

    On overview pane, add new solution

  5. Una vez abierto Marketplace, en el cuadro de búsqueda, escriba logic apps b2b y seleccione Logic Apps B2B.

    From Marketplace, select

  6. En el panel de descripción de la solución, seleccione Crear.

    Select

  7. Revise y confirme el área de trabajo de Log Analytics donde quiere instalar la solución y vuelva a seleccionar Crear.

    Select

    Una vez que Azure implemente la solución en el grupo de recursos de Azure que contiene el área de trabajo de Log Analytics, la solución aparecerá en el panel de resumen del área de trabajo. Una vez procesados los mensajes B2B, aparece en este panel el número de mensajes actualizado.

    Workspace summary pane

Configuración de los registros de Azure Monitor

El registro de Azure Monitor se puede habilitar directamente desde la cuenta de integración.

  1. En Azure Portal, busque y seleccione la cuenta de integración.

    Find and select your integration account

  2. En el menú de la cuenta de integración, seleccione Configuración de diagnóstico en Supervisión. Seleccione Agregar configuración de diagnóstico.

    Under

  3. Para crear la configuración, siga estos pasos:

    1. Proporcione un nombre para la configuración.

    2. Seleccione Enviar a Log Analytics.

    3. En Suscripción, seleccione la suscripción de Azure que está asociada al área de trabajo de Log Analytics.

    4. En Área de trabajo de Log Analytics, seleccione el área de trabajo que quiere usar.

    5. En registro, seleccione la categoría IntegrationAccountTrackingEvents, que especifica la categoría de eventos que quiere registrar.

    6. Cuando finalice, seleccione Guardar.

    Por ejemplo:

    Set up Azure Monitor logs to collect diagnostic data

Visualización del estado de los mensajes

Una vez ejecutada la aplicación lógica, puede ver los datos y el estado de esos mensajes en el área de trabajo de Log Analytics.

  1. En el cuadro de búsqueda de Azure Portal, busque y abra el área de trabajo de Log Analytics.

  2. En el menú del área de trabajo, seleccione Resumen del área de trabajo>Logic Apps B2B.

    Workspace summary pane

    Nota

    Si el icono de Logic Apps B2B no muestra los resultados inmediatamente después de una ejecución, pruebe a seleccionar Actualizar o espere un poco antes de volver a intentarlo.

    De forma predeterminada, el icono de Logic Apps B2B muestra datos basados en un solo día. Para cambiar el ámbito de datos a otro intervalo, seleccione el control de ámbito de la parte superior de la página:

    Change interval

  3. Después de que aparezca el panel de estado de los mensajes, puede ver más detalles sobre un tipo de mensaje concreto, lo que muestra los datos basados en un solo día. Seleccione el icono de AS2, X12 o EDIFACT.

    View statuses for messages

    Aparece una lista de mensajes para el icono seleccionado. Por ejemplo, este podría ser el aspecto de una lista de mensajes AS2:

    Statuses and details for AS2 messages

    Para más información sobre las propiedades de cada tipo de mensaje, vea estas descripciones de las propiedades de los mensajes:

Descripciones de propiedades y formatos de nombre de los mensajes AS2, X12 y EDIFACT

Estas son las descripciones de propiedades y los formatos de nombre de los archivos de mensajes descargados por tipo de mensaje.

Descripciones de propiedades de los mensajes AS2

Estas son las descripciones de propiedades de cada mensaje AS2.

Propiedad Descripción
Sender Asociado invitado especificado en Configuración de recepción o asociado del host especificado en Configuración de envío para un acuerdo de AS2
Receiver Asociado del host especificado en Configuración de recepción o asociado invitado especificado en Configuración de envío para un acuerdo de AS2
Aplicación lógica Aplicación lógica donde se configuran las acciones AS2
Estado Estado del mensaje AS2
Correcto = recibido o enviado un mensaje AS2 válido. No se configura ninguna MDN.
Correcto = recibido o enviado un mensaje AS2 válido. Se configura y se recibe una MDN, o se envía.
Error = recibido un mensaje AS2 no válido. No se configura ninguna MDN.
Pendiente = recibido o enviado un mensaje AS2 válido. Se configura una MDN y se espera una MDN.
ACK Estado del mensaje MDN
Aceptado = recibida o enviada una MDN positiva.
Pendiente = esperando a recibir o enviar una MDN.
Rechazado = recibida o enviada una MDN negativa.
No necesario = no configurada ninguna MDN en el acuerdo.
Dirección Dirección del mensaje AS2
Tracking ID Identificador que correlaciona todos los desencadenadores y las acciones de una aplicación lógica
Message ID Identificador del mensaje AS2 a partir de los encabezados de mensajes AS2
Timestamp Hora a la que la acción AS2 procesó el mensaje

Descripciones de propiedades de los mensajes X12

Estas son las descripciones de propiedades de cada mensaje X12.

Propiedad Descripción
Sender Asociado invitado especificado en Configuración de recepción o asociado del host especificado en Configuración de envío para un acuerdo de X12
Receiver Asociado del host especificado en Configuración de recepción o asociado invitado especificado en Configuración de envío para un acuerdo de X12
Aplicación lógica Aplicación lógica donde se configuran las acciones X12
Estado Estado del mensaje X12
Correcto = recibido o enviado un mensaje X12 válido. No se configura ninguna confirmación funcional.
Correcto = recibido o enviado un mensaje X12 válido. Se configura y se recibe una confirmación funcional, o se envía una confirmación funcional.
Error = recibido o enviado un mensaje X12 no válido.
Pendiente = recibido o enviado un mensaje X12 válido. Se configura una confirmación funcional y se espera una confirmación funcional.
ACK Estado de confirmación funcional (997)
Aceptado = recibida o enviada una confirmación funcional positiva.
Rechazado = recibida o enviada una confirmación funcional negativa.
Pendiente = se espera una confirmación funcional, pero no se ha recibido.
Pendiente = generada una confirmación funcional, pero no se puede enviar al asociado.
No necesario = confirmación funcional no configurada.
Dirección Dirección del mensaje X12
Tracking ID Identificador que correlaciona todos los desencadenadores y las acciones de una aplicación lógica
Msg Type Tipo de mensaje X12 de EDI
ICN Número de control de intercambio del mensaje X12
TSCN Número de control de conjuntos de transacciones del mensaje X12
Timestamp Hora a la que la acción X12 procesó el mensaje

Descripciones de propiedades de los mensajes EDIFACT

Estas son las descripciones de propiedades de cada mensaje EDIFACT.

Propiedad Descripción
Sender Asociado invitado especificado en Configuración de recepción o asociado del host especificado en Configuración de envío para un acuerdo de EDIFACT
Receiver Asociado del host especificado en Configuración de recepción o asociado invitado especificado en Configuración de envío para un acuerdo de EDIFACT
Aplicación lógica Aplicación lógica donde se configuran las acciones EDIFACT
Estado Estado del mensaje EDIFACT
Correcto = recibido o enviado un mensaje EDIFACT válido. No se configura ninguna confirmación funcional.
Correcto = recibido o enviado un mensaje EDIFACT válido. Se configura y se recibe una confirmación funcional, o se envía una confirmación funcional.
Error = recibido o enviado un mensaje EDIFACT no válido
Pendiente = recibido o enviado un mensaje EDIFACT válido. Se configura una confirmación funcional y se espera una confirmación funcional.
ACK Estado de confirmación funcional (CONTRL)
Aceptado = recibida o enviada una confirmación funcional positiva.
Rechazado = recibida o enviada una confirmación funcional negativa.
Pendiente = se espera una confirmación funcional, pero no se ha recibido.
Pendiente = generada una confirmación funcional, pero no se puede enviar al asociado.
No necesario = confirmación funcional no configurada.
Dirección Dirección del mensaje EDIFACT
Tracking ID Identificador que correlaciona todos los desencadenadores y las acciones de una aplicación lógica
Msg Type Tipo del mensaje EDIFACT
ICN Número de control de intercambio del mensaje EDIFACT
TSCN Número de control de conjuntos de transacciones del mensaje EDIFACT
Timestamp Hora a la que la acción EDIFACT procesó el mensaje

Pasos siguientes