1. Состав архива:
"YellowWatcher" - исполняемый файл сервиса.
"logcfg.xml" - файл настроек технологического журнала 1С.
"src" - каталог с исходными файлами сервиса, с исходными кодами так же можно ознакомиться по ссылке https://github.com/sdf1979/YellowWatcher
2. Установка:
2.1 Распаковать архив "YellowWatcher.zip"
2.2 Настроить сбор технологического журнала для мониторинга управляемых блокировок и серверных вызовов (пример настроек - файл logcfg.xml). Т.к. для мониторинга требуются только оперативные события, то длительность сбора ТЖ ограничена одним часом. Каталог для мониторинга должен быть отдельным и содержать только те настройки, что находятся в предлагаемом файле архива
2.3 Для получения справки в консоли необходимо выполнить YellowWatcher.exe --help или YellowWatcher -H
2.4 Для установки службы в консоли необходимо выполнить YellowWatcher.exe --mode=install или YellowWatcher.exe -Minstall
3. Настройка:
При установке службы в каталоге расположения файла "YellowWatcher.exe" будет создан файл "settings.txt", в котором необходимо указать настройки, необходимые для работы службы.
Пример настройки:
host=server1c
http_host=web_server
http_port=80
http_target=/QMC/ws/InputStatistics.1cws
http_login=Incident
http_password=Incident
path_monitoring=C:\LOGS_MONITORING
host - имя текущего сервера, используется в формировании имени счетчика производительности в ЦКК, http_host - имя веб-сервера, на котором опубликована информационная база "Центр Контроля Качества", http_port - порт публикации ЦКК, http_target - путь до веб-сервиса "InputStatistics" ИБ ЦКК, http_login - имя пользователя ИБ ЦКК (пользователь должен иметь роли "Input statistics", "Input incident tickets"), http-password - пароль пользователя ИБ ЦКК, path_monitoring - каталог данных технологического журнала 1С (должен совпадать с каталогом, указанным в logcfg.xml).
4. Ограничения и возможные ошибки:
Не на всех ОС корректно воспринимается каталог установки, содержащий в имени пути кириллицу.
Отправка данных в ЦКК поддерживает только по http, https НЕ ПОДДЕРЖИВАЕТСЯ!
Работа службы проверена на windows server 2012R2, платформа 1С 8.3.17.1496 x64, ЦКК 2.1.4.15, веб-публикация ЦКК и все настройки публикации содержат только латинские символы.
5. Запуск:
Запуск в качестве службы выполняется через стандартную консоль управления службами. Для запуска в качестве консольного приложения необходимо выполнить "YellowWatcher.exe --mode=console" или "YellowWatcher.exe -Mconsole". При работе приложения по умолчанию ведется минимальный файл логов "YellowWatcher.log", расположенный в каталоге исполняемого файла.
6. Удаление:
Для удаления службы необходимо в консоли выполнить команду "YellowWatcher.exe --mode=uninstall" или "YellowWatcher.exe -Muninstall".
7. Интерпретация счетчиков производительности в ЦКК:
Пример для rphost
YellowWatcher/server1C/\ttimeout(dm_prod)\count - количество таймаутов за минуту для p:processName=dm_prod
YellowWatcher/server1C\tlock(dm_prod)\wait_count - количество ожиданий управляемых блокировок за минуту для p:processName=dm_prod
YellowWatcher/server1C/\tlock(dm_prod)\wait(µs) - сумма микросекунд ожиданий управляемых блокировок за минуту для p:processName=dm_prod
YellowWatcher/server1C/\rphost(dm_prod)\out(bytes) - сумма значений параметра out за минуту события CALL ТЖ для p:processName=dm_prod
YellowWatcher/server1C/\rphost(dm_prod)\memory(bytes) - сумма значений параметра memory за минуту события CALL ТЖ для p:processName=dm_prod
YellowWatcher/server1C/\rphost(dm_prod)\memory_peak(bytes) - сумма значений параметра memory_peak за минуту события CALL ТЖ для p:processName=dm_prod
YellowWatcher/server1C/\rphost(dm_prod)\in(bytes) - сумма значений параметра in за минуту события CALL ТЖ для p:processName=dm_prod
YellowWatcher/server1C/\rphost(dm_prod)\cpu_time(µs) - сумма значений параметра cpu_time за минуту события CALL ТЖ для p:processName=dm_prod
Для rmngr и ragent анализируются только события CALL, но в разрезе значения параметра IName, например:
YellowWatcher/server1C/\rmngr(ISeanceContextStorage)\cpu_time(µs) - - сумма значений параметра cpu_time за минуту события CALL ТЖ для IName=ISeanceContextStorage
