Введение

С превью дашбордов временами могу происходит не понятные Под превью (превьюшки, эскизы, thumbnails) подразумеваются небольшие картинки-снимки внутри разделов на портале платформы. С ними  временами могут происходит непонятные вещи. Превью может вовсе не создаться, либо создаться, но виджеты на нём будут с ошибками. Чтобы понять с какой стороны подойти к этой проблеме и была написана эта небольшая статья.

1.

Триггеры, вызывающие создание превью.

Существует несколько тригеров, которые приводят к созданию и обновлению превьюшек. Они показаны на схеме ниже.

Image Added

1. Сохранение в DD. Нажимаем кнопку "Сохранить" в Дэшборд Дизайнере.
2. Обновление по расписанию. Существует регулярная задача в контейнере schedule (внутри используется Hangfire для управления запланированными задачами)

1. , которая запускается раз в 10 минут.
2. Постановка флажка в настройках дашбордов (в веб администрировании) - "Создавать превью автоматически"

1. . Т.е., если мы её отключим, а затем включим (по умолчанию она включена)

1. , то превью создастся. 

2. Где хранятся картинки и настройки.

• Сами превью хранятся в компоненте mongodb - DashboardScreenshots. Также в этой коллекции хранятся такие параметры как дата последнего обновления и флаг "Создавать превью автоматически".

Image Removed

• Также в Монге в коллекции GeneralSettings хранится информация о расписании обновлении превьюшек, создании новых и удалении неактуальных.

         Image Added

• Заглушка для случаев неуспешного создания превью хранится внутри компонента экспорт-сервис. Во время неудачной попытки создания превью картинка записывается в соответствующий дашборд в mongodb - DashboardScreenshots.

          Image Added

3. Описание работы и имеющиеся логи.

Центральный компонент работы этого механизма - Dashboard-service. Пайплайн следующий:

1. Dashboard-service говорит компоненту export-service, что надо создать превью. Делает он это через прокси, используя внешний адрес платформы.

2. Внутри export-service работает puppeteer, который открывает дашборд от системного юзера PreviewMaker, ждет 30 сек, делает скрин и отправляет обратно на Dashboard-service (тоже все через прокси). Если скрин сделать не удалось, то отправляет заглушку.

   Информация

   Есть фича, реализованная для очень длинных по высоте дашбордов с фиксированной шириной (с версии 2.24). Если высота дашборда больше ширины, то ширина умножается на 9/16 и присваивается высоте. Далее pupeteer открывает дашборд с этими размерами и делает скриншот, соотношение которого получается 16:9. Нужно это для заполнения всей области с превью дашборда в разделах на веб портале платформы. Пример: дашборд 2000 х 5000. Размер скриншота: 2000 x 1125.

   
   

3. Dashboard-service сохраняет скриншот в Монгу уже напрямую внутри докер подсети без использования прокси.

Случай 1.

Давайте рассмотрим случай, когда мы сохраняем дашборд в ДД или включаем флажок в настройке дашборда. После сохранения  Image Added

После любого из этих действий на адрес "/corelogic/api/command" посылается запрос:

{
    DashboardGuid: "...",
    CommandType: "MakeDashboardPreview+Command"
}

Если для "Dashboard service" уровень логирования установить Full, то в событие Seq выглядит следующим образом:

Image AddedImage Removed

Случай 2.

По расписанию превью обновляются каждую минуту. Выполняются следующие 2 запросазадача на обновление превью выполняется каждые 10 мин (это видно и по логам и по записи в Монге). Логика работы следующая: у каждого превью есть дата создания, поэтому выбирается ОДНО самое старое превью и для него одного обновляется картинка.

Выполняются следующие 2 запроса от компонента schedule на dashboard-service, адрес "/corelogic/api/command":

{
    CommandType: "RefreshOutdatedDashboardPreviews+Command"
}

Данный запрос (картинка выше) обновляет устаревшие превью.

{
    CommandType: "MakeBrandNewDashboardPreviews+Command"
}

А этот запрос (картинка выше) создаёт превью для дашбордов, у которых его еще нет. Это в первую очередь нужно для дашбордов по внешней ссылке, добавленных внутри настроек портала.

4.

Для начала стоит понять, какого рода проблема перед нами.

Превью не создаётся вовсе

Такая проблема может проявиться если дашборд грузится слишком долго (более 30сек), превью просто не успевает создаться. Также такое поведение бывает на версии 2.19, когда на дашборде имеются виджеты с ошибками. Ну и в других необъяснимых случаях.

Если у нас не 2.19, то идём далее, если 2.19 то следует исправить ошибки в виджетах.

Для диагностики данной проблемы первым делом стоит посмотреть как долго грузится дашборд, если скорость загрузки в норме, то переходим к логам. В логах ищем ошибки рядом с такими событиями, как:

• MakeBrandNewDashboardPreviews;
• MakeDashboardPreview;
• RefreshOutdatedDashboradPreviews.

Известные проблемы.

Такое поведение может проявляться если у роли, которая назначена для сбора превью ограничены права. Стоит зайти в базу данных и проверить права у этой роли.

Также такое поведение может быть из-за запущенных загрузчиков или планов загрузки. Когда создание превью попадает на выполняющийся план загрузки, то у виджетов будут ошибки. Это достаточно редкое явление, но оно есть.

Чего не хватает.

В целом диагностику проблем после исключения всего, что выше, стоит начинать с логов, вот по этим событиям:

• MakeBrandNewDashboardPreviews;
• MakeDashboardPreview;
• RefreshOutdatedDashboradPreviews.

От этих ошибок можно отталкиваться куда копать далее, если они конечно будут.

5. Созданные реквесты на доработку.

На дополнительные логи для диагностики - #43194