使用 Performance Insights API for Amazon RDS 检索指标 - Amazon Relational Database Service

使用 Performance Insights API for Amazon RDS 检索指标

开启性能详情后,API 将提供实例性能的可见性。Amazon CloudWatch Logs 日志为AWS服务提供售卖监控指标的权威源。

Performance Insights 提供了按平均活动会话 (AAS) 衡量的数据库负载的特定于域的视图。对 API 使用者而言,此指标看起来像是二维时间序列数据集。数据的时间维度提供所查询时间范围的每个时间点的数据库负载数据。每个时间点将分解与所请求维度相关的整体负载,如相应时间点测量的 SQLWait-eventUserHost

Amazon RDS Performance Insights 用于监控您的 Amazon RDS 数据库实例,使您可以分析数据库性能和排查数据库性能问题。查看 Performance Insights 数据的一种方法是在 AWS Management Console中。Performance Insights 还提供公有 API,以便您可以查询自己的数据。您可以使用 API 来执行以下操作:

  • 将数据卸载到数据库中

  • 将 Performance Insights 数据添加到现有监控控制面板

  • 构建监控工具

要使用 Performance Insights API,请在您的 Amazon RDS 数据库实例之一上启用 Performance Insights。有关启用 Performance Insights 的信息,请参阅 为 Amazon RDS 打开和关闭 Performance Insights。有关 Performance Insights API 的更多信息,请参阅 Amazon RDS Performance Insights API 参考

Performance Insights API 提供以下操作。

Performance Insights 操作

AWS CLI command

描述

CreatePerformanceAnalysisReport

aws pi create-performance-analysis-report

为数据库实例创建特定时间段的性能分析报告。结果为 AnalysisReportId,这是报告的唯一标识符。

DeletePerformanceAnalysisReport

aws pi delete-performance-analysis-report

删除性能分析报告。

DescribeDimensionKeys

aws pi describe-dimension-keys

对于特定的时间段,检索指标的前 N 个维度键。

GetDimensionKeyDetails

aws pi get-dimension-key-details

检索数据库实例或数据源的指定维度组的属性。例如,如果您指定了 SQL ID,并且有维度详细信息,则 GetDimensionKeyDetails 将检索与此 ID 关联的维度 db.sql.statement 的全文。此操作很有用,因为 GetResourceMetricsDescribeDimensionKeys 不支持检索大型 SQL 语句文本。

GetPerformanceAnalysisReport

aws pi get-performance-analysis-report

检索报告,包括报告的见解。结果包括报告状态、报告 ID、报告时间详情、见解和建议。

GetResourceMetadata

aws pi get-resource-metadata

检索不同功能的元数据。例如,元数据可以表明特定数据库实例上的某个功能已打开或关闭。

GetResourceMetrics

aws pi get-resource-metrics

检索一组数据来源在一段时间内的 Performance Insights 指标。您可以提供特定维度组和维度,并为每个组提供聚合和筛选条件。

ListAvailableResourceDimensions

aws pi list-available-resource-dimensions

检索特定实例上每个特定指标类型可查询的维度。

ListAvailableResourceMetrics

aws pi list-available-resource-metrics

检索指定指标类型的所有可用指标,指定数据库实例可用该指标进行查询。

ListPerformanceAnalysisReports

aws pi list-performance-analysis-reports

检索数据库实例的所有可用分析报告。这些报告根据每个报告的开始时间列出。

ListTagsForResource

aws pi list-tags-for-resource

列出添加到资源的所有元数据标签。该列表包含标签的名称和值。

TagResource

aws pi tag-resource

将元数据标签添加到 Amazon RDS 资源中。该标签包含名称和值。

UntagResource

aws pi untag-resource

从资源中删除元数据标签。

有关检索性能详情的时间序列指标和 AWS CLI 示例的更多信息,请参阅以下主题。