IVA ДОКУМЕНТАЦИЯ
ОБНОВЛЕНИЯ

Взаимодействие с системами анализа и визуализации данных

Рассматривается на примере взаимодействия с ПО Apache Superset.

Более подробно про работу с Apache Superset — официальная документация Apache Superset

Установка и запуск Apache Superset

  1. установить ПО Apache Superset на сервер согласно официальной документации

  2. по окончании установки и запуска веб-сервера Apache Superset необходимо войти в веб-интерфейс Apache Superset через браузер по адресу http://<SUPERSET_FQDN>:8088

    Для входа в веб-интерфейс используются логин — Username и пароль администратора — Password, заданные в процессе установки Apache Superset. После ввода данных авторизации необходимо нажать кнопку Sign In
    Вход в Apache Superset

    Откроется страница по адресу http://localhost:8088/superset/welcome

Подключение к базе данных

Для визуализации статистики звонков необходимо подключить Apache Superset к базе данных сервера IVA CS. В этой базе хранятся все события (звонки, их длительность, статусы и т.п.), на основе которых будут строиться графики и дашборды.

  1. Settings → Database Connections → откроется раздел Databases

    Apache Settings

  2. нажать кнопку Database → откроется окно подключения к базе данных Connect a database

    Apache Databases

    • шаг Select a database to connect
      Выбрать подключаемую базу данных — PostgreSQL

      Подключение к базе данных

    • шаг Enter the required PostgreSQL credentials
      Заполнить параметры подключения к базе данных:

      • поле Host: IP-адрес сервера телефонии IVA CS, например, 10.0.0.100

      • поле Port: порт подключения к базе данных сервера телефонии IVA CS, по умолчанию 5432

      • поле Database name: имя базы данных

      • поле Username: логин для подключения к базе данных

      • поле Password: пароль для подключения к базе данных

      • поле Display Name: произвольное имя базы данных, отображаемое в веб-интерфейсе Apache Superset

      • нажать кнопку Connect для сохранения данных подключения к базе данных

        Данные для подключения к БД

    • шаг Database connected
      Нажать кнопку Finish

      Apache DB Connected

При успешном подключении в веб-интерфейсе будет отображаться системное уведомление: Database settings updated

Созданное подключение к базе данных будет отображаться в секции Databases

Успешное подключение

Создание отчета

Для создания отчета необходимо выполнить следующие действия:

Создание датасета

Для создания датасета необходимо перейти в раздел Datasets и добавить набор данных для анализа:

  1. нажать кнопку Dataset → откроется окно New dataset

    Apache Datasets

  2. заполнить данные датасета:

    • поле Database: выбрать базу данных, добавленную на предыдущем шаге

    • поле Schema: выбрать Public

    • поле Table: выбрать используемую таблицу базы данных

    • нажать кнопку Create and explore dataset

      Создание датасета

После создания датасета откроется раздел Charts

Создание чарта

Создание чарта

Для создания чарта необходимо перейти в раздел Charts и настроить параметры чарта:

  1. секция Choose a dataset: выбрать используемый набор данных — датасет

  2. секция Choose chart type: выбрать тип визуализации

  3. нажать Create new chart для создания нового чарта

В созданном чарте можно настроить внешний вид графика

Новый чарт

Настройка параметров отображения графика

В конструкторе чарта необходимо выбрать используемые колонки, добавить фильтры (при необходимости их использования на дашборде), определить сортировку (при необходимости) и отформатировать детали визуализации.

Настройка графика

Пример настройки параметров отображения графика:

  1. поле X-axis — настройки оси X (ось категорий):

    • нажать Drop a column here or click → окно My column

    • перейти во вкладку Simple

      • поле Column: выбрать используемую колонку

      • нажать кнопку Save

        Если Superset предложит добавить фильтр (это происходит при выборе колонки) — нажать OK — фильтр можно будет настроить позже на дашборде
        Выбор колонки

  2. поле Metrics — выбрать измеряемые параметры:

    • нажать Drop columns/metrics here or click → окно My metric

    • перейти во вкладку Simple

      • поле column: выбрать используемую метрику

      • поле aggregate: выбрать агрегатную функцию (например, SUM, COUNT, AVG)

      • нажать кнопку Save

        Выбор метрики

  3. нажать кнопку Create chart

    Визуализация чарта

    Будет сгенерирован график чарта

    Генерация чарта

  4. нажать кнопку Save для сохранения настроенных параметров чарта:
    Окно Save chart → Поле Chart name: ввести название сохраняемого чарта → Нажать кнопку Save

    Сохранение чарта

Создание дашборда

Для создания дашборда перейти в раздел Dashboards и настроить параметры дашборда:

  1. нажать кнопку Dashboard → окно создания дашборда

    Создание дашборда

  2. настроить параметры дашборда:

    • поле Add the name of the dashboard / [untitled dashboard]: ввести название дашборда

    • в секции Charts выбрать чарт и перенести его в рабочую область дашборда

      Настройка дашборда

  3. нажать кнопку Save

    Во вкладке Dashboards будет создан новый дашборд

    Созданный дашборд
    В случае успешного создания дашборда будет отображаться системное сообщение This dashboard was saved successfully

Пример настроенного дашборда

Примеры дашбордов