Настройка журналов 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.

Необходимые компоненты

Установка решения Logic Apps B2B

Прежде чем применять журналы Azure Monitor в целях отслеживания сообщений B2B для приложения логики, необходимо добавить решение Logic Apps B2B в рабочую область Log Analytics.

  1. В поле поиска на портале Azure введите log analytics workspaces и выберите пункт Рабочие области Log Analytics.

    Выбор пункта

  2. В списке Рабочие области Log Analytics выберите нужную рабочую область.

    Выбор рабочей области Log Analytics

  3. На панели "Обзор" в разделе Начало работы с Log Analytics>Настройка решений для мониторинга выберите пункт Просмотреть решения.

    Выбор пункта

  4. Выберите Добавить на панели "Обзор".

    Добавление нового решения на панели

  5. После открытия Marketplace в поле поиска введите logic apps b2b и выберите Logic Apps B2B.

    Выбор

  6. На панели описания решения выберите Создать.

    Выбор действия

  7. Проверьте и подтвердите, в какой рабочей области Log Analytics требуется установить решение, и снова нажмите Создать.

    Выбор действия

    После того, как Azure развернет решение в группе ресурсов Azure, содержащей рабочую область Log Analytics, решение появится на панели сводки рабочей области. По мере обработки сообщений B2B обновляется счетчик сообщений на этой панели.

    Панель

настройка журналов Azure Monitor;

Включать ведение журнала Azure Monitor можно непосредственно в учетной записи интеграции.

  1. На портале Azure найдите и выберите свою учетную запись интеграции.

    Поиск и выбор учетной записи интеграции

  2. В разделе Мониторинг меню учетной записи интеграции выберите пункт Параметры диагностики. Выберите Добавить параметр диагностики.

    Выбор элемента

  3. Для создания параметра выполните следующие действия.

    1. Укажите имя параметра.

    2. Установите флажок Отправить в Log Analytics.

    3. В списке Подписка выберите подписку Azure, связанную с рабочей областью Log Analytics.

    4. В разделе Рабочая область Log Analytics выберите рабочую область, необходимую для использования.

    5. В разделе журналвыберите категорию IntegrationAccountTrackingEvents, указав категорию событий, которую необходимо записать.

    6. По завершении выберите Сохранить.

    Например:

    Настройка журналов Azure Monitor для сбора диагностических данных

Просмотр состояния сообщения

После запуска приложения логики можно просмотреть его состояние и данные о сообщениях в рабочей области Log Analytics.

  1. Воспользовавшись полем поиска на портале Azure, найдите и откройте свою рабочую область Log Analytics.

  2. В меню рабочей области выберите Сводка по рабочей области > Logic Apps B2B.

    Панель

    Примечание.

    Если в области "Logic Apps B2B" результаты не отображаются сразу после выполнения, попробуйте выбрать команду Обновить или немного подождите, прежде чем повторять попытку.

    По умолчанию на плитке Logic Apps B2B отображаются данные за один день. Чтобы изменить интервал области данных, выберите элемент управления областью данных в верхней части страницы.

    Изменение интервала

  3. После появления панели мониторинга состояния сообщений можно просмотреть дополнительные сведения о сообщениях определенного типа, данные о которых отображаются за один день. Выберите плитку AS2, X12 или EDIFACT.

    Просмотр состояний сообщений

    Отобразится список сообщений в соответствии с выбранной плиткой. Ниже представлен пример списка сообщений AS2.

    Состояния сообщений 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

Следующие шаги