Configuración de registros de Azure Monitor y recopilación de datos de diagnóstico para mensajes B2B en Azure Logic Apps
Se aplica a: Azure Logic Apps (consumo)
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
Un área de trabajo de Log Analytics. Si no tiene un área de trabajo de Log Analytics, aprenda a crear un área de trabajo de Log Analytics.
Una aplicación lógica que se configura con el registro de Azure Monitor y que envía esa información a un área de trabajo de Log Analytics. Aprenda a configurar registros de Azure Monitor para la aplicación lógica.
Una cuenta de integración vinculada a la aplicación lógica. Aprenda a vincular la cuenta de integración a la aplicación lógica.
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.
En el cuadro de búsqueda de Azure Portal, escriba
log analytics workspacesy seleccione Áreas de trabajo de Log Analytics.
En Áreas de trabajo de Log Analytics, seleccione su área de trabajo.
En el panel Información general, en Introducción a Log Analytics>Configurar soluciones de supervisión, elija Ver soluciones.
En el panel de información general, seleccione Agregar.
Una vez abierto Marketplace, en el cuadro de búsqueda, escriba
logic apps b2by seleccione Logic Apps B2B.
En el panel de descripción de la solución, seleccione Crear.
Revise y confirme el área de trabajo de Log Analytics donde quiere instalar la solución y vuelva a seleccionar Crear.
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.
Configuración de los registros de Azure Monitor
El registro de Azure Monitor se puede habilitar directamente desde la cuenta de integración.
En Azure Portal, busque y seleccione la cuenta de integración.
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.
Para crear la configuración, siga estos pasos:
Proporcione un nombre para la configuración.
Seleccione Enviar a Log Analytics.
En Suscripción, seleccione la suscripción de Azure que está asociada al área de trabajo de Log Analytics.
En Área de trabajo de Log Analytics, seleccione el área de trabajo que quiere usar.
En registro, seleccione la categoría IntegrationAccountTrackingEvents, que especifica la categoría de eventos que quiere registrar.
Cuando finalice, seleccione Guardar.
Por ejemplo:
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.
En el cuadro de búsqueda de Azure Portal, busque y abra el área de trabajo de Log Analytics.
En el menú del área de trabajo, seleccione Resumen del área de trabajo>Logic Apps B2B.
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:
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.
Aparece una lista de mensajes para el icono seleccionado. Por ejemplo, este podría ser el aspecto de una lista de mensajes AS2:
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 |