Мониторинг и сбор диагностических данных для рабочих процессов в Azure Logic Apps

Область применения: Azure Logic Apps (Потребление + Стандартный)

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

Примечание.

Журналы ресурсов Azure Monitor не являются 100% без потери. Журналы ресурсов основаны на архитектуре хранилища и пересылки, предназначенной для перемещения петабайт данных в день в масштабе. Эта возможность включает встроенную избыточность и повторные попытки на платформе, но не предоставляет гарантии транзакций. Мониторинг транзакций может снизить надежность и производительность отслеживаемой службы. Кроме того, временные ошибки ведения журнала должны остановить вышестоящую службу, если не удается подтвердить доставку журналов. Всякий раз, когда команда Azure Monitor может подтвердить постоянный источник потери данных, команда считает решение и предотвращение его наивысшим приоритетом. Однако небольшие потери данных по-прежнему могут произойти из-за временных, не повторяющихся проблем службы, распределенных по Всей Azure, и не все могут быть пойманы.

В этом руководстве показано, как выполнить следующие задачи на основе ресурса приложения логики "Потребление" или "Стандартный".

Потребление

1. При создании приложения логики потребления включите Log Analytics и укажите рабочую область Log Analytics.

   –или–

   Для существующего приложения логики потребления установите решение Logic Apps Management в рабочей области Log Analytics. Это решение предоставляет статистические данные по выполнению приложения логики с подробными сведениями, такими как состояние, время выполнения, состояние повторной отправки и идентификаторы корреляции.

2. Добавьте параметр диагностики для включения сбора данных.

3. Просмотр состояния выполнения рабочего процесса.

4. Отправка диагностических данных в служба хранилища Azure и Центры событий Azure.

5. Включите настраиваемые свойства в данные телеметрии.

Стандартные

1. Добавьте параметр диагностики для включения сбора данных.

2. Просмотр состояния выполнения рабочего процесса.

3. Отправка диагностических данных в служба хранилища Azure и Центры событий Azure.

4. Включите настраиваемые свойства в данные телеметрии.

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

• Учетная запись и подписка Azure. Если у вас нет ее, вы можете зарегистрироваться для получения бесплатной учетной записи Azure.

  Для ресурса приложения логики потребления требуется разрешение владельца или участника подписки Azure, чтобы установить решение Logic Apps Management из Azure Marketplace. Дополнительные сведения см. в следующей документации:

  • Разрешение на покупку в Azure Marketplace

  • Роли Azure, роли Microsoft Entra и роли администратора классической подписки

• Целевой ресурс для отправки диагностических данных:

  • Рабочая область Log Analytics .

  • учетная запись хранения Azure

  • Концентратор событий Azure

• Ресурс приложения логики и рабочий процесс

Включение Log Analytics

Потребление

Для приложения логики потребления необходимо сначала включить Log Analytics.

Включение Log Analytics при создании приложения логики

1. В портал Azure на панели "Создание приложения логики" выполните следующие действия:

   1. В разделе "План" установите флажок "Потребление", чтобы отображались только параметры рабочих процессов потребления.

   2. Для включения log analytics нажмите кнопку "Да".

   3. В списке рабочих областей Log Analytics выберите рабочую область, в которой нужно отправить данные из запуска рабочего процесса.

      

2. Завершите создание ресурса приложения логики.

   Когда все будет готово, приложение логики будет связано с используемой рабочей областью Log Analytics. На этом шаге в рабочую область автоматически устанавливается решение по управлению Logic Apps.

3. После запуска рабочего процесса просмотрите состояние выполнения рабочего процесса.

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

Если вы включили Log Analytics при создании ресурса приложения логики, пропустите этот раздел. Решение по управлению Logic Apps уже установлено в рабочей области Log Analytics. В противном случае выполните следующие действия для существующего приложения логики потребления:

1. В поле поиска портал Azure введите рабочие области Log Analytics и выберите рабочие области Log Analytics из результатов.

   

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

   

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

   

4. В разделе "Обзор" выберите "Добавить", который добавляет новое решение в рабочую область.

5. После открытия страницы Marketplace в поле поиска введите управление приложениями логики и выберите "Управление Logic Apps".

   

6. На плитке Управление Logic Apps выберите в списке Создать элемент Управление Logic Apps.

   

7. На панели Create Logic Apps Management (Preview) Solution (Создание решения для управления Logic Apps (предварительная версия)) выберите рабочую область Log Analytics, в которой нужно установить решение. Выберите Проверка и создание, проверьте введенные сведения и щелкните Создать.

   

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

   

Стандартные

Для приложения логики уровня "Стандартный" можно продолжить добавление параметра диагностики. Никакие другие необходимые действия не необходимы для включения Log Analytics, а также не применяется к приложениям логики Уровня "Стандартный".

Добавление параметра диагностики

Потребление

1. В портал Azure откройте ресурс приложения логики потребления.

2. В меню ресурсов приложения логики в разделе "Мониторинг" выберите параметры диагностики. На странице параметров диагностики выберите "Добавить параметр диагностики".

   

3. Для имени параметра диагностики укажите имя, которое требуется для параметра.

4. В разделе "Категории журналов" выберите события диагностики>среды выполнения рабочего процесса. В поле Метрики выберите AllMetrics.

5. В разделе "Сведения о назначении" выберите одно или несколько назначений в зависимости от места отправки журналов.

   Назначение	Маршруты
   Отправка в рабочую область Log Analytics	Выберите подписку Azure для рабочей области Log Analytics и рабочей области.
   Архивировать в учетной записи хранения.	Выберите подписку Azure для учетной записи хранения Azure и учетной записи хранения. Дополнительные сведения см. в статье "Отправка диагностических данных в служба хранилища Azure и Центры событий Azure".
   Передать в концентратор событий.	Выберите подписку Azure для пространства имен концентратора событий, концентратора событий и имени политики концентратора событий. Дополнительные сведения см. в статье "Отправка диагностических данных в служба хранилища Azure и Центры событий Azure и интеграции партнеров Azure Monitor".
   Отправка в партнерское решение	Выберите подписку Azure и место назначения. Дополнительные сведения см. в разделе "Службы машинного поставщика программного обеспечения Azure".

   В следующем примере в качестве назначения выбирается рабочая область Log Analytics:

   

6. Чтобы завершить добавление параметра диагностики, нажмите кнопку "Сохранить".

Стандартные

1. На портале Azure откройте свой ресурс приложения логики категории "Стандартный".

2. В меню ресурсов приложения логики в разделе "Мониторинг" выберите параметры диагностики. На странице параметров диагностики выберите "Добавить параметр диагностики".

   

3. Для имени параметра диагностики укажите имя, которое требуется для параметра.

4. В разделе "Категории журналов" выберите журналы> среды выполнения рабочего процесса. В поле Метрики выберите AllMetrics.

5. В разделе "Сведения о назначении" выберите одно или несколько назначений в зависимости от места отправки журналов.

   Назначение	Маршруты
   Отправка в рабочую область Log Analytics	Выберите подписку Azure для рабочей области Log Analytics и рабочей области.
   Архивировать в учетной записи хранения.	Выберите подписку Azure для учетной записи хранения Azure и учетной записи хранения. Дополнительные сведения см. в статье "Отправка диагностических данных в служба хранилища Azure и Центры событий Azure".
   Передать в концентратор событий.	Выберите подписку Azure для пространства имен концентратора событий, концентратора событий и имени политики концентратора событий. Дополнительные сведения см. в статье "Отправка диагностических данных в служба хранилища Azure и Центры событий Azure и интеграции партнеров Azure Monitor".
   Отправка в партнерское решение	Выберите подписку Azure и место назначения. Дополнительные сведения см. в разделе "Службы машинного поставщика программного обеспечения Azure".

   В следующем примере в качестве назначения выбирается рабочая область Log Analytics:

   

6. При необходимости для включения телеметрии для таких событий, как Host.Startup, Host.Bindings и Host.LanguageWorkerConfig, выберите журналы приложений-функций. Дополнительные сведения см. в статье "Мониторинг Функции Azure с помощью журналов Azure Monitor".

7. Чтобы завершить добавление параметра диагностики, нажмите кнопку "Сохранить".

Azure Logic Apps теперь отправляет данные телеметрии о рабочем процессе в рабочую область Log Analytics.

Примечание.

После включения параметров диагностика данные диагностика могут не выполняться до 30 минут до журналов в указанном месте назначения, таких как Log Analytics, учетная запись хранения или концентратор событий. Эта задержка означает отсутствие данных диагностики для просмотра за указанный период времени. Завершенные события и отслеживаемые свойства могут не отображаться в рабочей области log Analytics в течение 10-15 минут.

Просмотр состояния выполнения рабочего процесса

Потребление

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

1. В портал Azure откройте рабочую область Log Analytics.

2. В меню рабочей области в разделе "Классическая" выберите "Сводка рабочей области". На странице "Обзор" выберите "Управление Logic Apps".

   Примечание.

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

   

   На странице сводки отображаются рабочие процессы, сгруппированные по имени или по состоянию выполнения. На странице также отображаются сведения о сбоях в действиях или триггерах для выполнения рабочего процесса.

   

3. Чтобы просмотреть все запуски для определенного рабочего процесса или состояния, выберите строку для этого рабочего процесса или состояния.

   В этом примере показаны все запуски для определенного рабочего процесса:

   

   Для действий, в которых вы добавили отслеживаемые свойства, можно найти отслеживаемые свойства с помощью фильтра столбцов. Чтобы просмотреть свойства, в столбце "Отслеживаемые свойства " выберите "Вид".

   

4. Чтобы отфильтровать свои результаты, выполните фильтрацию на стороне клиента и на стороне сервера.

   • Клиентский фильтр. Для каждого столбца выберите необходимые фильтры, например:

     

   • Серверный фильтр. Чтобы выбрать определенное временное окно или ограничить отображаемое количество выполнений, воспользуйтесь элементом управления области в верхней части страницы. По умолчанию за раз отображается только 1000 записей.

     

5. Чтобы просмотреть все действия и их сведения для определенного запуска, выберите строку для запуска рабочего процесса приложения логики.

   В следующем примере показаны все действия и триггеры для определенного рабочего процесса приложения логики:

   

Стандартные

1. В портал Azure откройте рабочую область Log Analytics.

2. В меню навигации рабочей области выберите журналы.

3. На новой вкладке запроса в левом столбце в разделе "Таблицы" разверните узел LogManagement и выберите LogicAppWorkflowRuntime.

   В области справа в разделе "Результаты" в таблице отображаются записи, связанные со следующими событиями:

   • WorkflowRunStarted
   • WorkflowRunCompleted
   • WorkflowTriggerStarted
   • WorkflowTriggerEnded
   • WorkflowActionStarted
   • WorkflowActionCompleted
   • WorkflowBatchMessageSend
   • WorkflowBatchMessageRelease

   Для завершенных событий столбец EndTime публикует метку времени для завершения. Это значение помогает определить длительность между событием начала и завершенным событием.

   

Примеры запросов

В области запросов рабочей области Log Analytics можно ввести собственные запросы, чтобы найти определенные данные, например:

• Выберите все события для определенного идентификатора выполнения рабочего процесса:

  LogicAppWorkflowRuntime
  | where RunId == "08585258189921908774209033046CU00"
  

• Список всех исключений:

  LogicAppWorkflowRuntime
  | where Error != ""
  | sort by StartTime desc
  

• Определите действия, которые испытали повторные попытки:

  LogicAppWorkflowRuntime
  | where RetryHistory != ""
  | sort by StartTime desc 
  

Отправка диагностических данных в службу хранилища Azure и Центры событий Azure

Вместе с журналами Azure Monitor можно отправлять собранные данные в другие места назначения, например:

• Архивация журналов ресурсов Azure в учетной записи хранения
• Потоковая передача журналов платформы Azure в Центры событий Azure

Затем вы можете получить мониторинг в режиме реального времени с помощью телеметрии и аналитики из других служб, таких как Azure Stream Analytics и Power BI, например:

• Потоковая передача данных из Центров событий в Stream Analytics
• Анализ потоковой передачи данных с помощью Stream Analytics и создание панели мониторинга в Power BI для анализа данных в режиме реального времени

Примечание.

Сроки хранения применяются только в случае, если используется учетная запись хранения.

Включение настраиваемых свойств в телеметрию

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

Пользовательский идентификатор отслеживания

Большинство триггеров имеют свойство Custom Tracking Id, где можно указать идентификатор отслеживания с помощью выражения. Это выражение можно использовать для получения данных из полезных данных полученного сообщения или создания уникальных значений, например:

Если этот пользовательский идентификатор отслеживания не указан, Azure автоматически создает этот идентификатор и сопоставляет события в ходе выполнения рабочего процесса, включая все вложенные рабочие процессы, вызываемые из родительского рабочего процесса. Можно вручную задать этот идентификатор в триггере, передав заголовок x-ms-client-tracking-id с пользовательским идентификатором в запросе триггера. Триггер запроса, триггер HTTP или триггер на основе веб-перехватчика можно использовать.

Потребление

Стандартные

Отслеживаемые свойства

Действия содержат раздел "Отслеживаемые свойства" , где можно указать имя и значение пользовательского свойства, введя выражение или жестко закодированное значение для отслеживания определенных входных или выходных данных, например:

Потребление

Стандартные

Отслеживаемые свойства могут отслеживать только входные и выходные данные одного действия, но можно использовать correlation свойства событий для сопоставления между действиями в выполнении рабочего процесса.

Отслеживаемые свойства могут ссылаться только на параметры, входные данные и выходные данные для собственного триггера или действия.

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

В следующих примерах показано, где настраиваемые свойства отображаются в рабочей области Log Analytics:

Потребление

1. В меню рабочей области Log Analytics в разделе "Классическая" выберите "Сводка рабочей области". На странице "Обзор" выберите "Управление Logic Apps".

2. Выберите строку для рабочего процесса, который требуется проверить.

3. На странице "Запуски" в таблице "Запуски приложения логики" найдите столбец "Идентификатор отслеживания" и столбец "Отслеживаемые свойства".

   

4. Для поиска отслеживаемых свойств можно использовать фильтр столбцов. Чтобы просмотреть свойства, выберите "Вид".

   

Стандартные

Настраиваемый идентификатор отслеживания отображается в столбце ClientTrackingId и отслеживаемых свойствах отображаются в столбце TrackedProperties , например:

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

• Создание запросов мониторинга и отслеживания
• Мониторинг сообщений B2B с помощью журналов Azure Monitor