分析 Amazon DocumentDB 操作

在開始之前，請先建立 Amazon DocumentDB 叢集和自訂叢集參數群組 (如果您還沒有叢集參數群組)。如需詳細資訊，請參閱 建立 Amazon DocumentDB 叢集參數群組 和 創建一個 Amazon DocumentDB 集群。

使用可用的自訂叢集參數群組，修改下列參數。如需詳細資訊，請參閱修改 Amazon DocumentDB 叢集參數群組。

修改叢集以使用自訂叢集參數群組，並將效能分析工具日誌匯出設定為發佈到 Amazon。 CloudWatch

1. 在導覽窗格中，選擇 Clusters (叢集) 來將自訂參數群組新增至叢集。

2. 選擇參數群組要與其建立關聯之叢集名稱左側的按鈕。選取 Actions (動作)，然後選取 Modify (修改) 以修改您的叢集。

3. 在 Cluster (叢集) 選項下，從上述步驟中選擇自訂參數群組，以將其新增至您的叢集。

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 記錄匯出。

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
    }
}

登入 AWS Management Console，然後在 https://console.aws.amazon.com/docdb 開啟 Amazon DocumentDB 主控台。

在導覽窗格中，選擇 Parameter groups (參數群組)。然後選擇您要停用 Profiler 的叢集參數群組的名稱。

在產生的 Cluster parameters (叢集參數) 頁面中，選取 profiler 參數左邊的按鈕，然後選擇 Edit (編輯)。

在 Modify profiler (修改 Profiler) 對話方塊中，選擇清單中的 disabled。

選擇 Modify cluster parameter (修改叢集參數)。

打開 Amazon DocumentDB 控制台 https://console.aws.amazon.com/docdb。

在導覽窗格中，選擇叢集。對於您要停止匯出日誌的叢集，選擇其名稱左側的按鈕。

在 Actions (動作) 功能表上，選擇 Modify (修改)。

向下捲動至 Log exports (日誌匯出) 區段，並取消選取 Profiler logs (分析工具日記)。

選擇繼續。

檢閱您的變更，然後選擇希望叢集套用此變更的時機：

• Apply during the next scheduled maintenance window (在下次排定的維護時段套用)

• Apply immediately (立即套用)

選擇修改叢集。