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 连接到您的数据库集群”指南中的先决条件部分，了解如何使用 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进行两次调用

1. 使用端点生成RDS的认证令牌
2. 使用该令牌和您的端点打开DSN连接。

通常这两个步骤的端点是相同的。但是，如果您将DB集群放在负载均衡器后面，您可能需要两个单独的端点。对于第一个步骤，您需要指定负载均衡器后面的端点。对于第二个步骤，您需要指定用于打开SQL连接的负载均衡器端点。为了让Grafana代表您完成此操作，请在“认证数据库主机”和“认证数据库端口”中指定负载均衡器后面的端点，并使用上面的负载均衡器端点/端口配置字段。

已配置的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

查询

表与时间序列

与其他SQL数据源插件类似，在Grafana中查询时，您可以指定是否将数据作为“宽”或“长”时间序列返回。这由“格式”下拉菜单控制。

为了更好地解释这个概念，考虑以下表格

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

这通常是SQL数据源所期望和期望的行为，尤其是在使用表格可视化时。然而，有时您可能希望为每个城市/社区组合渲染不同的时间序列。要做到这一点，在“格式为”下拉菜单中选择“时间序列”，将呈现相同的时间序列可视化，如下所示

当使用探索时，Grafana会在您更改格式时自动使用适当的时间序列或表格可视化。在仪表板的查询编辑器中，用户控制数据可视化的方式。

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

变量和宏

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

select * from $tableName limit 3;

{{< 注解类型="note" >变量与Grafana警报不兼容。{{ /注解 >}}

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

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

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