分析 Amazon DocumentDB 操作

开始之前，请先创建一个 Amazon DocumentDB 集群和一个自定义集群参数组（如果您还没有）。有关更多信息，请参阅 创建 Amazon DocumentDB 集群参数组 和 创建亚马逊文档数据库集群：

使用可用的自定义集群参数组，修改以下参数。有关更多信息，请参阅修改 Amazon DocumentDB 集群参数组。

修改您的集群以使用自定义集群参数组，并将分析器日志导出设置为发布到 Amazon CloudWatch。

1. 在导航窗格中，选择 Clusters (集群) 以将自定义参数组添加到集群。

2. 选择要与您的参数组关联的集群名称左边的按钮。选择 Actions (操作)，然后选择 Modify (修改) 以修改您的集群。

3. 在 Cluster options (集群选项) 下，选择上一步中的自定义参数组以将其添加到集群中。

4. 在志日导出下，选择析器日志以发布到 Amazon CloudWatch 中。

5. 选择 Continue (继续) 以查看修改摘要。

6. 在确认您的更改后，您可以立即应用这些更改，也可以在 Scheduling of modifications (修改计划) 下的下一个维护时段内应用这些更改。

7. 选择 Modify cluster (修改集群) 以使用新参数组更新您的集群。

在开始之前，请运行以下命令，并查看对于名称中不包含 default 且具有 docdb3.6 作为参数组系列的集群参数组的输出，以确保您拥有可用的自定义集群参数组。如果您没有非默认集群参数组，请参阅创建 Amazon DocumentDB 集群参数组。

aws docdb describe-db-cluster-parameter-groups \
    --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName,DBParameterGroupFamily]'

在以下输出中，仅 sample-parameter-group 满足这两个条件。

[
       [
           "default.docdb3.6",
           "docdb3.6"
       ],
       [
           "sample-parameter-group",
           "docdb3.6"
       ]
]

使用您的自定义集群参数组，修改以下参数。

aws docdb modify-db-cluster-parameter-group \
    --db-cluster-parameter-group-name sample-parameter-group \
    --parameters ParameterName=profiler,ParameterValue=enabled,ApplyMethod=immediate \
                 ParameterName=profiler_threshold_ms,ParameterValue=100,ApplyMethod=immediate \
                 ParameterName=profiler_sampling_rate,ParameterValue=0.5,ApplyMethod=immediate

修改您的 Amazon DocumentDB 集群，使其使用上一步中提到的 sample-parameter-group 自定义集群参数组，并将参数 --enable-cloudwatch-logs-exports 设置为 profiler。

以下代码会修改 sample-cluster 集群，使其使用上一步中提到的 sample-parameter-group，并将 profiler 添加到已启用的 CloudWatch Logs 导出。

aws docdb modify-db-cluster \
       --db-cluster-identifier sample-cluster \
       --db-cluster-parameter-group-name sample-parameter-group \
       --cloudwatch-logs-export-configuration '{"EnableLogTypes":["profiler"]}'
                  

此操作的输出将类似于下文。

{
    "DBCluster": {
        "AvailabilityZones": [
            "us-east-1c",
            "us-east-1b",
            "us-east-1a"
        ],
        "BackupRetentionPeriod": 1,
        "DBClusterIdentifier": "sample-cluster",
        "DBClusterParameterGroup": "sample-parameter-group",
        "DBSubnetGroup": "default",
        "Status": "available",
        "EarliestRestorableTime": "2020-04-07T02:05:12.479Z",
        "Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
        "ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
        "MultiAZ": false,
        "Engine": "docdb",
        "EngineVersion": "3.6.0",
        "LatestRestorableTime": "2020-04-08T22:08:59.317Z",
        "Port": 27017,
        "MasterUsername": "test",
        "PreferredBackupWindow": "02:00-02:30",
        "PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
        "DBClusterMembers": [
            {
                "DBInstanceIdentifier": "sample-instance-1",
                "IsClusterWriter": true,
                "DBClusterParameterGroupStatus": "in-sync",
                "PromotionTier": 1
            },
            {
                "DBInstanceIdentifier": "sample-instance-2",
                "IsClusterWriter": true,
                "DBClusterParameterGroupStatus": "in-sync",
                "PromotionTier": 1
            }
        ],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abcd0123",
                "Status": "active"
            }
        ],
        "HostedZoneId": "ABCDEFGHIJKLM",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
        "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "DBClusterArn": "arn:aws:rds:us-east-1:<accountID>:cluster:sample-cluster",
        "AssociatedRoles": [],
        "ClusterCreateTime": "2020-01-10T22:13:38.261Z",
        "EnabledCloudwatchLogsExports": [
            "profiler"
        ],
        "DeletionProtection": true
    }
}

登录到 Amazon Web Services Management Console 并打开 Amazon DocumentDB 控制台，网址：https://console.aws.amazon.com/docdb。

在导航窗格中，选择参数组。然后选择您要在其上禁用分析器的集群参数组的名称。

在生成的 Cluster parameters (集群参数) 页面中，选择 profiler 参数左侧的按钮，然后选择 Edit (编辑)。

在 Modify Profiler (修改分析器) 对话框中，在列表中选择 disabled。

选择 Modify cluster parameter (修改集群参数)。

通过以下网址打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb

在导航窗格中，选择 Clusters。选择要禁用导出日志的集群名称左侧的按钮。

在 Actions (操作) 菜单上，选择 Modify (修改)。

向下滚动到 Log exports (日志导出) 部分并取消选择 Profiler logs (分析器日志)。

选择继续。

检查更改，然后选择何时将该更改应用到集群：

• Apply during the next scheduled maintenance window (在下一个计划的维护时段内应用)

• Apply immediately (立即应用)

选择修改集群。