Подключение 3CX к БД Microsoft SQL и Grafana

Введение

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

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

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

Шаг 1: Создание базы данных SQL на Azure или на локальном сервере

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

  1. Войдите в ваш портал Azure здесь: https://portal.azure.com/
  2. Найдите и перейдите к "SQL Servers" и нажмите "Create".
  3. Выберите или создайте новую группу ресурсов.
  4. Установите уникальное "Server Name" и выберите местоположение рядом с вашей АТС.
  5. Выберите "Use SQL Authentication" и установите логин администратора и надежный пароль.
  6. Запишите эти учетные данные, так как они понадобятся позже для настройки "Data Connector" в консоли администратора 3CX.
  7. Нажмите "Review + Create", а затем "Create".

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

  1. Перейдите к "SQL Servers", откройте только что созданный сервер и запишите "Server Name", так как он понадобится позже для настройки "Data Connector" в консоли администратора 3CX.
  2. Нажмите "Create Database".

Укажите уникальное имя базы данных.

  1. Укажите уникальное имя базы данных.
  2. Выберите необходимые характеристики и размер базы данных в разделах "Compute and Storage".
  3. Нажмите "Review + Create", а затем "Create".

После создания базы данных перейдите к "SQL Databases" и откройте только что созданную базу данных.

  1. После создания базы данных перейдите к "SQL Databases" и откройте только что созданную базу данных.
  2. Нажмите "Set Server Firewall".

Переключите доступ к публичной сети на <b>“Selected Networks”</b> и нажмите <b>“Add a firewall rule”</b>.

  1. Переключите доступ к публичной сети на “Selected Networks” и нажмите “Add a firewall rule”.
  2. Добавьте публичный IP-адрес вашей АТС, которая будет обращаться к этой базе данных, и нажмите "Save".

Добавьте публичный IP-адрес вашей АТС, которая будет обращаться к этой базе данных, и нажмите "Save".

Создание базы данных SQL на локальном сервере

  1. Загрузите локальную версию Microsoft SQL Server и запустите установщик отсюда: https://www.microsoft.com/en-us/sql-server/sql-server-downloads
  2. После установки сервера загрузите и установите SQL Server Management Studio.
  3. Следуйте мастеру установки - запустите SQL Server Management Studio (SSMS).

Создание базы данных SQL на локальном сервере

  1. По умолчанию Microsoft SQL Server может не слушать порты или слушать динамические порты. Чтобы использовать определенный порт (например, 1433 по умолчанию), перейдите в меню "Пуск" Windows, найдите и откройте SQLServerManager16.msc.
  2. В левой панели перейдите в "SQL Server Network Configuration" → "Protocols for SQLEXPRESS".
  3. Щелкните правой кнопкой мыши по "TCP/IP" и нажмите "Enable".
  4. В "Protocols for SQLEXPRESS":
    Дважды щелкните по "    TCP/IP" и перейдите на вкладку "IP Addresses".
  5. Прокрутите вниз и найдите раздел "IPAll".
  6. Установите "TCP Port" = 1433 и оставьте "TCP Dynamic Ports" пустым, затем нажмите "OK".
  7. Вернитесь в "SQL Server Configuration Manager". В левой панели перейдите в "SQL Server Services".
  8. Щелкните правой кнопкой мыши по вашему экземпляру (например, MSSQLSERVER) и нажмите "Restart".

Откройте установленную ранее SQL Server Management Studio.

  1. Откройте установленную ранее SQL Server Management Studio.
  2. Можно подключиться к новому SQL Server на localhost как администратор, используя аутентификацию Windows, как показано ниже.

После подключения к SSMS щелкните правой кнопкой мыши по "Databases" > "New Database".

  1. После подключения к SSMS щелкните правой кнопкой мыши по "Databases" > "New Database".
  2. Дайте базе данных уникальное имя и нажмите "OK".

Чтобы включить аутентификацию SQL Server для подключения АТС к базе данных, щелкните правой кнопкой мыши по вашему SQL Server в левой панели и нажмите "Properties".

  1. Чтобы включить аутентификацию SQL Server для подключения АТС к базе данных, щелкните правой кнопкой мыши по вашему SQL Server в левой панели и нажмите "Properties".
  2. Перейдите в "Security", выберите опцию “SQL Server and Windows Authentication mode” и нажмите "OK".
  3. Еще раз перезапустите ваш SQL Server либо из "SQL Server Manager", как показано выше, либо через диспетчер задач.

Чтобы создать пользователя для подключения АТС к этой базе данных, щелкните правой кнопкой мыши по "Logins" > "New Login".

  1. Чтобы создать пользователя для подключения АТС к этой базе данных, щелкните правой кнопкой мыши по "Logins" > "New Login".
  2. Установите имя пользователя в "Login Name".
  3. Выберите "SQL Authentication" и установите надежный пароль.
  4. Снимите флажок "Enforce password policy", если не хотите применять правила сложности.
  5. "Default database": выберите вашу новую базу данных, созданную выше (например, cdr_db).

В окне "Login" нажмите "User Mapping" слева.

  1. В том же окне "Login" нажмите "User Mapping" слева.
  2. Выберите вашу новую базу данных (например, cdr_db).
  3. В "Database role membership" отметьте опции для:

db_datareader, db_datawriter, db_ddladmin

  1. Нажмите "OK".

В "Database role membership" отметьте опции для: <div style= db_datareader, db_datawriter, db_ddladmin

" src="https://docs.google.com/docs-images-rt/ALKuztZJmBfcepL1hsoLB4adQkgW2kxynYpaXxlsbJSzAfKTpb6s7WZNNR5TypiMolskGx8QZpUZtaksnk8yZUGRUUeEIl_MMr8PWdAa5fgSKabtG-K0Mh30Ao54d0ydWP-fw1aNr_rWyNbS0POjd7Si=s2048" style="width: 546.00px; height: 507.39px; margin-left: 0.00px; margin-top: 0.00px; transform: rotate(0.00rad) translateZ(0px); -webkit-transform: rotate(0.00rad) translateZ(0px);" title="В "Database role membership" отметьте опции для:
db_datareader, db_datawriter, db_ddladmin
">

Шаг 2: Настройка коннектора данных "Data Connector" в 3CX

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

Шаг 3: Подключение Grafana к базе данных Microsoft SQL

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

Подключение Grafana

Найдите и выберите "Microsoft SQL Server".

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

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

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

Нажмите "Save & test" и убедитесь, что получено сообщение "Database Connection OK".

Версия документа
Последнее обновление документа 24 июля 2025
https://www.3cx.ru/docs/microsoft-sql-server-configuration/