Получение метаданных из элементов очередей

Статья содержит инструкцию по настройке контура, где в качестве импортера выбран тип Metadata. Импортер позволяет получить метаданные, которые записывают роботы в элементы очереди Оркестратора. Метаданные — набор произвольных данных, которые часто хранят дополнительную информацию об элементе, например, для последующей фильтрации.

На основе полученных метаданных вы можете рассчитать статистику очередей с помощью формул Idea Hub. В статистику входят показатели:

• среднее время обработки элементов очереди роботом;
• количество успешно обработанных элементов очереди за определенную дату;
• количество элементов очереди за определенную дату, обработка которых завершилась бизнес-ошибкой;
• количество элементов очереди за определенную дату, обработка которых завершилась исключением (технической ошибкой);

Результат вычислений отобразится в веб-интерфейсе Idea Hub на странице конкретной очереди. Пример:

Предварительные настройки

1. Настройте учетную запись пользователя для доступа к БД Оркестратора ltools. Пользователю потребуется право на чтение таблиц:

   • ExchangeQueues;
   • ExchangeQueueValues;
   • ExchangeQueueValueEvents.

2. Добавьте учетные данные в файл settings.local.php, как показано в примере ниже:

   • номер в строке $databases должен соответствовать ID вашего контура (в примере это 863);
   • параметры port, host, database, username, password указываются в соответствии с вашими настройками, где:
     • port — порт подключения к базе данных;
     • host — IP-адрес сервера с БД Оркестратора;
     • database — имя базы данных;
     • username — имя пользователя для базы данных;
     • password — пароль пользователя для базы данных.

 $databases['psd_metadata'][863] = [
  'driver' => 'pgsql',
  'autoload' => 'core/modules/pgsql/src/Driver/Database/pgsql/',
  'namespace' => 'Drupal\pgsql\Driver\Database\pgsql',
  'prefix' => '',
  'port' => '5432',
  'host' => '127.0.0.1',
  'database' => 'ltools',
  'username' => 'postgres',
  'password' => 'postgres',
];

Настройка контура

1. В веб-интерфейсе Idea Hub перейдите в раздел административного меню Структура > Таксономия.

2. Найдите строку Контур и нажмите Список терминов. Откроется список созданных контуров.

3. В строке нужного контура нажмите стрелку вниз рядом с действием Изменить и в выпадающем списке выберите Edit source data settings.

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

   

5. В параметре Тип исходных данных выберите значение Metadata.

6. В параметре Время начала импорта исходных данных установите время, в которое Idea Hub будет автоматически забирать данные из аналитической подсистемы. Рекомендуется устанавливать ночное время, в которое нагрузка на сервер будет минимальной.

7. Нажмите Сохранить конфигурацию.

Расчет статистики на основе метаданных

На основе полученных данных вы можете рассчитать статистику очередей, используя формулы Idea Hub. Чтобы воспользоваться формулами, перейдите на страницу конкретной очереди и нажмите внизу страницы ссылку Setup metadata expressions.

Откроется страница с полями для ввода формул и примерами заполнения:

Для ввода формул доступны поля:

• Success operations — количество успешно обработанных элементов очереди.
• Business error operations — количество элементов, обработка которых завершилась бизнес-ошибкой.
• Exception operations — количество элементов, обработка которых завершилась исключением (технической ошибкой).
• Average duration of operations — средняя продолжительность обработки элементов в секундах.

Результатом вычислений должно быть целое число.