Настройка журналов Azure Monitor и сбор диагностических данных для сообщений B2B в 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.

    Select

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

    Select your Log Analytics workspace

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

    On Overview pane, select

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

    On overview pane, add new solution

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

    From Marketplace, select

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

    Select

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

    Select

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

    Workspace summary pane

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

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

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

    Find and select your integration account

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

    Under

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

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

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

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

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

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

    6. Когда все будет готово, нажмите кнопку Сохранить.

    Пример:

    Set up Azure Monitor logs to collect diagnostic data

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

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

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

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

    Workspace summary pane

    Примечание

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

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

    Change interval

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

    View statuses for messages

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

    Statuses and details for AS2 messages

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

Описания свойств и форматы имен для сообщений AS2, X12 и EDIFACT

Для каждого типа сообщения ниже приведены описания свойств и форматы имен для загруженных файлов сообщений.

Описания свойств сообщения AS2

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

Свойство Описание
Отправитель Гостевой партнер, указанный в параметрах получения, или главный партнер, указанный в параметрах отправки, для соглашения 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
Tracking ID Идентификатор для корреляции всех триггеров и действий в приложении логики
Код сообщения (ID) Идентификатор сообщения AS2, полученный из заголовков сообщения AS2
Timestamp Время обработки сообщения действием AS2

Описания свойств сообщения X12

Ниже приведены описания свойств для каждого сообщения X12.

Свойство Описание
Отправитель Гостевой партнер, указанный в параметрах получения, или главный партнер, указанный в параметрах отправки, для соглашения X12
Получатель Главный партнер, указанный в параметрах получения, или гостевой партнер, указанный в параметрах отправки, для соглашения X12
Приложение логики Приложение логики, в котором настроены действия X12
Состояние Состояние сообщения X12
Success: получено или отправлено корректное сообщение X12. Функциональное подтверждение не настроено.
Success: получено или отправлено корректное сообщение X12. Функциональное подтверждение настроено и либо получено, либо отправлено.
Failed: получено или отправлено некорректное сообщение X12.
Pending: получено или отправлено корректное сообщение X12. Функциональное подтверждение настроено и ожидается его получение.
Подтверждение Состояние функционального подтверждения (997).
Accepted: получено или отправлено положительное функциональное подтверждение.
Rejected: получено или отправлено отрицательное функциональное подтверждение.
Pending: ожидается функциональное подтверждение, но оно еще не получено.
Pending: функциональное подтверждение создано, но его не удалось отправить в партнер.
Not Required: функциональное подтверждение не настроено.
Направление Направление сообщения X12
Tracking ID Идентификатор для корреляции всех триггеров и действий в приложении логики
Тип сообщения Тип сообщения EDI X12
ICN Контрольный номер обмена для сообщения X12
TSCN Контрольный номер набора транзакций для сообщения X12
Timestamp Время обработки сообщения действием X12

Описания свойств сообщения EDIFACT

Ниже приведены описания свойств для каждого сообщения EDIFACT.

Свойство Описание
Отправитель Гостевой партнер, указанный в параметрах получения, или главный партнер, указанный в параметрах отправки, для соглашения EDIFACT
Получатель Главный партнер, указанный в параметрах получения, или гостевой партнер, указанный в параметрах отправки, для соглашения EDIFACT
Приложение логики Приложение логики, в котором настроены действия EDIFACT
Состояние Состояние сообщения EDIFACT
Success: получено или отправлено корректное сообщение EDIFACT. Функциональное подтверждение не настроено.
Success: получено или отправлено корректное сообщение EDIFACT. Функциональное подтверждение настроено и либо получено, либо отправлено.
Failed: получено или отправлено некорректное сообщение EDIFACT
Pending: получено или отправлено корректное сообщение EDIFACT. Функциональное подтверждение настроено и ожидается его получение.
Подтверждение Состояние функционального подтверждения (CONTRL)
Accepted: получено или отправлено положительное функциональное подтверждение.
Rejected: получено или отправлено отрицательное функциональное подтверждение.
Pending: ожидается функциональное подтверждение, но оно еще не получено.
Pending: функциональное подтверждение создано, но его не удалось отправить в партнер.
Not Required: функциональное подтверждение не настроено.
Направление Направление сообщения EDIFACT
Tracking ID Идентификатор для корреляции всех триггеров и действий в приложении логики
Тип сообщения Тип сообщения EDIFACT
ICN Контрольный номер обмена сообщениями EDIFACT
TSCN Контрольный номер набора транзакций для сообщения EDIFACT
Timestamp Время обработки сообщения действием EDIFACT

Дальнейшие действия