Введение

В статье описана интеграции r_keeper_7 и аналитическим приложением Grafana. 

Установка Grafana

Grafana доступна для различных систем — Linux, Windows и других. Установка тривиальна и подробно описана на странице скачивания. В нашем примере рассмотрим установку на Windows. Подробное описание на английском доступно по адресу https://grafana.com/docs/grafana/latest/installation/windows/.

  1. Скачайте установщик со страницы загрузки
  2. Запустите установщик и дождитесь завершения процесса
  3. Перейдите в браузере по адресу http://localhost:3000/login или по адресу сервера, на котором установлена система
  4. Должно открыться окно логина
  5. Если окно появилось, установка прошла успешно. Логин и пароль по умолчанию — admin / admin

Настройка Grafana

  1. Скачайте приложенный к статье файл
  2. В левом меню Grafana нажмите на значок + и выберите пункт Import
  3. Нажмите кнопку Upload .json file
  4. Выберите скачанный ранее json-файл
  5. Укажите название в поле Name для созданного дашборда
  6. Нажмите кнопку Import
  7. На экране появится созданный дашборд

Установка плагина круговых диаграмм

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

Если плагин не установить, на месте диаграммы будет появляться такая ошибка:

Устанавливается плагин через командную строку. 

  1. Запустите командную строку от администратора
  2. Перейдите в путь установки Grafana. Для пути по умолчанию: cd "C:\Program Files\GrafanaLabs\grafana\"
  3. Перейдите в папку bin: cd bin

  4. Выполните команду:

    .\grafana-cli.exe plugins install grafana-piechart-panel
    POWERSHELL
  5. Плагин установится и появится такое сообщение:
  6. Перезапустите сервер Grafana и круговые диаграммы заработают.

Настройка связи с базой данных

Чтобы дашборд получал данные, необходимо зарегистрировать в системе источник данных.

  • Перейдите в меню Configuration > Datasources
  • Нажмите кнопку Add data source
  • В разделе SQL выберите пункт Microsoft SQL Server и нажмите Select

  • Настройте подключение к серверу MS SQL. Заполните поля:
    1. Host — IP-адрес и порт сервера. Через двоеточие можно указать порт
    2. Database — имя базы данных r_keeper_7
    3. User — пользователь базы данных. Рекомендуем для Grafana создать пользователя с минимальными правами в базе данных — достаточно права на выполнения SELECT
    4. Password — пользователь базы данных
    5. Encrypt — шифрование. Принимает значения false – выключено и true – включено
    6. Обязательно включите настройку Default, чтобы MS SQL источником данных по умолчанию
  • Нажмите Save & Test
  • Должна появиться надпись Database Connection OK. В иных случаях — проверяйте настройки подключения к серверу MS SQL 

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

Настройка закончена. Можно смотреть графики. Перейдите на главную страницу и найдите там созданный ранее дашборд:

Если в базе есть данные, они отобразятся на графиках:

Готово, Grafana работает. Каждый график можно детально настроить и поменять вообще все. Детальное описание настройки есть в официальной документации.

Успехов!