文档 插件 Grafana Zabbix 插件 配置

配置

启用插件

进入 Grafana 侧边面板中的插件页面，选择 Apps 选项卡，然后选择 Zabbix，打开 Config 选项卡并启用插件。

配置 Zabbix 数据源

启用插件后，您可以添加 Zabbix 数据源。

要添加新的 Zabbix 数据源，打开侧边面板中的 Data Sources，点击 Add data source 并从下拉列表中选择 Zabbix。

HTTP 设置

• URL：设置 Zabbix API URL（包含 api_jsonrpc.php 的完整路径）。
• 访问：设置为 Server (default)。
• Http 身份验证：如果您使用代理身份验证，请配置此项。
  • 基本身份验证:
  • 使用凭据:

Zabbix API 详情

• 用户名和密码：设置访问 Zabbix API 的登录凭据。如果您无法在 Grafana 中获取任何组和主机，请检查 Zabbix 中的用户权限。
• 趋势：如果您使用 Zabbix 3.x 或更高版本，请启用此项。强烈建议在显示长时间段数据时启用此选项（超过几天，具体取决于您在 Zabbix 中项目的更新间隔），因为几天内的项目历史记录包含大量点。使用趋势将提高 Grafana 的性能。
  • 之后：趋势开始使用的时间。最佳实践是将其值设置为您的历史数据存储周期（7天、30天等）。默认值为 7d (7 天)。您可以使用 Grafana 格式设置时间。有效的时间指定符包括
    • h - 小时
    • d - 天
    • M - 月
  • 范围：趋势代替历史数据开始使用的时间范围宽度。最好将此值设置为 4 到 7 天之间，以防止加载大量历史数据。默认值为 4 天。
• 缓存 TTL：插件会缓存一些 API 请求以提高性能。将此值设置为所需的缓存生命周期（此选项会影响项目列表等数据）。
• 超时：Zabbix 连接超时时间，单位为秒。默认值为 30。

直接数据库连接

直接数据库连接允许插件使用现有的 SQL 数据源直接从 Zabbix 数据库查询历史数据。这种方式通常比从 Zabbix API 拉取数据更快，尤其是在时间范围较大时，并且可以减少数据传输量。

阅读 如何在 Grafana 中配置 SQL 数据源。

• 启用：启用直接数据库连接。
• 数据源：为 Zabbix 历史数据库选择数据源。
• 保留策略（仅限 InfluxDB）：指定用于获取长期存储数据的保留策略名称。如果查询时间范围适合趋势查询，Grafana 将从该保留策略中获取数据。如果仅使用默认保留策略，请留空。

支持的数据库

MySQL、PostgreSQL、InfluxDB 支持作为插件历史数据来源。

其他

• 禁用只读用户确认问题：禁用非编辑者从 Grafana 确认问题的能力。

• 禁用数据对齐：禁用时间序列数据对齐。此功能根据项目更新间隔对齐点。例如，如果每分钟收集一次值，则每个点的时间戳将被设置为相应分钟的开始。此对齐对于堆叠图的正常工作是必需的。如果您不需要堆叠图，并且希望获得与 Zabbix 中完全相同的时间戳，则可以禁用此功能。此外，可以在查询选项中为每个查询单独切换数据对齐。

然后点击 Add - 将添加数据源，您可以使用 Test Connection 按钮检查连接。此功能有助于发现一些错误，例如无效的用户名或密码，错误的 API URL。

导入示例仪表盘

您可以从数据源配置中的 Dashboards 选项卡导入示例仪表盘。

关于浏览器缓存的注意事项

更新插件后，请清除浏览器缓存并重新加载应用程序页面。详情请参见 Chrome、Firefox。您只需要清除缓存，无需清除 Cookie、历史记录和其他数据。