Загрузка производственного (бизнес) календаря в Monq

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

Данная инструкция предназначена для системных администраторов поддерживающих инфраструктуру Monq.

Основная информация

Получить актуальный производственный календарь для России можно на сайте http://xmlcalendar.ru/ в формате JSON

Файлы предыдущих годов можно найти в репозитории.

Для загрузки производственного календаря в Monq используйте данную программу - monq-bcalendar-cli

Конфигурация

Программа подключается напрямую к БД live_pl_business_calendar_api_service, поэтому требуется обеспечить доступ к СУБД в среде запуска программы. Рекомендуется запускать на сервере d-head.

Перед запуском требуется записать ConnectionString для доступа к БД live_pl_business_calendar_api_service в переменную окружения BC_PG_CONNECTION. Взять данные подключения к БД можно в хранилище конфигураций Consul (production/pl/pl-business-calendar-api-service).

export BC_PG_CONNECTION="Host=db-global.in.<domain>;Username=live_pl_business_calendar_api_service_user;Password=<password>;Database=live_pl_business_calendar_api_service;"

Использование

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

Команда get calendars

./monq-bcalendar-cli get calendars

Просмотреть информацию о годах календаря по его имени

Команда get calendar name

./monq-bcalendar-cli get calendar "Производственный календарь Россия"

Обновление календаря

Команда update calendar

Добавить дни нового года или обновить дни уже существующего года в календаре. Требуется указать поставщика данных - xmlcalendar - файл с сайта http://xmlcalendar.ru/ в формате JSON.

Если год уже существует, то для обновления требуется добавить опцию --force-update

./monq-bcalendar-cli update calendar --name="Производственный календарь Россия" --year=2021 --provider="xmlcalendar" --file "/tmp/russia.json"