集成 Grafana 和 Timescale Cloud

登录 Grafana

在您的浏览器中，登录以下任一选项

• 自托管 Grafana：在 http://localhost:3000/。默认凭据是 admin, admin。
• Grafana Cloud：使用您创建账户时设置的 URL 和凭据。

添加您的服务作为数据源

1. 打开 Connections > Data sources，然后点击 Add new data source。

2. 从列表中选择 PostgreSQL。

3. 配置连接

   • 主机 URL、数据库名称、用户名 和 密码

     使用您的 连接详情 进行配置。主机 URL 格式为 <host>:<port>。

   • TLS/SSL 模式：选择 require。

   • PostgreSQL 选项：启用 TimescaleDB。

   • 其他所有字段保留默认设置。

4. 点击 保存并测试。

   Grafana 检查您的详情是否设置正确。

在 仪表盘 页面上，点击 新建 并选择 新仪表盘

点击 添加可视化

选择数据源

从预配置数据源列表中选择您的服务或配置一个新的数据源。

配置您的面板

选择可视化类型。此类型定义了除面板名称等标准字段之外需要配置的特定字段。

运行您的查询

您可以直接编辑查询或使用内置查询编辑器。如果您正在可视化时序数据，请在 格式 下拉列表中选择 时序。

点击 保存仪表盘

您现在拥有一个带有一个面板的仪表盘。通过点击右上角的 添加 并从下拉列表中选择 可视化，可以向仪表盘添加更多面板。

调用 $__timefilter() 将 Grafana 面板中的用户界面构造与查询链接起来

例如，将 pickup_datetime 列设置为可视化的筛选范围

SELECT
  --1--
  time_bucket('1 day', pickup_datetime) AS "time",
  --2--
  COUNT(*)
FROM rides
WHERE $__timeFilter(pickup_datetime)

复制

对可视化进行分组并按 时间桶 排序结果

在本例中，GROUP BY 和 ORDER BY 语句引用了 time。

例如

SELECT
  --1--
  time_bucket('1 day', pickup_datetime) AS time,
  --2--
  COUNT(*)
FROM rides
WHERE $__timeFilter(pickup_datetime)
GROUP BY time
ORDER BY time

复制

当您在 Grafana 中可视化此查询时，您会看到如下内容

展开图片

您可以调整 time_bucket 函数并比较图表

SELECT
  --1--
  time_bucket('5m', pickup_datetime) AS time,
  --2--
  COUNT(*)
FROM rides
WHERE $__timeFilter(pickup_datetime)
GROUP BY time
ORDER BY time

复制

当您可视化此查询时，它看起来像这样

展开图片

添加地理空间可视化

1. 在您的 Grafana 仪表盘中，点击 添加 > 可视化。

2. 在右上角的可视化类型下拉菜单中选择 Geomap。

配置数据格式

1. 在下方 查询 选项卡中，选择您的数据源。

2. 在 格式 下拉菜单中，选择 表格。

3. 在模式切换器中，切换到 代码 并输入查询，然后点击 运行。

   例如

   SELECT time_bucket('5m', rides.pickup_datetime) AS time,
          rides.trip_distance AS value,
          rides.pickup_latitude AS latitude,
          rides.pickup_longitude AS longitude
   FROM rides
   WHERE rides.trip_distance > 5
   GROUP BY time,
            rides.trip_distance,
            rides.pickup_latitude,
            rides.pickup_longitude
   ORDER BY time
   LIMIT 500;

   复制

自定义 Geomap 设置

在默认设置下，可视化使用固定大小的绿色圆圈。为了获得更具代表性的视图，至少配置以下项

• 地图图层 > 样式 > 大小 > 值。

  这将根据值改变圆圈的大小，更大的圆圈代表更大的值。

• 地图图层 > 样式 > 颜色 > 值。

• 阈值 > 添加 阈值。

  添加 7 和 10 的阈值，分别用不同颜色标记超过 7 英里和 10 英里的行程。

您现在有一个看起来像这样的可视化

展开图片