Как создать отчет в Upservice с помощью SuperSet?

Часть 1. Вход и знакомство с данными

Эта инструкция поможет вам самостоятельно строить отчеты на основе данных из Upservice. Вам не нужно писать код или просить выгрузку у разработчиков — все данные уже доступны в Superset.

1. Как попасть Superset

Зайдите в раздел “Отчёты” в Upservice.
Нажмите кнопку «Добавить» в верхнем правом углу - доступно только для владельца воркспейса.
Откроется интерфейс Apache Superset.

2. Основные понятия (Краткий словарь)

Интерфейс может показаться сложным, но для работы вам нужно знать всего три термина. Представьте, что мы строим дом:

Dataset (Набор данных/Датасет): Это наши «кирпичи». Таблица, в которой лежат данные (Тикеты, Пользователи, Логи времени).
Chart (График): Это «стена». Визуальное представление данных: таблица, круговая диаграмма или график с кривыми.
Dashboard (Дашборд): Это «дом». Страница, на которой собраны несколько графиков и фильтры для управления ими.

3. С чем мы будем работать (Описание данных)

Для построения отчетов мы подготовили для вас основной набор данных. Он называется [Название вашего Dataset, например: Tickets_Main].

Внутри этого набора данные делятся на три типа. Понимание этого разделения — 90% успеха при создании отчета.

А. Метрики (Metrics) — «Сколько?»

Это числа, которые можно складывать, искать среднее или считать.

COUNT (*): Количество тикетов (штук).
Затраченное время (Time Spent): Сумма часов/минут, залогированных в задачи.
Оценка (Estimate): Исходная оценка времени на задачу.

Б. Измерения (Dimensions) — «В разрезе чего?»

Это качественные параметры, по которым мы будем группировать цифры.

Исполнитель (Responsible): ФИО сотрудника, ответственного за тикет.
Статус (Status): Текущее состояние (Новый, В работе, Готово, Архив).
Проект/Тег: К какому проекту относится задача.

В. Время (Temporal) — «Когда?»

Superset очень любит даты. Почти любой график требует указать, какую дату считать главной.

Дата создания (Created At): Когда тикет появился.
Дата закрытия (Completed At): Когда работу завершили.
Дедлайн (Deadline): Срок исполнения.

4. Главное меню

После входа вы увидите верхнюю панель навигации. Вам понадобятся вкладки:

Dashboards: Здесь лежат готовые отчеты.
Charts: Библиотека всех созданных графиков.
Datasets: (В меню Data) Источники данных.
Кнопка «+» (справа сверху): Самая главная кнопка для создания нового Графика или Дашборда.

Часть 2. Создание источника данных («Тикеты Витрина»)

Прежде чем строить графики, нам нужно подготовить «Витрину» — набор данных, собранный специально для аналитики. Мы сделаем это через SQL Lab.

1. Запуск SQL Lab

В верхнем меню выберите SQL Lab -> SQL Editor.
Слева выберите:

Database: clickhousedb.
Schema: public.

2. Ввод запроса

В основное поле редактора вставьте следующий код. Этот запрос собирает тикеты, объединяет их с именами сотрудников и отфильтровывает лишнее.

SELECT
t.id AS ticket_id,
t.title AS ticket_title,
-- Склеиваем Имя и Фамилию в одну строку
concat(e.first_name, ' ', e.last_name) AS assignee_name,
t.status,
t.created_at,
t.date_end, -- Срок исполнения
t.completed_at,
t.work_log -- Залогированное время (обычно в секундах)
FROM
tasks_task AS t
LEFT JOIN projects_project p ON t.project_id = p.id
LEFT JOIN workspaces_employee e ON t.responsible_id = e.id
WHERE
t.kind = 'ticket' -- Берем только тикеты

3. Проверка и Сохранение

Нажмите кнопку Выполнить.
Внизу появится таблица Результаты. Убедитесь, что данные выглядят корректно.
Нажмите кнопку Сохранить -> Сохранить датасет.
В поле Имя датасета введите понятное название: Тикеты Витрина
Нажмите Сохранить & исследовать.

Часть 3. Создание первого графика

Теперь, когда у нас есть набор данных «Тикеты Витрина», мы создадим ваш первый отчет. Давайте разберем это на примере задачи: «Посмотреть, сколько часов потратил каждый сотрудник».

1. Начало работы

В верхнем меню нажмите «+» (Плюс) -> Диаграмма.
Откроется окно создания:

Выберите набор данных: Найдите в списке Тикеты Витрина.
Выберите тип диаграммы: Для нашей задачи отлично подойдет Столбчатая диаграмма (Bar Chart) или Таблица (Table). Давайте выберем Таблица.

Нажмите кнопку Создать диаграмму.

2. Настройка данных (Панель слева)

Вам нужно заполнить три секции. Используйте перетаскивание полей (drag-and-drop) или нажимайте на плюсики.

А. Dimensions (Группировка) — «В разрезе чего?»

Сюда перетаскиваем текстовые поля.

Нажмите в поле Dimensions.
Выберите assignee_name (чтобы разбить таблицу по сотрудникам).

В. Metrics (Показатели) — «Что считаем?»

Сюда добавляем цифры.

Нажмите в поле Metrics.
Выберите COUNT(*) — чтобы увидеть количество задач.

Выберите Simple -> столбец work_log -> SUM.

Г. Filters (Фильтры и Время) — «За какой период?»

В таблицах настройка времени находится здесь.

Найдите поле, где уже написано t.created_at (No filter) (или другое поле с датой).
Нажмите на него.
В открывшемся окне выберите вкладку Range type (Временной интервал):

Last (Последние): Например, Last 1 Month.
Custom (Свой): Выбрать конкретные даты в календаре.
Без фильтрации: За всё время.

Нажмите APPLY (Применить).

(Если вам нужно отфильтровать лишнее, например, убрать задачи без исполнителя, нажмите + Add filter в этом же блоке).

3. Просмотр и Сохранение

Нажмите кнопку Создать диаграмму (или UPDATE CHART) внизу.
Справа появится таблица.
Нажмите Save (Сохранить).
Имя диаграммы: Назовите график, например: «Эффективность сотрудников (Таблица)».
Добавить на дашборд: Напишите название нового дашборда: «Мои отчеты».
Нажмите Сохранить и перейти к дашборду.

Часть 4. Сборка Дашборда и «Умные» фильтры

Дашборд — это ваша приборная панель. В Superset она работает как конструктор.

1. Режим редактирования

Если вы нажали «Сохранить и перейти к дашборду» в прошлом шаге, вы уже на месте. Если нет — найдите свой дашборд в меню Dashboards (Дашборды).

Чтобы что-то изменить, нужно войти в режим редактора:

Посмотрите в правый верхний угол.
Нажмите кнопку EDIT DASHBOARD (Редактировать дашборд) или иконку карандаша.

Вы увидите, что сетка стала активной, а справа появилась панель компонентов.

2. Настройка макета (Layout)

Справа вы видите панель с двумя вкладками: Диаграммы и Оформление.

Удаление графика:

В правом верхнем углу таблицы «Эффективность сотрудников (Таблица)» нажмите иконку корзины.

Добавление графиков:

Перейдите во вкладку Диаграммы.
Найдите созданную вами таблицу.
Перетащите её на поле в центре.

Изменение размера:

Потяните за нижний правый уголок графика, чтобы растянуть его.

Красота (Заголовки и ряды):

Перейдите во вкладку Оформление.
Перетащите элемент Header (Заголовок) над вашим графиком.
Напишите в нем, например: «Статистика отдела».
Элемент Row (Ряд) позволяет ставить графики в одну линию рядом друг с другом.

Сохранение изменений

Нажмите Сохранить в верхнем правом углу

3. Настройка фильтров

Это самый важный шаг. Мы создадим панель слева, которая будет управлять всеми графиками сразу.

Посмотрите на левую часть экрана сохраненного дашборда(не в режиме редактирования).
Нажмите на иконку настроек(шестерёнка) кнопку и ДОБАВИТЬ или ИЗМЕНИТЬ ФИЛЬТРЫ.
Откроется окно настроек.

А. Создаем фильтр по Дате

Чтобы выбирать период (например, «Прошлый месяц»).

В левом нижнем углу окна нажмите кнопку Фильтр (с иконкой воронки).
В центре заполните настройки:

Тип фильтра: Выберите из списка Time filter. (Это и есть фильтр периода).
Имя фильтра: Напишите Период.

3.Разверните секцию «Настройки фильтра» (внизу):

Поставьте галочку Фильтр имеет значение по умолчанию.
В появившемся поле выбора (Default value) выберите, например, Last month -> APPLY. (Так при входе в дашборд он сразу покажет данные за месяц, а не будет пустым

4.Перейдите на вкладку Область применения (сверху):

Убедитесь, что стоит галочка Все панели.

Б. Создаем фильтр по Сотруднику

Чтобы смотреть статистику конкретного человека.

Снова нажмите кнопку Фильтр (внизу слева).
Заполните настройки:

Тип фильтра: Выберите filter (Выпадающий список).
Имя фильтра: Напишите Сотрудник.
Датасет: Выберите Тикеты Витрина.
Column: Выберите поле assignee_name.

3.В секции «Настройка фильтра»:

Можно поставить галочку Can select multiple values (или «Множественный выбор»), чтобы выбирать нескольких людей сразу.

4.На вкладке Область применения проверьте, что галочка стоит напротив всех графиков.

В. Сохранение

Нажмите синюю кнопку Сохранить в правом нижнем углу окна.

Часть 5. Добавление графика (Круговая диаграмма)

Давайте сделаем красивый «бублик», который покажет распределение задач по статусам.

1. Создание нового графика

В верхнем меню нажмите «+» -> Диаграмма.
Dataset: Выберите Тикеты Витрина.
Chart Type: Нажмите на иконку таблицы, чтобы сменить тип.

В поиске введите Pie.
Выберите Pie Chart (Круговая диаграмма).

4.Нажмите Создать диаграмму.

2. Настройка (Слева)

Нам нужно сказать системе: «Возьми все тикеты и разбей их кучки по Статусам».

1.Dimensions (Группировка):

Нажмите и выберите поле status (или status_name).

2.Metrics (Показатели):

Выберите COUNT(*) (количество штук).

3.Filters (Фильтры):

Убедитесь, что временной фильтр (Time Range или Time filter) стоит в значении No filter (чтобы видеть срез за всё время или чтобы он подчинялся глобальному фильтру позже).

Совет: Чтобы график выглядел современнее, зайдите во вкладку Customize (Кастомизация) над настройками и поставьте галочку Donut (Пончик). График превратится в кольцо.

4.Нажмите UPDATE CHART (Обновить).

3. Сохранение и добавление на Дашборд

Нажмите Save (Сохранить).
Chart Name: Назовите график, например: «Статусы задач».
Add to Dashboard:

Внимание: Не создавайте новый дашборд!
В поле выберите из списка ваш существующий дашборд («Статистика Отдела»).

4.Нажмите Сохранить и перейти к дашборду.

4. Размещение на доске

Вы попадете на свой дашборд. Новый график появится в самом низу.

Нажмите Редактировать дашборд.
Найдите ваш новый график «Статусы задач» внизу.
Потяните его мышкой и поставьте РЯДОМ с таблицей (справа или слева). Superset сам подсветит синим место, куда он встанет.
Теперь у вас на одном экране и таблица, и график.
Нажмите SAVE.

Часть 6. Добавление дашборда в Upservice

Давайте добавим созданный дашборд в Upservice

Нажмите на иконку действий в правом верхнем углу и далее Поделиться->Скопировать ссылку в буфер обмена выаыв

В Upservice перейдите в раздел Отчёты, нажмите на Добавить отчёт из Superset в Upservice

3.Вставьте скопированную ссылку в поле ввода и нажмите Добавить
4.Теперь дашборд “Мои отчёты” доступен в секции “Другие отчёты”