文档 插件 Grafana 的 DynamoDB 数据源

Grafana 的 DynamoDB 数据源

DynamoDB 数据源允许直接连接到 DynamoDB，以便在 Grafana 中查询和可视化 DynamoDB 数据。

此数据源支持 PartiQL，并提供一个编辑器来格式化和颜色编码你的 PartiQL 语句。

DynamoDB 插件适用于以下账户类型

• 拥有 Grafana Cloud 免费、高级或试用账户的用户，或拥有已激活的 Grafana Enterprise 许可证的用户。

安装

有关如何在 Grafana Cloud 或本地安装插件的详细说明，请查阅插件安装文档。

手动配置

在你的 Grafana 实例上安装插件后，请按照这些说明添加新的 DynamoDB 数据源，并输入配置选项。

配置选项

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

使用预置文件配置数据源

可以使用配置文件通过 Grafana 的预置系统配置数据源。要了解其工作原理，包括可以为此数据源设置的所有设置，请参阅预置 Grafana 数据源。

以下是使用基本身份验证为此数据源提供的一些预置示例

yaml 复制

apiVersion: 1
datasources:
  - name: DynamoDB
    type: grafana-dynamodb-datasource
    jsonData:
      authType: keys
      endpoint: local/remote endpoint
      defaultRegion: us-west-2
      migrated: true
    secureJsonData:
      accessKey: <YOUR ACCESS KEY>
      secretKey: <YOUR SECRET KEY>

或对于 ~/.aws/credentials

yaml 复制

apiVersion: 1
datasources:
  - name: DynamoDB
    type: grafana-dynamodb-datasource
    jsonData:
      authType: credentials
      endpoint: local/remote endpoint
      profile: <YOUR PROFILE>
      defaultRegion: us-west-2
      migrated: true
    secureJsonData:

时间序列

添加 datetime 字段类型到你的查询后，可以选择时间序列可视化选项。此字段将用作时间戳。你可以使用可视化选项选择时间序列可视化。Grafana 将没有明确时区的时间戳行解释为 UTC。除了 time 之外的任何列都被视为值列。

多行时间序列

要创建多行时间序列，查询必须按以下顺序返回至少 3 个字段

• 字段 1：带别名 time 的 datetime 字段
• 字段 2：用于分组的值
• 字段 3+：指标值

例如

sql 复制

SELECT log_time AS time, machine_group, avg(disk_free) AS avg_disk_free
FROM mgbench.logs1
GROUP BY machine_group, log_time
ORDER BY log_time

模板和变量

要添加新的 DynamoDB 查询变量，请参阅添加查询变量。

创建变量后，你可以使用变量语法在 DynamoDB 查询中使用它。有关变量的更多信息，请参阅模板和变量。

已知限制

当前不支持查询嵌套 map 中的数据，并且将返回 null 值。

了解更多

• 添加注释。
• 配置和使用模板和变量。
• 添加转换。
• 设置警报；请参阅警报概览。