Что будет выполнено в рамках данной инструкции:
- Получение токена, активация демо-режима
- Настройка сбора технологического журнала
- Настройка сбора APDEX
- Настройка дашбордов
- Настройка алертов
Получение токена, активация демо-режима
При первом входе по адресу, если токен не был введен, появиться окно
Если у вас нет токена, нажимайте кнопку Да, токен будет создан автоматически, будет активирован демо-режим на 7 дней с ограничением на количество обрабатываемых данных — 500Мб.
Во втором окне можно будет либо сразу скачать агента для сбора технологического журнала, либо отправить файлы на анализ.
Закроем подсказки, перейдем к следующему шагу.
Настройка сбора технологического журнала
Если на предыдущем шаге вы еще не скачали агента, то это всегда можно сделать в режиме работы с интерфейсом.
Скачиваем агента, распаковываем в нужном месте. Агент размещается на том сервере, с которого надо собирать технологический журнал и метрики оборудования.
1clogagent — непосредственно выполняемый файл, его можно как запустить из терминала, так и установить как службу с помощью bat-файла — install_service.bat.
Файл logcfg.xml это эталонный файл настроек сбора технологического журнала. В этом файле будет периодически меняться путь до папки сбора технологического журнала. По умолчанию настройка на сбор полного технологического журнала, для высоконагруженных систем желательно настроить другой вариант сбора, чтобы не было большой нагрузки на сервер. В этом файле необходимо указать нужную вам папку в параметре location. Желательно размещать файл на отдельном диске.
В файле agent.ini находятся настройки агента, которые в дальнейшем можно поменять через веб-интерфейс сервиса.
Проверьте, что в token записался выданный вам токен. В настройку server_name нужно подставить имя вашего сервера. В дальнейшем большинство отчетов и дашбордов формируется в разрезе серверов.
location_change_interval_min — указывает через сколько минут менять путь до location. Рекомендуемое значение 2 минуты. В archive_interval_min прописано через сколько минут архивировать старые папки. Если поставить сильно маленькое значение, то платформа может еще писать в старые папки данные и поэтому архивация с первого раза может не получиться. Рекомендуем ставить 2.
В disk_space_threshold_gb указывается количество свободного места в Гб на диске, куда пишется технологический журнал. Если места станет меньше, то сбор прекратится.
В metrics_interval_sec указывается интервал отправки данных о состоянии оборудования.
После настройки можно попробовать запустить исполняемый файл. Обратите внимание, если в консоли есть указанная строка, значит у пользователя, под которым запущен агент, нет прав на запись в C:\Program Files\1cv8\conf. В таком случае технологический журнал собираться не будет.
Если подключение пройдет успешно, то в меню Статус агента в веб-интерфейсе сервиса вы увидите сведения об агента и его статус.
Кнопка настройки агента может не влезать, для этого необходимо воспользоваться горизонтальной прокруткой.
При нажатии на кнопку вы сможете настроить агента на выбранном сервере. Часть изменений сразу отобразиться в файле agent.ini. Здесь же есть возможность вручную исправить файл logcfg.xml, а так же воспользоваться конструктором настроек техжурнала.
Настройка сбора APDEX
На примере конфигурации 1С: ERP рассмотрим настройку сбора показателей APDEX. В конфигурации открываем подсистему НСИ и администрирование, блок Администрирование, пункт Обслуживание.
Разворачиваем блок «Оценка производительности», если галочка «Оценка производительности» не установлена, то ставим ее, переходим в настройки и настраиваем автоматический экспорт. Не забудьте внизу настроить расписание экспорта. Регламентные задания для базы должны быть разрешены.
Убеждаемся, что в папке начали появляться файлы
Переходим в настройки агента в веб-интерфейсе, как в прошлом пункте. Добавляем папку замеров APDEX. Для нее необходимо указать папку, которую мы настроили для экспорта, имя сервера 1С и имя базы и обязательно сохранить настройки.
Файлы будут забираться из папки и удаляться автоматически. После этого можно сформировать отчет по APDEX.
Настройка дашбордов
Дашборды добавляются на главной странице
Есть различные варианты дашбордов, добавим дашборд по операциям APDEX.
Для APDEX надо выбрать сервер и базу, а также периодичность, с которой отображается график.
После нажатия на кнопку «Добавить» дашборд появиться на главной странице.
Настройка алертов
Настроим правила оповещения. Сервис позволяет делать оповещения в чат-бота телеграм. У вас к этому времени должен быть создан чат бот, получен токен чат бота и идентификатор чата. Для добавления сведений о чат-боте в сервис надо зайти в меню Интеграции.
Наименование вводим произвольное, токен и идентификатор чата, полученный после регистрации чат-бота.
Далее создаем правило оповещения
Например добавим оповещение на падение APDEX. Для этого пишем наименование, указываем имя сервера, источник метрики выберем Apdex, появиться окно выбора базы, для которой будет срабатывать эта проверка.
Выберем метрику «Общий Apdex», она будет проверять в целом значение Apdex. Можно сделать оповещение на какую-нибудь конкретную операцию. Чтобы оповещение сработало, поставим пороговое значение 0.99. В окне оценивания ставим время, в течение которого значение должно попадать под условие, чтобы оповещение сработало. Тип окна оценивания ставим Среднее, тогда если средний Apdex за минуту будет меньше 0.99, тогда сработает оповещение.
В задержке подтверждения ставим сколько окон должно попадать под условие для срабатывания оповещения. Указываем уровень серьезности. Нам нужно, чтобы было оповещение, поэтому ставим галочку «Оповещать» и выбираем того телеграм-бота, в который должно уходить оповещение. Ниже есть еще возможность указать с каким интервалом отправлять оповещение, пока инцидент активен.
Теперь можно перейти в меню «Обзор правил» и там будет краткая сводка по всем правилам в виде прямоугольников разных цветов. Если все зеленые, значит все правила в данный момент не сработали. Таким образом удобно мониторить общую картину и в случае появления красных прямоугольников смотреть подробнее, что произошло.
При срабатывании правил, создается инцидент. Его можно признать или решить.
Прямоугольник в обзоре правил окрасился в красный цвет.
После решения инцидента, если нет условия для его повторного срабатывания, прямоугольник вновь будет окрашен в зеленый цвет.
Необходимый минимум для начала работы выполнен, дальше вам необходимо создать правил оповещения, критичный для вашей системы и мониторить работу серверов 1С в автоматическом режиме.