Мониторинг и сбор диагностических данных для рабочих процессов в 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, Azure AD роли и классические роли администратора подписки

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

  • Рабочая область 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 не требуется никаких других предварительных действий, а также не применяется решение Logic Apps Management к приложениям логики уровня "Стандартный".

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

Потребление

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

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

   

3. В поле Имя параметра диагностики укажите нужное имя параметра.

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

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

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

   В следующем примере в качестве назначения выбирается рабочая область 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.

Настраиваемый идентификатор отслеживания

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

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

Потребление

Стандартный

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

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

Потребление

Стандартный

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

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

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

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

Потребление

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

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

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

   

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

   

Стандартный

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

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

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