Настройка журналов Azure Monitor и сбор диагностических данных для сообщений B2B в Azure Logic Apps
Область применения: Azure Logic Apps (потребление)
Примечание.
Сведения из этой статьи применимы только к приложениям логики потребления. Сведения о мониторинге приложений логики ценовой категории "Стандартный" см. в разделе Включение или открытие Application Insights после развертывания.
Когда вы настроите взаимодействие B2B между торговыми партнерами в учетной записи интеграции, эти партнеры смогут обмениваться сообщениями, применяя такие протоколы, как AS2, X12 и EDIFACT. Чтобы убедиться, что подобная связь работает как следует, можно настроить журналы Azure Monitor для учетной записи интеграции. Azure Monitor помогает отслеживать облачные и локальные среды и упрощает поддержку уровня их доступности и производительности. С помощью журналов Azure Monitor можно записывать и хранить сведения о данных и таких событиях среды выполнения, как события триггеров, события запусков и события действий в рабочей области Log Analytics. При ведении журнала сообщений также происходит сбор следующих сведений.
- число и состояние сообщений;
- состояние подтверждений;
- корреляция между сообщениями и подтверждениями;
- подробное описание ошибок при сбоях;
Azure Monitor позволяет создавать запросы журнала, помогающие находить и просматривать эти сведения. Полученные диагностические данные можно также использовать в других службах Azure, таких как служба хранилища Azure и Центры событий Azure.
Чтобы настроить ведение журнала для учетной записи интеграции, установите решение Logic Apps B2B на портале Azure. Это решение предоставляет совокупные сведения для событий сообщений B2B. Затем, чтобы разрешить ведение журнала и создание запросов этих сведений, настройте журналы Azure Monitor.
В этой статье показано, как включить в Azure Monitor ведение журнала для учетной записи интеграции.
Примечание.
Сведения из данной статьи были недавно обновлены. Теперь вместо термина "Log Analytics" используется термин "журналы Azure Monitor". Данные журнала по-прежнему хранятся в рабочей области Log Analytics, собираются и анализируются той же службой Log Analytics. Целью обновления терминологии является лучшее отражение роли журналов в Azure Monitor. Дополнительные сведения см. в статье Изменения фирменной символики Azure Monitor.
Необходимые компоненты
Рабочая область Log Analytics. См. дополнительные сведения о создании рабочей области Log Analytics.
Приложение логики, в настройках которого разрешены ведение журнала Azure Monitor и отправка информации оттуда в рабочую область Log Analytics. Узнайте, как настроить журналы Azure Monitor для приложения логики.
Учетная запись интеграции, связанная с приложением логики. Узнайте, как привязать учетную запись интеграции к приложению логики.
Установка решения Logic Apps B2B
Прежде чем применять журналы Azure Monitor в целях отслеживания сообщений B2B для приложения логики, необходимо добавить решение Logic Apps B2B в рабочую область Log Analytics.
В поле поиска на портале Azure введите
log analytics workspaces
и выберите пункт Рабочие области Log Analytics.В списке Рабочие области Log Analytics выберите нужную рабочую область.
На панели "Обзор" в разделе Начало работы с Log Analytics>Настройка решений для мониторинга выберите пункт Просмотреть решения.
Выберите Добавить на панели "Обзор".
После открытия Marketplace в поле поиска введите
logic apps b2b
и выберите Logic Apps B2B.На панели описания решения выберите Создать.
Проверьте и подтвердите, в какой рабочей области Log Analytics требуется установить решение, и снова нажмите Создать.
После того, как Azure развернет решение в группе ресурсов Azure, содержащей рабочую область Log Analytics, решение появится на панели сводки рабочей области. По мере обработки сообщений B2B обновляется счетчик сообщений на этой панели.
настройка журналов Azure Monitor;
Включать ведение журнала Azure Monitor можно непосредственно в учетной записи интеграции.
На портале Azure найдите и выберите свою учетную запись интеграции.
В разделе Мониторинг меню учетной записи интеграции выберите пункт Параметры диагностики. Выберите Добавить параметр диагностики.
Для создания параметра выполните следующие действия.
Укажите имя параметра.
Установите флажок Отправить в Log Analytics.
В списке Подписка выберите подписку Azure, связанную с рабочей областью Log Analytics.
В разделе Рабочая область Log Analytics выберите рабочую область, необходимую для использования.
В разделе журналвыберите категорию IntegrationAccountTrackingEvents, указав категорию событий, которую необходимо записать.
По завершении выберите Сохранить.
Например:
Просмотр состояния сообщения
После запуска приложения логики можно просмотреть его состояние и данные о сообщениях в рабочей области Log Analytics.
Воспользовавшись полем поиска на портале Azure, найдите и откройте свою рабочую область Log Analytics.
В меню рабочей области выберите Сводка по рабочей области > Logic Apps B2B.
Примечание.
Если в области "Logic Apps B2B" результаты не отображаются сразу после выполнения, попробуйте выбрать команду Обновить или немного подождите, прежде чем повторять попытку.
По умолчанию на плитке Logic Apps B2B отображаются данные за один день. Чтобы изменить интервал области данных, выберите элемент управления областью данных в верхней части страницы.
После появления панели мониторинга состояния сообщений можно просмотреть дополнительные сведения о сообщениях определенного типа, данные о которых отображаются за один день. Выберите плитку AS2, X12 или EDIFACT.
Отобразится список сообщений в соответствии с выбранной плиткой. Ниже представлен пример списка сообщений AS2.
Для получения дополнительных сведений о свойствах для каждого типа сообщений см. указанные ниже описания свойств сообщения:
Описания свойств и форматы имен для сообщений AS2, X12 и EDIFACT
Для каждого типа сообщения ниже приведены описания свойств и форматы имен для загруженных файлов сообщений.
Описания свойств сообщения AS2
Ниже приведены описания свойств для каждого сообщения AS2.
Свойство | Description |
---|---|
Отправитель | Гостевой партнер, указанный в параметрах получения, или главный партнер, указанный в параметрах отправки, для соглашения AS2 |
Получатель | Главный партнер, указанный в параметрах получения, или гостевой партнер, указанный в параметрах отправки, для соглашения AS2 |
Приложение логики | Приложение логики, в котором настроены действия AS2 |
Состояние | Состояние сообщения AS2 Success: получено или отправлено корректное сообщение AS2, MDN не настроено. Success: получено или отправлено корректное сообщение AS2, MDN настроено и получено либо отправлено. Failed: получено некорректное сообщение AS2. MDN не настроено. Pending: получено или отправлено корректное сообщение AS2. MDN настроено и ожидается. |
Подтверждение | Состояние сообщения MDN Accepted: получено или отправлено положительное MDN. Pending: ожидается получение или отправка MDN. Rejected: получено или отправлено отрицательное MDN. Not Required: в соглашении не настроено MDN. |
Направление | Направление сообщения AS2 |
Идентификатор отслеживания | Идентификатор для корреляции всех триггеров и действий в приложении логики |
Идентификатор сообщения | Идентификатор сообщения AS2, полученный из заголовков сообщения AS2 |
Timestamp | Время обработки сообщения действием AS2 |
Описания свойств сообщения X12
Ниже приведены описания свойств для каждого сообщения X12.
Свойство | Description |
---|---|
Отправитель | Гостевой партнер, указанный в параметрах получения, или главный партнер, указанный в параметрах отправки, для соглашения X12 |
Получатель | Главный партнер, указанный в параметрах получения, или гостевой партнер, указанный в параметрах отправки, для соглашения X12 |
Приложение логики | Приложение логики, в котором настроены действия X12 |
Состояние | Состояние сообщения X12 Success: получено или отправлено корректное сообщение X12. Функциональное подтверждение не настроено. Success: получено или отправлено корректное сообщение X12. Функциональное подтверждение настроено и либо получено, либо отправлено. Failed: получено или отправлено некорректное сообщение X12. Pending: получено или отправлено корректное сообщение X12. Функциональное подтверждение настроено и ожидается его получение. |
Подтверждение | Функциональное состояние Ack (997) Accepted: получено или отправлено положительное функциональное подтверждение. Rejected: получено или отправлено отрицательное функциональное подтверждение. Pending: ожидается функциональное подтверждение, но оно еще не получено. Pending: функциональное подтверждение создано, но его не удалось отправить в партнер. Not Required: функциональное подтверждение не настроено. |
Направление | Направление сообщения X12 |
Идентификатор отслеживания | Идентификатор для корреляции всех триггеров и действий в приложении логики |
Тип msg | Тип сообщения EDI X12 |
ICN | Контрольный номер обмена для сообщения X12 |
TSCN | Контрольный номер набора транзакций для сообщения X12 |
Timestamp | Время обработки сообщения действием X12 |
Описания свойств сообщения EDIFACT
Ниже приведены описания свойств для каждого сообщения EDIFACT.
Свойство | Description |
---|---|
Отправитель | Гостевой партнер, указанный в параметрах получения, или главный партнер, указанный в параметрах отправки, для соглашения EDIFACT |
Получатель | Главный партнер, указанный в параметрах получения, или гостевой партнер, указанный в параметрах отправки, для соглашения EDIFACT |
Приложение логики | Приложение логики, в котором настроены действия EDIFACT |
Состояние | Состояние сообщения EDIFACT Success: получено или отправлено корректное сообщение EDIFACT. Функциональное подтверждение не настроено. Success: получено или отправлено корректное сообщение EDIFACT. Функциональное подтверждение настроено и либо получено, либо отправлено. Не удалось = получено или отправлено недопустимое сообщение EDIFACT Pending: получено или отправлено корректное сообщение EDIFACT. Функциональное подтверждение настроено и ожидается его получение. |
Подтверждение | Состояние функционального Ack (CONTRL) Accepted: получено или отправлено положительное функциональное подтверждение. Rejected: получено или отправлено отрицательное функциональное подтверждение. Pending: ожидается функциональное подтверждение, но оно еще не получено. Pending: функциональное подтверждение создано, но его не удалось отправить в партнер. Not Required: функциональное подтверждение не настроено. |
Направление | Направление сообщения EDIFACT |
Идентификатор отслеживания | Идентификатор для корреляции всех триггеров и действий в приложении логики |
Тип msg | Тип сообщения EDIFACT |
ICN | Контрольный номер обмена сообщениями EDIFACT |
TSCN | Контрольный номер набора транзакций для сообщения EDIFACT |
Timestamp | Время обработки сообщения действием EDIFACT |