从 Grafana 市场部署 3CX Grafana 可视化报表

介绍

3CX Grafana 可视化组件已在 Grafana 市场上架，让您能够快速、轻松地部署预构建的 3CX 仪表板。本指南适用于 3CX 版本 20 Update 7（SP7）及更高版本。

数据连接器（Data Connectors）功能需要 16SC 或更高级别的许可证。

先决条件

在部署 3CX Grafana 插件之前，请确保已完成以下配置：

  • 一个可用的数据连接器（请参阅相关指南）：
  • 已为计划在 Grafana 中可视化的指标启用了数据传输选项（例如，通话记录 (CDR)、系统指标等）。

步骤 1：注册 Grafana

  • 访问 Grafana 并注册一个新帐户（支持任何级别，包括免费计划）。
  • 如果要创建新帐户，请设置您的Grafana Stack- 这将是托管您的仪表盘的基本 URL。

步骤 2：添加您的 3CX 数据源

本例中，我们将使用 MySQL。对于其他数据库，请参阅相关的数据连接器文档。

  • 从 Grafana “首页”展开“连接 (Connections)”，然后选择“添加新连接 (Add new connection)”。

  • 选择 “MySQL 数据源 (MySQL Datasource)”（或您选择的连接器类型）。

  • 选择“添加新数据源 (Add new data source)”。

  • 为您的数据库连接命名并填写所有相关详细信息，然后选择“保存并测试 (Save & Test)”以确认连接。
  • 您应使用一个对 3CX 表仅具有 SELECT 权限的数据库用户。

您可能希望通过在此处使用 Grafana 提供的允许列表 IP (Allow-List IPs) 来进一步限制对数据库的访问。

步骤 3：安装插件

  • 从 Grafana 首页导航至 管理 (Administration) > 插件和数据 (Plugins and data) > 插件 (Plugins)，进入插件市场。

  • 在 3CX 插件页面上，点击“安装 (Install)”。

  • 安装完成后（几秒到几分钟），会出现“启用 (Enable)”按钮。可能需要刷新页面。
  • 按钮出现后，点击它。

  • 页面将刷新，并在“更多应用 (More Apps)”下出现一个新的“3CX (& 配置)”选项。
  • 进入“配置 (Configuration)”，选择之前创建的数据源。如果选择了兼容的数据源，会出现一个绿色对勾，“发布仪表板 (Publish dashboards)”选项将变为可用。
  • 点击此选项以继续。

步骤 4：查看仪表盘

  • 页面应自动刷新，并在 3CX 应用下打开仪表板列表。

  • 这些仪表板现在也会出现在主仪表板部分下的一个名为 “3CX” 的文件夹中。

  • 点击任意一个仪表板，即可立即加载可用数据并开始显示。

步骤 5：多系统部署和定制

如果您希望监控同一 Grafana 堆栈（域）中的多个 3CX 实例，或对提供的模板进行自定义，可以使用导出功能创建副本。该功能位于每个仪表盘视图的顶部。

然后您可以从主仪表盘面板导入它们。系统会要求您为该仪表盘在您的堆栈中选择一个新的唯一标识符，以及要连接的数据库（与原始部署类型相同）。

步骤 6：发出警报

Grafana 允许您为所有跟踪的指标设置警报触发器。例如，以下是如何添加 CPU 使用率过高警报的方法。

  • 在“健康与性能 (Health and Performance)”仪表板内，从“＋”菜单中选择“新建告警规则 (New alert rule)”。

  • 为您的警报命名，并定义要监控的基本参数。

  • 继续完成后续步骤，配置告警的各种元参数，例如文件夹 (Folders)、标签 (Tags)，以及告警接收者、文本和运行手册 (Runbook) URL。

另请参阅

最后更新时间

本文件最后更新日期为2026年1月15日。

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