Развертывание визуализаций 3CX Grafana из каталога Grafana Marketplace

Введение

Визуализации 3CX Grafana доступны в Grafana Marketplace, что позволяет быстро и легко развертывать готовые дашборды 3CX. Это руководство применяется к 3CX Version 20 Update 7 (SP7) и выше.

Функция Data Connectors требует лицензию 16SC или выше.

Предварительные требования

Перед развертыванием плагина 3CX Grafana убедитесь, что настроено следующее:

  • Рабочий Data Connector (см. руководства для)::
  • Опции Data Transfer включены для метрик, которые планируется визуализировать в Grafana (например, История вызовов (CDR), Системные метрики и т.д.).

Шаг 1: Регистрация в Grafana

  • Посетите Grafana и зарегистрируйте новую учетную запись (поддерживается любой уровень, включая Free Plan).
  • При создании новой учетной записи настройте Grafana Stack — это будет базовый URL-адрес, где размещаются дашборды.

Шаг 2. Добавление источника данных 3CX

В данном примере используется MySQL. Для других баз данных обратитесь к соответствующей документации Data Connector.

  • В Grafana «Home» разверните «Connections» и выберите «Add new connection».

  • Выберите «MySQL Datasource» (или выбранный тип коннектора).

  • Выберите «Add new data source».

  • Укажите имя и все необходимые детали для Database Connection, после чего выберите «Save & Test» для подтверждения.
  • Следует использовать пользователя базы данных только с правами SELECT для таблиц 3CX.

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

Шаг 3. Настройка плагина

  • Перейдите в Plugin Marketplace: Grafana Home > Administration > Plugins and data > Plugins.

  • На странице плагина 3CX нажмите Install.

  • По завершении установки (от нескольких секунд до пары минут) появляется кнопка Enable. Может потребоваться обновление страницы.
  • Как только она станет видимой, нажмите на нее.

  • Страница обновится, и новая опция 3CX (& Configuration) появится в разделе «More Apps».
  • Перейдите в Configuration и выберите Data Source, созданный ранее. Если выбран совместимый источник данных, появляется зеленая галочка и становится доступной опция «Publish dashboards».
  • Нажмите на нее, чтобы продолжить.

Шаг 4. Просмотр дашбордов

  • Страница должна обновиться автоматически и открыть список Dashboards в приложении 3CX.

  • Дашборды теперь также будут доступны в папке 3CX в главном разделе Dashboards.

  • Нажатие на любой из них немедленно загружает доступные данные и начинает их отображение.

Шаг 5. Развертывание нескольких систем и кастомизация

Если требуется мониторинг нескольких экземпляров 3CX в одном Grafana Stack (домене) или внесение изменений в предоставленные шаблоны, можно создать их копии с помощью функции Export. Она находится в верхней части каждого вида Dashboard.

Затем их можно импортировать из главной панели Dashboards. Потребуется выбрать новый уникальный идентификатор для этого дашборда внутри Stack, а также указать базу данных (того же типа, что и в исходном развертывании) для подключения.

Шаг 6. Оповещения

Grafana позволяет устанавливать триггеры Alert для всех отслеживаемых метрик. В качестве примера показано, как добавить оповещение для высокой загрузки ЦП (High CPU Usage).

  • В дашборде «Health and Performance» выберите «New alert rule» в меню «＋».

  • Назовите оповещение и определите основные параметры, которые будут отслеживаться.

  • Далее следуйте инструкциям по настройке различных метапараметров для Alert, таких как папки и теги, а также получателей оповещения, текста и URL-адрес Runbook.

Дополнительная информация

Версия документа

Последнее обновление документа 15  января 2026

https://www.3cx.ru/docs/grafana-pbx-reporting/