通过向导连接到预构建数据来源 - Amazon CloudWatch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

通过向导连接到预构建数据来源

本主题提供通过向导将 CloudWatch 连接到以下数据来源的说明。

  • Amazon OpenSearch Service

  • Amazon Managed Service for Prometheus

  • Amazon RDS for MySQL

  • Amazon RDS for PostgreSQL

  • Amazon S3 CSV 文件

  • Microsoft Azure 监测仪

  • Prometheus

本节后面将介绍一些小节,其中包含有关管理和查询这些数据来源的说明。

创建数据来源连接器。
  1. 访问 https://console.aws.amazon.com/cloudwatch/ 打开 CloudWatch 控制台。

  2. 在导航窗格中,选择设置

  3. 选择指标数据来源选项卡。

  4. 选择创建数据源

  5. 选择所需的来源,然后选择下一步

  6. 输入数据源的名称。

  7. 根据所选择的数据来源,输入其他必填信息。这些信息可能包括用于访问数据来源的凭证和数据来源标识信息,例如 Prometheus 工作区名称、数据库名称或 Amazon S3 存储桶名称。关于 Amazon 服务,向导会发现资源并将其填充到选择下拉列表中。

    有关您正在使用的数据来源的更多说明,请参阅此过程之后的部分。

  8. 要将 CloudWatch 连接到 VPC 中的数据来源,请选择使用 VPC,然后选择要使用的 VPC。然后选择子网和安全组。

  9. 选择我确认 Amazon CloudFormation 会创建 IAM 资源。此资源是 Lambda 函数执行角色。

  10. 选择创建数据源

    Amazon CloudFormation 堆栈完成创建新来源之后,您刚刚添加的新来源才会出现。要查看进度,可以选择查看我的 CloudFormation 堆栈的状态。您也可以通过刷新图标来更新此列表。

    新数据来源出现在此列表中时即可使用。您可以选择从 CloudWatch 指标中查询,以开始使用其查询。有关更多信息,请参阅 创建源自另一个数据来源的指标图表

Amazon Managed Service for Prometheus

更新数据来源配置

  • 您可通过以下步骤手动更新数据来源:

    • 要更新 Amazon Managed Service for Prometheus 工作区 ID,请更新数据来源连接器 Lambda 函数的 AMAZON_PROMETHEUS_WORKSPACE_ID 环境变量。

    • 要更新 VPC 配置,请参阅配置 VPC 访问(控制台)了解更多信息。

查询数据来源

  • 查询 Amazon Managed Service for Prometheus 时,在多来源查询选项卡中选择数据来源并选择一个 Amazon Managed Service for Prometheus 连接器后,您可以通过查询助手来发现指标和标签并提供简单的 PromQL 查询。您也可以使用 PromQL 查询编辑器来构建 PromQL 查询。

  • CloudWatch 数据来源连接器不支持多行查询。执行查询,或者使用查询创建警报或控制面板小组件时,每个换行符都会替换为空格。在某些情况下,这可能会导致查询无效。例如,如果您的查询包含单行注释,则该查询无效。如果您尝试利用命令行或基础设施即代码中的多行查询来创建控制面板或警报,API 将拒绝该操作,并显示解析错误。

Amazon OpenSearch Service

创建数据来源

您必须将连接器 Lambda 函数的执行角色映射到 OpenSearch Service 中的用户。有关更多信息,请参阅 OpenSearch Service 文档管理权限中的将角色映射到用户部分。

更新数据来源

  • 您可通过以下步骤手动更新数据来源:

    • 要更新 OpenSearch Service 域,请更新数据来源连接器 Lambda 函数的 AMAZON_OPENSEARCH_DOMAIN_NAME 环境变量。

    • 要更新 VPC 配置,请参阅配置 VPC 访问(控制台)了解更多信息。

查询数据来源

  • 查询 OpenSearch Service 时,在多来源查询选项卡中选择数据来源后,请执行以下操作:

    • 选择要查询的索引。

    • 选择指标名称(文档中的任何数值字段)和统计数据。

    • 选择时间轴(文档中的任何日期字段)。

    • 选择要应用的筛选条件(文档中的任意字符串字段)。

    • 选择图表查询

Amazon RDS for PostgreSQL 和 Amazon RDS for MySQL

创建数据来源

更新数据来源

  • 您可通过以下步骤手动更新数据来源:

    • 要更新数据库实例,请更新数据来源连接器 Lambda 函数的 RDS_INSTANCE 环境变量。

    • 要更新用于连接 Amazon RDS 的用户名和密码,请使用 Amazon Secrets Manager。您可以在数据来源 Lambda 函数的 RDS_SECRET 环境变量中找到用于数据来源的密钥的 ARN。有关更新 Amazon Secrets Manager 中的密钥的更多信息,请参阅修改 Amazon Secrets Manager 密钥

    • 要更新 VPC 配置,请参阅配置 VPC 访问(控制台)了解更多信息。

查询数据来源

  • 查询 Amazon RDS 时,在多来源查询选项卡中选择数据来源并选择 Amazon RDS 连接器后,即可使用数据库发现器查看可用的数据库、表和列。您还可以使用 SQL 编辑器创建 SQL 查询。

    您可以在查询中使用以下变量:

    • $start.iso:ISO 日期格式的开始时间

    • $end.iso:ISO 日期格式的结束时间

    • $period:选定时段(以秒为单位)

    例如,您可以查询 SELECT value, timestamp FROM table WHERE timestamp BETWEEN $start.iso and $end.iso

  • CloudWatch 数据来源连接器不支持多行查询。执行查询,或者使用查询创建警报或控制面板小组件时,每个换行符都会替换为空格。在某些情况下,这可能会导致查询无效。例如,如果您的查询包含单行注释,则该查询无效。如果您尝试利用命令行或基础设施即代码中的多行查询来创建控制面板或警报,API 将拒绝该操作,并显示解析错误。

注意

如果在结果中找不到日期字段,则将每个数值字段的值相加为单个值,并绘制在所提供的时间范围内。如果时间戳与 CloudWatch 中的选定时段不一致,则会使用 SUM 自动聚合数据,且数据与 CloudWatch 中的时段保持一致。

Amazon S3 CSV 文件

查询数据来源

  • 查询 Amazon S3 CSV 文件时,在多来源查询选项卡中选择数据来源并选择 Amazon S3 连接器后,即可选择 Amazon S3 存储桶和键。

    CSV 文件的格式必须将 Timestamp 作为 ISO 日期格式,且指标为数值字段。CSV 文件还必须有一个标题行。该标题用于命名您的指标。

    Timestamp, Metric-1, Metric-2, ...

    以下是 示例:

    timestamp CPU(%) 内存(%) 存储(%)

    2023-11-23T17:09:41+00:00

    1

    2

    3

    2023-11-23T17:04:41+00:00

    4

    5

    6

    2023-11-23T16:59:41+00:00

    7

    8

    9

    2023-11-23T16:54:41+00:00

    10

    11

    12

注意

如果未提供时间戳,则将每个指标的值相加为单个值,并绘制在所提供的时间范围内。如果时间戳与 CloudWatch 中的选定时段不一致,则会使用 SUM 自动聚合数据,且数据与 CloudWatch 中的时段保持一致。

Microsoft Azure 监测仪

创建数据来源

更新数据来源

  • 您可通过以下步骤手动更新数据来源:

    • 要更新用于连接到 Azure 监测仪的租户 ID、客户端 ID 和客户端密钥,可以在数据来源 Lambda 函数中找到作为 AZURE_CLIENT_SECRET 环境变量用于数据来源的密钥的 ARN。有关更新 Amazon Secrets Manager 中的密钥的更多信息,请参阅修改 Amazon Secrets Manager 密钥

查询数据来源

  • 查询 Azure 监测仪时,在多来源查询选项卡中选择数据来源并选择 Azure 监测仪连接器后,即可指定 Azure 订阅以及资源组和资源。然后,您可以选择指标命名空间、指标和聚合,并按维度进行筛选。

Prometheus

创建数据来源

  • 您必须提供 Prometheus 端点以及查询 Prometheus 所需的用户名和密码。凭证将存储于 Amazon Secrets Manager 内。

  • 如果数据来源只能在 VPC 中访问,则连接器必须包含 VPC 配置,如 通过向导连接到预构建数据来源 中所述。如果数据来源要连接到 VPC 以获取凭证,则必须在 VPC 中配置端点。有关更多信息,请参阅使用 Amazon Secrets Manager VPC 端点

更新数据来源配置

  • 您可通过以下步骤手动更新数据来源:

    • 要更新 Prometheus 端点,请将新的端点指定为数据来源 Lambda 函数上的 PROMETHEUS_API_ENDPOINT 环境变量。

    • 要更新用于连接 Prometheus 的用户名和密码,可以在数据来源 Lambda 函数中找到作为 PROMETHEUS_API_SECRET 环境变量用于数据来源的密钥的 ARN。有关更新 Amazon Secrets Manager 中的密钥的更多信息,请参阅修改 Amazon Secrets Manager 密钥

    • 要更新 VPC 配置,请参阅配置 VPC 访问(控制台)了解更多信息。

查询数据来源

重要

Prometheus 指标类型与 CloudWatch 指标不同,Prometheus 提供的许多指标都是有意累积的。当您查询 Prometheus 指标时,CloudWatch 不会对数据进行任何其他转换:如果您仅指定指标名称或标签,则将显示累积的值。有关更多信息,请参阅 Prometheus 文档中的指标类型

要将 Prometheus 指标(例如 CloudWatch 指标)数据视为离散值,则需要在运行查询之前对其进行编辑。例如,您可能需要向 Prometheus 指标名称添加对比率函数的调用。有关比率函数和其他 Prometheus 函数的文档,请参阅 Prometheus 文档中的 rate()

CloudWatch 数据来源连接器不支持多行查询。执行查询,或者使用查询创建警报或控制面板小组件时,每个换行符都会替换为空格。在某些情况下,这可能会导致查询无效。例如,如果您的查询包含单行注释,则该查询无效。如果您尝试利用命令行或基础设施即代码中的多行查询来创建控制面板或警报,API 将拒绝该操作,并显示解析错误。

可用更新的通知

Amazon 可能会不时通知,推荐您将连接器更新为较新的可用版本,并会提供操作说明。