Подключение 3CX к автономной БД MySQL и Grafana

Введение

Это руководство предназначено для систем 3CX V20 Update 7 и описывает процесс подключения вашей АТС 3CX к автономной базе данных MySQL для использования с Grafana. В результате вы получаете удобную отчетность и визуализацию данных.

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

  • Работающий сервер MySQL.
  • Доступ администратора к серверу MySQL.
  • Доступ к консоли администратора 3CX.
  • Лицензия 3CX 16SC+ (требуется для функциональности коннектора данных "Data Connector").
  • Базовое понимание администрирования MySQL и SQL.

Шаг 1: Подготовка MySQL

1. Настройка базы данных MySQL

После установки базы данных MySQL внесите следующие изменения в конфигурацию:

Включите local_infile в конфигурации MySQL. Убедитесь, что включен глобальный параметр local_infile, который важен для эффективной пакетной передачи данных 3CX. Для этого отредактируйте конфигурационный файл MySQL и добавьте или измените параметр local_infile в разделе [mysqld]:

[mysqld]

local_infile=1

2. Разрешение удаленных подключений к базе данных

По умолчанию MySQL разрешает подключения с localhost. Необходимо разрешить удаленные подключения, чтобы АТС могла подключиться к базе данных. Для этого отредактируйте конфигурационный файл MySQL и добавьте (или измените) параметр bind-address:

bind-address = 0.0.0.0


Расположение конфигурационного файла MySQL зависит от операционной системы:

  • Linux: Обычно /etc/mysql/my.cnf, /etc/my.cnf или /etc/mysql/mysql.conf.d/mysqld.cnf.
  • Windows: Обычно в C:\ProgramData\MySQL\MySQL Server X.Y\my.ini.

3. Перезапуск базы данных MySQL для применения изменений

После редактирования перезапустите службу MySQL, чтобы изменения вступили в силу:

  • Linux: sudo systemctl restart mysql
  • Windows: Перезапустите службу MySQL из диспетчера служб.

4. Создание выделенного пользователя и базы данных MySQL

Войдите в MySQL как root или административный пользователь:

mysql -u root -p


При запросе введите пароль root.

Создание базы данных

Выберите описательное имя для вашей базы данных CDR (например, 3cx_cdr_db).


CREATE DATABASE 3cx_cdr_db;


Создание пользователя

Выберите надежный пароль для нового пользователя.

CREATE USER 'our_3cx_user'@'host' IDENTIFIED BY 'your_3cx_user_password';


Замените your_3cx_user и your_3cx_user_password на ваши учетные данные.

Замените 'host' на IP-адрес вашего сервера 3CX, если хотите разрешить подключения к базе данных только от АТС, или замените 'host' на '%', если хотите разрешить доступ отовсюду.

Примеры:

CREATE USER 'dbuser'@'192.168.10.1' IDENTIFIED BY 'myPass'; – разрешить доступ только с одного IP

CREATE USER 'dbuser'@'192.168.10.1' IDENTIFIED BY 'myPass'; – разрешить доступ с любого IP


Предоставление разрешений

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

GRANT INSERT, SELECT, CREATE, ALTER, DROP, INDEX, LOCK TABLES ON 3cx_cdr_db.* TO 'your_3cx_user'@'host';

FLUSH PRIVILEGES;

Здесь также замените 3cx_cdr_db, ‘your_3cx_user’ и ‘host’ в соответствии с указанными выше значениями.

5. Настройка сетевого экрана (если применимо)

Убедитесь, что сетевой экран вашего сервера MySQL разрешает входящие подключения на порт MySQL (по умолчанию: 3306) с IP-адреса вашей телефонной системы 3CX.

  • Linux (например, ufw):
    sudo ufw allow from <IP_адрес_АТС_3CX> to any port 3306
    sudo ufw reload
  • Сетевой экран Windows: Создайте входящее правило для разрешения TCP-подключений на порт 3306 с IP-адреса вашей АТС 3CX.

Шаг 2: Настройка "Data Connector" в 3CX

  1. В 3CX перейдите в консоль администратора > "Integrations" > "Data Connector".
  2. Выберите "MySQL" и введите следующие параметры:
  • Host: IP-адрес или FQDN (если доступно) хоста, на котором установлен MySQL.
  • Port: Порт базы данных (по умолчанию: 3306).
  • Database Name: Имя базы данных, созданной на шаге 1.
  • Username: Имя пользователя, созданного на шаге 1.
  • Password: Пароль, настроенный для нового пользователя.
  • Data Types: Выберите, какие данные вы хотите передавать.
  • Frequency: Установите частоту передачи данных из АТС в ваш MySQL.
  1. Сохраните конфигурацию и нажмите кнопку "Test" на АТС, чтобы проверить соединение с базой данных MySQL и подтвердить успешное подключение. Если тест не удался, перепроверьте хост, порт, имя базы данных, имя пользователя и пароль. Также убедитесь, что любые сетевые экраны на хосте MySQL или в сети разрешают подключения с IP-адреса вашей АТС.

Шаг 3: Подключение Grafana к экземпляру MySQL

  1. Войдите в ваш экземпляр Grafana (например, grafana.com или ваш собственный хостинг Grafana).
  2. Перейдите в меню конфигурации Grafana (значок шестеренки), нажмите "Data Sources", а затем "Add data source".
  3. Найдите и выберите "MySQL".

Подключение Grafana к экземпляру MySQL

Настройте источник данных в разделе "Connection", введя следующие данные

  1. Настройте источник данных в разделе "Connection", введя следующие данные:
  • Host: Введите IP или FQDN и порт вашей базы данных MySQL в формате: IP/FQDN:3306.
  • Database: Имя базы данных, созданной на шаге 1.
  • User: Имя пользователя, созданного на шаге 1.
  • Password: Пароль, настроенный для нового пользователя.

Нажмите "Save & test"

  1. Нажмите "Save & test" и убедитесь, что получено сообщение "Data Connection OK". Если возникнут ошибки, перепроверьте данные подключения и конфигурацию SSL. Также убедитесь, что любые сетевые экраны на хосте MySQL или в сети разрешают подключения с IP-адресов Grafana.

Убедитесь, что получено сообщение "Data Connection OK".

Версия документа
Последнее обновление документа 2 июня 2026
https://www.3cx.ru/docs/mysql-configuration/