View a markdown version of this page

启用和禁用详细的每查询和数据库计数器指标 - Amazon Relational Database Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

启用和禁用详细的每查询和数据库计数器指标

当您选择数据库洞察高级模式时，默认情况下会启用详细的每查询和数据库计数器指标。如果您选择数据库洞察标准模式，则可以在创建数据库实例或多可用区数据库集群时启用数据库洞察，稍后再通过控制台修改数据库实例将其关闭。启用详细的每查询和数据库计数器指标不会导致停机时间、重启或失效转移。

注意

Performance Schema 是 Amazon RDS for MariaDB 或 Amazon RDS for MySQL 使用的一个可选性能工具。如果打开或关闭 Performance Schema，则需要重新启动。但是，如果启用或禁用详细的每查询和数据库计数器指标，则不需要重启。有关更多信息，请参阅Amazon RDS for MariaDB 或 Amazon RDS for MySQL 的数据库洞察性能架构概述。

数据库洞察代理占用数据库主机上有限的 CPU 和内存。当数据库负载较高时，代理将通过降低收集数据的频率来限制性能影响。

Console

在控制台中，您可以在创建或修改数据库实例或多可用区数据库集群时，为数据库洞察标准模式启用收集详细的每查询和数据库计数器指标的操作。

在创建数据库实例或多可用区数据库集群时启用或禁用详细的每查询和数据库计数器指标

创建新的数据库实例或多可用区数据库集群后，在默认情况下，Amazon RDS 会启用详细的每查询和数据库计数器指标。要将其关闭，请选择数据库洞察 – 标准选项，然后取消选择启用收集详细的每查询和数据库计数器指标的操作选项。

有关更多信息，请参阅以下主题。

以下屏幕截图显示了数据库洞察部分。

数据库实例创建页面上的“数据库洞察”部分，其中提供可用于启用详细的数据库指标的选项。

如果选择启用收集详细的每查询和数据库计数器指标的操作，则会提供以下选项：

  • 保留：保留数据库洞察数据的时长。保留期设置为默认值（7 天）。要将性能数据保留更长时间，请指定 1–24 个月。有关保留期的更多信息，请参阅。数据库洞察的定价和数据留存

  • Amazon KMS key - 指定您的 Amazon KMS key。数据库洞察使用您的 KMS 密钥加密所有潜在的敏感数据。正在传输的数据和静态数据都会被加密。有关更多信息，请参阅更改数据库洞察的 KMS 密钥策略。

在修改数据库实例或多可用区数据库集群时启用或禁用详细的每查询和数据库计数器指标

在控制台中，您可以修改数据库实例或多可用区数据库集群，以管理数据库洞察的详细的每查询和数据库计数器指标。

使用控制台管理数据库实例或多可用区数据库集群的详细的每查询和数据库计数器指标

  1. 登录 Amazon Web Services 管理控制台并通过以下网址打开 Amazon RDS 控制台：https://console.aws.amazon.com/rds/。

  2. 选择数据库。

  3. 选择数据库实例或多可用区数据库集群，然后选择修改。

  4. 选择启用收集详细的每查询和数据库计数器指标的操作，以启用该功能。要关闭该功能，请选择数据库洞察 – 标准选项，然后取消选择启用收集详细的每查询和数据库计数器指标的操作选项。

    如果选择启用收集详细的每查询和数据库计数器指标的操作，则会提供以下选项：

    • 保留：保留数据库洞察数据的时长。保留期设置为默认值（7 天）。要将性能数据保留更长时间，请指定 1–24 个月。有关保留期的更多信息，请参阅。数据库洞察的定价和数据留存

    • Amazon KMS key - 指定您的 KMS 密钥。数据库洞察使用您的 KMS 密钥加密所有潜在的敏感数据。正在传输的数据和静态数据都会被加密。有关更多信息，请参阅加密 Amazon RDS 资源。

    数据库实例修改页面上的“数据库洞察”部分，其中提供可用于启用详细的数据库指标的选项。

  5. 选择继续。

  6. 对于修改计划，请选择“立即应用”。如果选择“在下一个计划的维护时段内应用”，则您的实例将忽略此设置，并立即启用收集详细的每查询和数据库计数器指标的操作。

  7. 选择修改实例。

Amazon CLI

使用 create-db-instance Amazon CLI 命令时，通过指定 --enable-performance-insights 并将 --database-insights-mode 设置为 advanced 或 standard，可开启详细的每查询和数据库计数器指标。要禁用这些指标，请指定 --no-enable-performance-insights 并将 database-insights-mode 设置为 standard。

您还可以使用以下 Amazon CLI 命令指定这些值：

在 CLI 中启用详细的每查询和数据库计数器指标时，可以选择通过 --performance-insights-retention-period 选项来指定数据的保留天数。您可以指定 7、month * 31（其中 month 为 1–23 之间的数字）或 731。例如，如果您想将性能数据保留 3 个月，请指定 93，也就是 3 * 31。默认值为 7 天。有关保留期的更多信息，请参阅。数据库洞察的定价和数据留存

以下示例为 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

使用 Amazon RDS API 操作 CreateDBInstance 创建新数据库实例时，通过将 EnablePerformanceInsights 设置为 True，启用详细的每查询和数据库计数器指标。要禁用这些指标，请将 EnablePerformanceInsights 设置为 False，并将 DatabaseInsightsMode 设置为 standard。

您还可以使用以下 API 操作指定 EnablePerformanceInsights 值：

启用详细的每查询和数据库计数器指标后，您可以选择使用 PerformanceInsightsRetentionPeriod 参数来指定数据的保留时间（以天为单位）。您可以指定 7、month * 31（其中 month 为 1–23 之间的数字）或 731。例如，如果您想将性能数据保留 3 个月，请指定 93，也就是 3 * 31。默认值为 7 天。有关保留期的更多信息，请参阅。数据库洞察的定价和数据留存