Project

General

Profile

Справочная система по модулям Digispot II » Модули Digispot II »

WMI провайдер

Назначение

Модуль WMI провайдер предназначен для мониторинга работы приложений Digispot II, в состав которых входит Х-плеер, а также РБД (DDB). Модуль записывает информацию о состоянии плееров, о воспроизводимых плеерами фонограммах, расписаниях и медиапланах, а также о передаче расписаний и элементов РБД в WMI (Windows Management Instrumentation). Затем информацию можно собирать и обрабатывать с помощью любой современной программы для мониторинга компьютерных систем и сетей таких, как SCOM (System Center Operations Manager), ZABBIX и других.

Настройка

Для настройки модуля необходимо в корневом каталоге Digispot II (по умолчанию: C:\Program Files(x86)\Digispot II\DJin) создать папку с именем Extenders и поместить в нее два файла — LogRecordExtender.dll и StateTree.dll.

Затем необходимо настроить права пользователя на полный доступ к пространству имен Applications. Для этого откройте панель управления компьютером и выберите: Все элементы панели управление\Администрирование\Управление компьютером\Службы и приложения.

Выделите Управляющий элемент WMI и правой клавишей мыши откройте контекстное меню. Выберите пункт Свойства. Откроется окно Свойства: Управляющий элемент WMI, перейдите на вкладку Безопасность и выберите: Root\CIMV2\Applications. Нажмите кнопку Безопасность.

В открывшемся окне Безопасность укажите пользователя и установите флажки в столбце Разрешить. Нажмите кнопку OK.

Добавить учетную запись, под которой работает приложение DJIN и\или осуществляется удаленный WMI запрос. Предоставить полные права. Область действия установить на "Данное пространство и подпространство имен".

wmi_user.png

 

Запустить оснастку "Службы компонентов" (dcomcnfg) от имени учетной записи с правами администратора.

Перейти к: [Службы компонентов - Компьютеры - Мой компьютер - Свойства - Безопасность COM - Разрешения на запуск и активацию - Изменить ограничения].

Добавить учетную запись, под которой осуществляется удаленный WMI запрос. Предоставить полные права.

wmi_user2.png

Интерфейс

Интерфейс модуля WMI провайдер представлен окном Настройки Wmi провайдера, которое запускается выбором пункта главного меню программы: Компоненты\WMI провайдер….

Здесь создаются два узла (пространства имен) WMI — корневой динамический узел и корневой статический узел. В Корневой динамический узел будет записываться информация о действиях программы в текущий момент времени. Данный узел создается в любом случае. Корневой статический узел используется при необходимости сохранения истории о выполненных задачах за определенный период времени (указывается в настройках).

Корневой динамический узел:

  • Название — любое пользовательское наименование корневого динамического узла. Обязательно для заполнения.

Использовать корневой статический узел — установленный флажок позволит сохранить историю произведенных программой действий:

  • Название — любое пользовательское наименование корневого статического узла. Обязательно для заполнения.
  • Время хранения (дней) — здесь указывается, сколько дней будет храниться информация. По прошествии этого времени информация будет перезаписываться, постепенно удаляя более ранние записи.

Включить WMI провайдер — установленный флажок включает модуль записи в WMI.

> Внимание. Для сохранения изменений в настройках WMI провайдера необходимо перезапустить систему Digispot II.

Список классов и параметров

Классы и параметры корневого динамического узла

Класс playback_players:

  • Index (string) — уникальный идентификатор плеера.
  • is_playing (bool) — плеер находится в режиме воспроизведения.

Класс playback_player_elems:

  • artist (string) — наименование исполнителя.
  • db_id (int) — идентификатор в БД.
  • filler (bool) — элемент системы заполнения пауз.
  • Index (string) — уникальный идентификатор записи.
  • is_playing (bool) — плеер находится в режиме воспроизведения.
  • name (string) — название элемента.
  • player (string) — уникальный идентификатор плеера.

Класс ddb_common:

  • file_queue_size (int) — длина очереди файлов на прокачку.
  • index (string) — уникальный идентификатор записи.

Класс ddb_connects:

  • connected (int) — соединение установлено (значение 1), соединение отсутствует (0).
  • index (string) — уникальный идентификатор записи.
  • login (string) — логин.
  • name (string) — название соединения.
  • sch_receive_age_hours (int) — количество часов с момента получения расписания.
  • sch_receive_time (DateTime) — время получения расписания.
  • status (string) — состояние соединения (stopped, started, logging, connected).
  • type (string) — тип соединения (Client, InConnect, Server:single, Server:multiple).

Класс ddb_in_schedules:

  • connect (string) — идентификатор соединения из класса connects.
  • dst_schedule_name (string) — название расписания, куда принимаем.
  • index (string) — уникальный идентификатор записи.
  • receive_time (DateTime) — время последнего успешного получения.
  • received_schedule_name (string) — название получаемого с сервера расписания.
  • src_sch_name (string) — название расписания, которое запрашиваем.

Классы и параметры корневого статического узла

Класс playback_log:

  • artist (string) — наименование исполнителя.
  • creation_time_ticks (int) — время создания записи, в тиках.
  • db_id (int) — идентификатор в БД.
  • Index (string) — уникальный идентификатор записи.
  • media_plan_db_item_id (int) — элемент, который был запланирован.
  • media_plan_db_uid (string) — идентификатор БД, в которой производилось планирование.
  • media_plan_id (int) — идентификатор медиаплана.
  • media_plan_item_id (int) — идентификатор позиции в медиаплане, в которой элемент был запланирован.
  • media_plan_schedule_id (int) — идентификатор расписания, для которого элемент был запланирован.
  • name (string) — название элемента.
  • playback_time (datetime) — время воспроизведения элемента.
  • player_id — название плеера.
  • schedule_name (string) — название расписания, которое воспроизводилось.

Диагностика работоспособности

Для проверки правильности подключения и настроек WMI провайдера можно использовать команды PowerShell, указанные ниже.

Для Корневого динамического узла с именем "dynamic":

get-wmiobject -class "playback_player_elems" -namespace "root\cimv2\Applications\Digispot\SvyaznoyClient\dynamic"
get-wmiobject -class "playback_player_elems" -namespace "root\cimv2\Applications\Digispot\SvyaznoyClient\dynamic" | Format-Table -Property db_id,name,artist,filler,Index,is_playing,player

Для Корневого статического узла с именем "static":

get-wmiobject -class "playback_log" -namespace "root\cimv2\Applications\Digispot\SvyaznoyClient\static"

См. также Экстендер LogRecord

 

Add picture from clipboard (Maximum size: 742 MB)