Amazon Aurora 数据源

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

简介

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

要求

此插件专为 Grafana 9.4.7 及以上版本的企业版设计，但也可能适用于旧版本。

此插件使用带有 AWS SDK for Go 的 IAM 连接到 AWS Aurora 集群。请通读 AWS 的 “使用 IAM 身份验证和 AWS SDK for Go 连接到数据库集群”指南的先决条件部分，以确保 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 生成身份验证令牌
2. 使用该令牌和您的端点打开与 DSN 的连接。

通常，这两个步骤的端点是相同的。但是，如果您的数据库集群位于负载均衡器之后，您可能需要 2 个单独的端点。对于第一步，您需要指定负载均衡器后面的端点。对于第二步，您需要为打开的 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

查询

表格与时间序列

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

为了更好地解释这个概念，请考虑如下所示的表格

当我们使用时间序列可视化呈现相同的查询时，我们会注意到“neighborhood”和“city”字段折叠成 1 个时间序列

这通常是 SQL 数据源的期望行为，尤其是在使用表格可视化时。但是，有时您可能希望为每个城市/社区组合呈现单独的时间序列。为此，请在“Format data frames as”下拉列表中选择“Time series”，这将像这样呈现相同的时间序列可视化

当使用 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)

如果您对 aurora 数据源独有的宏有任何建议，请随时联系客户支持。