# 为 Amazon RDS 打开和关闭性能详情 **重要** AWS 已宣布性能详情功能的生命周期终止日期为：2026 年 6 月 30 日。在此日期之后，Amazon RDS 将不再支持性能详情控制台体验、灵活的保留期（1-24 个月）及其关联定价。性能详情 API 将继续存在，定价不变。性能详情 API 的费用将与 CloudWatch 数据库洞察的费用一起显示在您的 AWS 账单中。 建议您在 2026 年 6 月 30 日之前，将使用性能详情付费套餐的所有数据库实例升级到数据库洞察的高级模式。有关升级到数据库洞察的高级模式的信息，请参阅[开启适用于 Amazon RDS 的数据库洞察的高级模式](USER_DatabaseInsights.TurningOnAdvanced.md)。 如果您不采取任何行动，则使用性能详情的数据库实例将默认为使用数据库洞察的标准模式。在数据库洞察的标准模式下，您可能会在 7 天后无法访问性能数据历史记录，并且可能无法在 Amazon RDS 控制台中使用执行计划和按需分析功能。2026 年 6 月 30 日之后，只有数据库洞察的高级模式将支持执行计划和按需分析。 借助 CloudWatch 数据库洞察，您可以监控数据库实例集的数据库负载，并对性能进行大规模分析和故障排除。有关数据库洞察的更多信息，请参阅[使用 CloudWatch 数据库洞察监控 Amazon RDS 数据库](USER_DatabaseInsights.md)。有关定价信息，请参阅 [Amazon CloudWatch 定价](https://aws.amazon.com/cloudwatch/pricing/)。 您可以在创建数据库实例或多可用区数据库集群时，为其打开性能详情。如果需要，可以稍后通过控制台修改数据库实例来关闭性能详情。打开和关闭性能详情不会导致停机、重启或失效转移。 **注意** Performance Schema 是 Amazon RDS for MariaDB or MySQL 使用的一个可选性能工具。如果打开或关闭 Performance Schema，则需要重新启动。但是，如果您打开或关闭性能详情，则无需重新启动。有关更多信息，请参阅 [Amazon RDS for MariaDB 或 Amazon RDS for MySQL 上性能详情的性能架构概述](USER_PerfInsights.EnableMySQL.md)。 性能详情代理占用数据库主机上有限的 CPU 和内存。当数据库负载较高时，代理将通过降低收集数据的频率来限制性能影响。 ------ #### [ Console ] 在控制台中，您可以在创建或修改数据库实例或多可用区数据库集群时打开或关闭性能详情。 **创建数据库实例或多可用区数据库集群时打开或关闭性能详情** 创建新的数据库实例或多可用区数据库集群后，Amazon RDS 默认情况下会启用性能详情。要关闭性能详情，请选择**数据库洞察 - 标准**选项，然后取消选择**启用性能详情**选项。 有关更多信息，请参阅以下主题。 + 要创建数据库实例，请按照[创建 Amazon RDS 数据库实例](USER_CreateDBInstance.md)中用于您的数据库引擎的说明操作。 + 要创建多可用区数据库集群，请按 [创建 Amazon RDS 的多可用区数据库集群](create-multi-az-db-cluster.md) 中数据库引擎的说明操作。 以下屏幕截图显示了**性能详情**部分。 ![\[在使用控制台创建数据库实例或多可用区数据库集群期间打开性能详情\]](http://docs.aws.amazon.com/zh_cn/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png) 如果您选择**启用性能详情**，您有以下选项： + **保留期**（仅适用于数据库洞察的标准模式）：保留性能详情数据的时间量。保留期设置为**默认值（7 天）**。要将性能数据保留更长时间，请指定 1–24 个月。有关保留期的更多信息，请参阅。[性能详情的定价和数据留存](USER_PerfInsights.Overview.cost.md) + **AWS KMS key** - 指定您的 AWS KMS key。性能详情使用您的 KMS 密钥来加密所有潜在的敏感数据。正在传输的数据和静态数据都会被加密。有关更多信息，请参阅 [更改性能详情的 AWS KMS 策略](USER_PerfInsights.access-control.cmk-policy.md)。 **在修改数据库实例或多可用区数据库集群时打开或关闭性能详情** 在控制台中，您可以修改数据库实例或多可用区数据库集群来管理性能详情。 **使用控制台为数据库实例或多可用区数据库集群管理性能详情** 1. 登录 AWS 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)。 1. 选择**数据库**。 1. 选择数据库实例或多可用区数据库集群，然后选择**修改**。 1. 要开启性能详情，请选择**启用性能详情**。要关闭性能详情，请选择**数据库洞察 - 标准**选项，然后取消选择**启用性能详情**选项。 如果您选择**启用性能详情**，您有以下选项： + **保留期**（仅适用于数据库洞察的标准模式）：保留性能详情数据的时间量。保留期设置为**默认值（7 天）**。要将性能数据保留更长时间，请指定 1–24 个月。有关保留期的更多信息，请参阅。[性能详情的定价和数据留存](USER_PerfInsights.Overview.cost.md) + **AWS KMS key** - 指定您的 KMS 密钥。性能详情使用您的 KMS 密钥来加密所有潜在的敏感数据。正在传输的数据和静态数据都会被加密。有关更多信息，请参阅 [加密 Amazon RDS 资源](Overview.Encryption.md)。 1. 选择**继续**。 1. 对于**修改计划**，请选择“立即应用”。如果您选择“Apply during the next scheduled maintenance window”（在下一个计划的维护时段内应用），则您的实例将忽略此设置并立即打开性能详情。 1. 选择**修改实例**。 ------ #### [ AWS CLI ] 使用 [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI 命令时，通过指定 `--enable-performance-insights` 可开启性能详情，并将 `--database-insights-mode` 设置为 `advanced` 或 `standard`。要关闭性能详情，请指定 `--no-enable-performance-insights` 并将 `database-insights-mode` 设置为 `standard`。 您还可以使用以下 AWS CLI 命令指定这些值： + [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) + [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) + [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) + [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) + [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) 在 CLI 中打开性能详情时，可以选择通过 `--performance-insights-retention-period` 选项指定保留性能详情数据的天数。您可以指定 `7`、*month* \$1 31（其中 *month* 为 1–23 之间的数字）或 `731`。例如，如果您想将性能数据保留 3 个月，请指定 `93`，也就是 3 \$1 31。默认值为 `7` 天。有关保留期的更多信息，请参阅。[性能详情的定价和数据留存](USER_PerfInsights.Overview.cost.md) 以下示例为 `sample-db-cluster` 开启性能详情并指定将性能详情数据保留 93 天（3 个月）。 对于 Linux、macOS 或 Unix： ``` aws rds modify-db-cluster \ --database-insights-mode standard \ --db-cluster-identifier sample-db-instance \ --enable-performance-insights \ --performance-insights-retention-period 93 ``` 对于：Windows ``` aws rds modify-db-cluster ^ --database-insights-mode standard ^ --db-cluster-identifier sample-db-instance ^ --enable-performance-insights ^ --performance-insights-retention-period 93 ``` 如果您指定保留期（如 94 天），这不是一个有效值，则 RDS 会发出错误。 ``` An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731] ``` **注意** 对于未在集群级别管理性能详情的数据库集群中的实例，只能切换性能详情。 ------ #### [ RDS API ] 在使用 [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) 操作 Amazon RDS API 操作创建新数据库实例时，通过将 `EnablePerformanceInsights` 设置为 `True` 来打开性能详情。要关闭性能详情，请将 `EnablePerformanceInsights` 设置为 `False` 并将 `DatabaseInsightsMode` 设置为 `standard`。 您还可以使用以下 API 操作指定 `EnablePerformanceInsights` 值： + [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html)（多可用区数据库集群） + [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html)（多可用区数据库集群） + [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) + [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) + [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 在打开性能详情时，可以通过 `PerformanceInsightsRetentionPeriod` 参数指定性能详情数据的保留时间，以天为单位。您可以指定 `7`、*month* \$1 31（其中 *month* 为 1–23 之间的数字）或 `731`。例如，如果您想将性能数据保留 3 个月，请指定 `93`，也就是 3 \$1 31。默认值为 `7` 天。有关保留期的更多信息，请参阅。[性能详情的定价和数据留存](USER_PerfInsights.Overview.cost.md) ------