将数据库中的 PBX 数据导入 Grafana

PBX 数据同步至第三方数据库后，可将该数据库添加为 Grafana 数据源，并使用 Yeastar 提供的仪表板模板在 Grafana 上导入，实现数据可视化。

使用要求


平台	要求
Grafana	具有 Organization administrator 角色。
第三方数据库	版本：使用 Grafana 支持的数据库版本。更多信息，请参见以下官方链接：支持的 Microsoft SQL Server 版本支持的 MySQL 数据库支持的 PostgreSQL 数据库网络：数据库与 Grafana 网络互通。帐户：使用具有只读权限 (SELECT) 的帐户。注： Grafana 不会校验查询的安全性，因此用户可能执行存在风险的 SQL 语句。建议创建一个权限受限的专用账户，以降低安全风险。

注：本文以 PostgreSQL 为例，介绍如何将数据库中的 PBX 数据导入 Grafana。Microsoft SQL Server 和 MySQL 的操作基本相同。

登录 Grafana 平台，进入 Connections > Add new connection。
添加数据源。
1. 搜索数据库类型，并从数据源列表中选择数据库类型。
  在本例中，选择 PostgreSQL 数据源。
2. 点击右上角的 Add new data source。

填写以下信息，以连接数据库。

在 Connection 栏，填写数据库连接信息。


配置项	说明
Host URL	填写数据库服务器的 IP 地址/域名及端口。
Database name	填写数据库名称。

在 Authentication 栏，填写认证信息。


配置项	说明
Username	填写用于连接数据库的用户名。
Password	填写用于连接数据库的密码。

在浏览器的地址栏，复制 UID (URL 的最后一段)。
在本例中，获取的值为 bfkbvupmpwe0wb。
下载并更新仪表盘 JSON 模板。
1. 下载并解压仪表盘模板压缩包。该压缩包包含适用于不同数据库的模板，请根据数据库类型选择合适的模板。
  在本例中，我们将使用 PostgreSQL 的模板。
2. 将每个面板中 datasource 下的所有 uid 值替换为获取到的值。
  
  注：保持 annotations 和 dashboard 中的 uid 值不变。
3. 可选： 按需修改 title 值，该值将用作 Grafana 中的仪表板名称。
将仪表盘模板导入到 Grafana。
1. 在左侧导航栏，进入 Dashboards。
2. 在页面右上角，点击，选择 Import dashboard。
3. 点击 Upload dashboard JSON file，上传 .json 文件。
4. 点击 Import。

仪表盘已成功导入，可在仪表盘中查看和分析数据。

按需添加或修改 SQL 查询语句，以自定义要展示的数据。

注：由于 Grafana 不支持在单个数据源中执行组合查询，因此 Yeastar 提供的仪表盘模板仅支持展示以下通话报告数据。

如需展示其他报告，可参考基于多条 SQL 查询的通话报告计算逻辑了解各报告的数据逻辑，并按需添加 SQL 查询语句。