Расписание заставляет DashPDF регулярно формировать отчёт по одному и тому же дашборду. Сначала добавьте токен сервисного аккаунта в настройках плагина («Настройки плагина»).
Создание расписания
- Настройте экспорт на странице Export. Расписание всегда строится по всему дашборду.
- Нажмите Save as schedule. Кнопка доступна ролям Editor и Admin.
- Плагин один раз выполнит запросы дашборда и запишет их план. Заполните форму и сохраните.
Временной диапазон должен быть относительным, например «Last 6 hours». При абсолютном диапазоне появится This export cannot be scheduled.
Если появилось предупреждение panel(s) will be empty in scheduled reports, в запросах этих панелей используются $__from, $__to или ${__from:date}. Замените их на $__timeFilter (для Prometheus --- на $__range или $__rate_interval) и запишите план заново.
Параметры расписания
- Name --- название.
- When --- cron-выражение из 5 полей, например
0 9 * * 1-5(по будням в 9:00), или сокращение вроде@daily. - Time zone --- часовой пояс, в котором вычисляется cron-выражение.
- Time window --- диапазон, зафиксированный при записи плана.
- Recipients --- адреса пока только проверяются; отправка по почте появится позже.
- Active --- приостановленное расписание сохраняет настройки и план, но не запускается.
- Output --- те же параметры формата и страниц, что и на странице Export.
Список расписаний
На странице Schedules для каждого расписания показаны Name, When, Status, Next run и Last run. Чтобы изменить расписание, нажмите Edit (у роли Viewer --- View).
Редактирование
Измените поля и нажмите Save schedule. Record plan again заново выполняет запросы с тем же окном и переменными и заменяет план --- например, после исправления заблокированной панели или изменения дашборда.
Если появилось This schedule was changed elsewhere, кто-то сохранил расписание после того, как вы его открыли: нажмите Reload и внесите изменения ещё раз.
Delete удаляет из DashPDF настройки расписания и записанный план.
Куда попадают отчёты
Каждый запуск сохраняется в вашем аккаунте DashPDF и появляется отдельной строкой на странице Дашборд на dashpdf.app.
Неудачные запуски
Если запуск по расписанию завершился ошибкой, расписание продолжает работать, а в статусе видно, сколько запусков подряд не удались. Успешный запуск сбрасывает счётчик. После 3 неудачных запусков подряд DashPDF ставит расписание на паузу, чтобы не создавать отчёты с ошибками. Чтобы возобновить его, устраните причину, откройте расписание, убедитесь, что Active включён, и нажмите Save schedule.
Статусы
- Active --- расписание работает. Active · N failed run(s) in a row означает, что последние запуски завершились ошибкой.
- Paused --- отключено переключателем Active.
- Paused: Grafana unlinked --- токен инстанса отозван на dashpdf.app.
- Paused: failed 3 times in a row --- устраните причину и сохраните расписание, чтобы возобновить его.
- Stopped: service account token rejected --- сохраните рабочий токен в настройках плагина.