Amazon Aurora 数据源

使用 Grafana 查询和可视化来自 AWS Aurora 的数据。此数据源插件目前处于 公共预览 阶段。

简介

使用 Amazon Aurora 数据源，你可以轻松查询和可视化 Amazon Aurora 中的数据。此插件目前支持与 MySQL 兼容和与 Postgres 兼容的 Aurora 引擎。

要求

此插件专为 Grafana 9.4.7 及更高版本的 Enterprise 版本设计，但也可能适用于旧版本。

此插件使用 AWS SDK for go 和 IAM 连接到 AWS Aurora 集群。请阅读 AWS 的“使用 IAM 身份验证和 AWS SDK for Go 连接到 DB 集群”指南中的前提条件部分，了解如何使用 IAM 连接到你的数据库集群，以确保 Grafana 能够查询你的集群。

权限示例

作为上述内容的一部分，请确保你用于查询 Aurora 的用户/角色具有适当的权限。例如

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Effect": "Allow",
         "Action": [
             "rds-db:connect"
         ],
         "Resource": [
             "arn:aws:rds-db:us-east-2:1234567890:dbuser:cluster-ABCDEFGHIJKL01234/db_user"
         ]
      }
   ]
}

有关更多信息，请阅读 AWS 文档

开始使用

1. 安装插件
2. 使用 UI 添加新数据源 或 预置一个
3. 配置数据源
4. 开始进行查询

配置选项

Amazon Aurora 数据源使用 AWS SDK for Go 通过 AWS IAM 凭证连接到你的数据库集群。有几种可能的方式来配置 Grafana 中的数据源实例，以指定如何连接到 AWS

高级设置

为了连接到你的集群，Grafana 进行 2 次调用

1. 使用端点通过 RDS 生成 Auth Token
2. 使用该 Token 和你的端点打开到 DSN 的连接。

通常，这两个步骤的端点是相同的。但是，如果你的数据库集群位于负载均衡器后面，你可能需要两个独立的端点。对于第一步，你需要指定负载均衡器后面的端点。对于第二步，你需要为开放的 SQL 连接指定负载均衡器端点。要让 Grafana 代表你执行此操作，请在 DB Host for Auth 和 DB Port for Auth 中指定负载均衡器后面的端点，并使用上面的负载均衡器端点/端口配置字段。

预置 Aurora 数据源示例

如果你正在预置数据源，可以使用 YAML 文件设置所有上述配置选项。这是一个示例文件内容

  - name: AWS Aurora with mysql behind a load balancer
    type: grafana-aurora-datasource
    editable: true
    jsonData:
      engine: 'aurora-mysql'
      authType: keys
      dbName: 'testDatabase'
      dbUser: 'dbuser'
      dbHost: 'aurora-mysql.cluster-123.us-east-1.rds.amazonaws.com'
      dbPort: 3306
      defaultRegion: 'us-east-1'
    secureJsonData:
      accessKey: someAccessKey
      secretKey: someSecretKey
    version: 1

这是另一个带有负载均衡器的示例

  - name: AWS Aurora with mysql behind a load balancer
    type: grafana-aurora-datasource
    editable: true
    jsonData:
      engine: 'aurora-mysql'
      authType: keys
      dbName: 'testDatabase'
      dbUser: 'dbuser'
      dbHost: 'protectedByALoadBalancer.example.com'
      dbPort: 3307
      defaultRegion: 'us-east-1'
      dbPortAuth: 3306
      dbHostAuth 'aurora-mysql.cluster-123.us-east-1.rds.amazonaws.com'
    secureJsonData:
      accessKey: someAccessKey
      secretKey: someSecretKey
    version: 1

查询

表格 vs 时间序列

与 Grafana 中的其他 SQL 数据源插件一样，你可以指定在查询时将数据作为“宽”或“长”时间序列返回。这由 Format data frames as 下拉菜单控制。

为了更好地解释这个概念，考虑一个像这样的表格

当我们使用时间序列可视化渲染相同的查询时，会注意到“neighborhood”和“city”字段合并成一个时间序列

这通常是 SQL 数据源期望的行为，尤其是在使用表格可视化时。但是，有时你可能希望为每个城市/neighborhood 组合渲染单独的时间序列。为此，在“Format data frames as”下拉菜单中选择“时间序列”，它将渲染相同的时序可视化，如下所示

使用 Explore 时，Grafana 会在你更改格式时自动使用适当的时间序列或表格可视化来渲染数据。在仪表盘的查询编辑器中，用户可以控制如何可视化数据。

要了解更多信息，请参阅 Grafana 文档时间序列格式。

变量和宏

此插件支持自定义变量和全局变量，以简化查询编写。例如，如果你设置一个自定义变量为 $tableName，你可以在仪表盘中跨多个表格使用相同的查询

select * from $tableName limit 3;

{{< admonition type="note" }} 变量不适用于 Grafana 告警。 {{ /admonition >}}

此插件还支持来自 sql util 库的宏，例如 $__timeFrom 和 $__timeTo。例如

select * from test_table where $__timeFrom(recorded_at) and $__timeTo(recorded_at)

如果你对 Amazon Aurora 数据源特有的宏有建议，请随时联系客户支持。