Синтетика для Workflows

Материал из Документация Ключ-АСТРОМ
Версия от 19:14, 3 сентября 2026; IKuznetsov (обсуждение | вклад) (Новая страница: « = Синтетика для Workflows = '''Синтетика для Workflows''' позволяет выполнять синтетические мониторы по требованию на выбранных локациях в рамках ваших рабочих процессов. '''Ключ-АСТРОМ''' может реагировать на любое событие и выполнять синтетические мониторы в раб...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Синтетика для Workflows

Синтетика для Workflows позволяет выполнять синтетические мониторы по требованию на выбранных локациях в рамках ваших рабочих процессов. Ключ-АСТРОМ может реагировать на любое событие и выполнять синтетические мониторы в рабочих процессах для оценки их влияния на пользовательский опыт. В зависимости от результата рабочие процессы могут уведомить команду, создав тикет в Jira, отправив сообщение в Slack или запустив процесс восстановления.

С помощью Синтетики для Workflows вы можете выбрать, какие мониторы выполнять:

  • список всех доступных мониторов;
  • мониторы, помеченные определёнными тегами;
  • мониторы, назначенные конкретным фронтенд-приложениям.

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

Шаг 1. Установка Synthetic for Workflows

Чтобы использовать действия Synthetic for Workflows, сначала необходимо установить Synthetic for Workflows из Ключ-АСТРОМ Hub.

  • В Ключ-АСТРОМ Hub найдите Synthetic for Workflows.
  • Выберите Synthetic for Workflows и нажмите Установить.
  • После установки действия synthetic_for_workflows автоматически появляются в разделе Выбор действия рабочих процессов.

Перед началом убедитесь, что ваши мониторы правильно определены. Чтобы создать новый монитор, найдите Синтетический в Ключ-АСТРОМ Hub.

Шаг 2. Назначение разрешений для рабочих процессов

Необходимые разрешения перечислены в рабочих процессах. Кроме того, для выполнения Synthetic for Workflows требуются следующие разрешения:

  • environment:roles:manage-settings
  • storage:buckets:read
  • storage:events:read

Пример политики:

ALLOW
app-engine:apps:run,
automation:workflows:read,
app-engine:functions:run,
automation:workflows:run,
automation:workflows:write,
environment:roles:manage-settings,
storage:buckets:read,
storage:events:read;

Использование действия synthetic_for_workflows

Выбор синтетических мониторов

Чтобы выбрать мониторы из списка для Synthetic for Workflows, необходимо указать синтетические мониторы, которые должны выполняться при запуске рабочего процесса. Вы можете выбрать монитор из Визуального или Из события. Найти наиболее релевантные мониторы можно, отфильтровав список по различным критериям, таким как тип, имя, приложения и теги.

Вы также можете:

  • Выбрать С определёнными тегами, чтобы просмотреть мониторы с определённым тегом.
  • Выбрать Назначенные фронтенд-приложениям, чтобы выбрать мониторы, назначенные конкретным приложениям. Доступные приложения можно найти в списке Выбор фронтенд-приложений.

Выбор синтетической локации

В разделе Выбор синтетической локации:

  • Выберите Визуально или Из события.
  • Для Визуально выберите синтетическую локацию из раскрывающегося списка.
  • Для Из события вы можете определить список синтетических мониторов, которые необходимо выполнить в рабочем процессе, на основе входящего события. Для этого нужно создать выражение, которое позволит рабочему процессу извлечь эту информацию из события и выполнить выбранные мониторы.

Если вы не выберете ни одной локации, монитор будет выполнен в локации, указанной в его конфигурации.

Добавление метаданных

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

Чтобы добавить метаданные:

  • Нажмите Добавить метаданные.
  • Заполните поля Ключ и Значение. В этих полях можно использовать выражения рабочих процессов.
  • Метаданные сохраняются автоматически.

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

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

Для этого включите или отключите любые из следующих параметров:

  • Останавливать при проблеме
  • Завершать с ошибкой при проблеме производительности
  • Завершать с ошибкой при предупреждении SSL
  • Делать скриншоты при успехе

Настройка выполнения рабочего процесса

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

Вы можете включить или отключить его:

  • Включено: если выполнение монитора завершается ошибкой, задача завершается ошибкой. Это можно комбинировать с другими параметрами конфигурации, такими как переключатель Повтор при ошибке, чтобы управлять поведением рабочего процесса в соответствии с задачей, завершившейся ошибкой.
  • Отключено: если выполнение монитора завершается ошибкой, задача завершается успешно. Действие Synthetic for Workflows генерирует результаты, которые могут быть использованы следующей задачей, например, Site Reliability Guardian.

По умолчанию этот переключатель выключен.

Результаты синтетических мониторов в Grail

Обратите внимание, что синтетический мониторинг не генерирует события Grail для арендаторов, не использующих DPS. Вся обработка будет основываться исключительно на данных API. Чтобы узнать больше о лицензировании DPS, см. раздел «Лицензия Ключ-АСТРОМ».

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

Существует три типа событий:

  • batch_status — содержит сводный результат всех выполнений мониторов в пакете;
  • browser_monitor_execution — содержит подробную информацию об одном выполнении браузерного монитора;
  • http_monitor_execution — содержит подробную информацию об одном выполнении HTTP-монитора.

Интеграция Synthetic for Workflows с Site Reliability Guardian

Если вы хотите оценивать цели на основе результатов синтетических мониторов, вы можете интегрировать Site Reliability Guardian (SRG) как следующее действие в вашем рабочем процессе.

Для этого:

  • Нажмите на задаче synthetic_for_workflows и выберите Site Reliability Guardian в разделе Выбор действия. Это запустит задачу site_reliability_guardian_1.
  • Выберите задачу site_reliability_guardian_1. В разделе Переменные укажите параметр batchId из результата синтетического монитора и значение {{ result("synthetic_for_workflows_1")["event.id"] }}. Вы можете заменить synthetic_for_workflows_1 на любое другое имя задачи.
  • В Ключ-АСТРОМ Hub найдите Site Reliability Guardian.
  • Нажмите кнопку + Guardian.
  • В вашем Guardian выберите Переменные.
  • Нажмите Добавить переменную.
  • В поле Имя введите batchId. В поле Значение укажите значение по умолчанию. Нажмите кнопку Добавить, чтобы сохранить изменения.
  • Справа заполните Имя Guardian.
  • Нажмите Добавить новую цель и укажите один из следующих запросов DQL.

Обратите внимание, что запросы для синтетических событий из приложений, отличных от Синтетический, например из Notebooks, Дашбордов и SRG, не тарифицируются.

Используйте следующий запрос, чтобы получить общую продолжительность всего пакета:

fetch dt.synthetic.events
| filter event.id == $batchId
| fields batch_result.duration

Используйте следующий запрос, чтобы проверить, успешно ли завершился пакет:

fetch dt.synthetic.events | filter event.id == $batchId | filter batch.status == "Success" | summarize count = count()