跳转至

Vertica 集成 Grafana 连接指南

1. 关于 Vertica 连接指南

Vertica 连接指南提供了将第三方合作伙伴产品连接到 Vertica 的基本说明。连接指南基于我们在特定版本的 Vertica 和合作伙伴产品上的测试。

2. Vertica 与 Grafana：测试版本

软件 版本
Grafana 服务器 10.4 本地实例
Grafana 服务器平台 RHEL 8.6
桌面客户端 Windows 10
Vertica-Grafana-Datasource 插件 3.0.0
Vertica 服务器 23.4

3. Grafana 概述

Grafana 允许您查询、可视化、设置警报并了解您的指标，无论它们存储在哪里。与您的团队一起创建、探索和共享仪表板，培养数据驱动型文化。

要了解更多关于新增强和功能更新的信息，请参阅 Release Notes 和 vertica-grafana-datasource GitHub 页面中的 README.md。

4. 安装 Grafana

安装 Grafana 的步骤：

  1. 前往 Grafana 下载页面 创建账号。 您可以选择注册 Grafana Cloud 或自管理账户。
  2. 从 https://grafana.com/grafana/download 下载 Grafana。 您可以从下拉列表中选择所需的版本。
  3. 按照 Grafana 文档 进行安装和配置。
  4. 启动 Grafana 服务器，确保可以通过浏览器访问。

Grafana Download Page

5. 安装 Vertica-Grafana-datasource 插件

对于非开发环境安装：

  1. 前往 https://grafana.com/grafana/plugins/vertica-grafana-datasource。
  2. 点击 Installation 选项卡并按照说明操作。提供了在本地 Grafana 实例和托管 Grafana 实例上安装的选项。
  3. 安装配置完成后，重启 Grafana 服务器。

6. 将 Grafana 连接到 Vertica

  1. 使用管理员凭据登录 Grafana。
  2. 在左侧工具栏中，悬停在齿轮图标上打开配置菜单，然后点击 Plugins。

  3. 在搜索栏中输入 Vertica 进行搜索。 Grafana Plugin Search

  4. 点击 Vertica 插件，然后点击 Install。 Grafana Plugin Install

  5. 点击 Add new data source。

  6. 输入数据源详情，点击 Save and Test。将显示连接成功消息。 Grafana Datasource Config

  7. 测试通过连接可视化数据的能力：

  8. a. 点击左上角的 Home。

  9. b. 点击 + 图标并选择 Dashboard 以创建新仪表板。

  10. c. 点击 Add Query。

  11. 屏幕将刷新为带有图表面板和预定义 Vertica SQL 查询的新仪表板。图表在一两秒内填充数据，确认可以从 Vertica 获取数据。 Grafana Dashboard Query

  12. 接下来，您可以按照 Grafana 文档 了解如何构建和格式化可视化。

7. 故障排查

如果 Vertica 插件未显示在插件屏幕中，请搜索 /var/log/grafana/grafana.log 文件中的 "Starting Vertica datasource plugin" 并从该位置向下查看。它应该会提供有关插件查找路径以及查找和加载 Vertica 插件的详细信息。

以下是一组显示成功加载的简短日志条目：

t=2023-04-02T11:57:10-0400 lvl=info msg="Starting Vertica datasource plugin" logger=plugins.backend pluginId=vertica-grafana-datasource
t=2023-04-02T11:57:10-0400 lvl=info msg="Registering plugin" logger=plugins id=vertica-grafana-datasource
t=2023-04-02T11:57:35-0400 lvl=info msg="Request Completed" logger=context userId=1 orgId=1 uname=admin method=GET path="/public/img/icons/unicons/icon-gf icon-gf-panel.svg" remote_addr=10.100.246.86 time_ms=13 size=41965 referer=http://10.20.71.85:3000/plugins/vertica-grafana-datasource/

8. 已知限制

  • BINARY、VARBINARY 和 LONG VARBINARY 数据类型无法正确显示。值以十六进制格式显示。
  • DOUBLE 和 DECIMAL 数据类型，数值会被四舍五入。
  • DATE、TIME 和 TIMETZ 数据类型，显示不正确的值。
  • TIMESTAMP 和 TIMESTAMPTZ 数据类型，数值显示不正确。超过 3 位的毫秒部分被截断。

扩展阅读