使用 Amazon DocumentDB 监控 CloudWatch

Amazon DocumentDB（与 MongoDB 兼容）与 Amazon CloudWatch 集成，因此您可以为您的集群收集和分析运行指标。您可以使用 CloudWatch 控制台、Amazon DocumentDB控制台、AWS Command Line Interface (AWS CLI) 或 CloudWatch API 来监控这些指标。

CloudWatch 还让您设置警报，以便在指标值超过您指定的阈值时，您可以收到通知。如果超过阈值，您甚至可以设置 Amazon CloudWatch Events 事件来采取纠正措施。有关使用 CloudWatch 和警报的更多信息，请参阅 Amazon CloudWatch 文档.

Amazon DocumentDB 指标

要监控 Amazon DocumentDB 集群和实例的运行状况和性能，您可以在 Amazon DocumentDB 控制台中查看以下指标。

查看 CloudWatch 数据

您可以借助 Amazon CloudWatch 控制台、CloudWatch控制台、Amazon DocumentDB (AWS Command Line Interface) 或 AWS CLI API 查看 CloudWatch 数据。

要使用 CloudWatch 管理控制台查看 Amazon DocumentDB 指标，请完成以下步骤。

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

2. 在导航窗格中，选择 Clusters.

   提示

   如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 ()。

3. 在“Clusters （集群）”导航窗格中，您将看到 Cluster Identifier （集群标识符） 列。您的实例将在集群下列出，与以下屏幕截图类似。

   

4. 从实例列表中，选择要获取其指标的实例的名称。

5. 在生成的实例摘要页面中，选择 Monitoring （监控） 选项卡以查看 Amazon DocumentDB 实例的指标的图形表示。由于必须为每个指标生成一个图表，可能需要几分钟才能填充 CloudWatch 图表。

   下图显示了 CloudWatch 控制台中两个 Amazon DocumentDB 指标的图形化表示，即 WriteIOPS 和 ReadIOPS。

   ![

                       控制台中的 18 个 CloudWatch 指标中的两个，writeiops 和 readiops。Amazon DocumentDB
                    ](/projects/DocumentDB-20201111-zh/daa7091247073754a2028d0ebcf9640a.png)

要使用 CloudWatch 管理控制台查看 CloudWatch 指标，请完成以下步骤。

1. 登录 AWS 管理控制台，并通过以下网址打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/cloudwatch。

2. 在导航窗格中，选择 Metrics. 然后，从服务名称列表中，选择 DocDB。

3. 选择指标维度（例如，Cluster Metrics （集群指标））。

4. All metrics 选项卡显示 DocDB 中该维度的所有指标。

   1. 要对表进行排序，请使用列标题。

   2. 要为指标绘制图表，请选中该指标旁的复选框。要选择所有指标，请选中表的标题行中的复选框。

   3. 要按指标进行筛选，请将鼠标指针悬停在指标名称上，然后选择指标名称旁边的下拉箭头。然后，选择 Add to search （添加到搜索），如下图所示。

      ![

                                通过将鼠标悬停在指标上并选择“Add to search”（添加到搜索） 来筛选指标。
                             ](/projects/DocumentDB-20201111-zh/524d34d760144154a293ffbbd3389281.png)

要查看 CloudWatch 的 Amazon DocumentDB 数据，请使用带以下参数的 CloudWatch get-metric-statistics 操作。

Parameters

• --namespace — 必需。需要其 CloudWatch 指标的服务命名空间。对于 Amazon DocumentDB，必须为 AWS/DocDB.

• --metric-name — 必需。需要其数据的指标的名称。

• --start-time — 必需。用于确定要返回的第一个数据点的时间戳。

  包含指定的值；结果包括具有指定时间戳的数据点。时间戳必须采用 ISO 8601 UTC 格式（例如，2016-10-03T23:00:00Z）。

• --end-time — 必需。用于确定要返回的最后一个数据点的时间戳。

  包含指定的值；结果包括具有指定时间戳的数据点。时间戳必须采用 ISO 8601 UTC 格式（例如，2016-10-03T23:00:00Z）。

• --period — 必需。返回的数据点的粒度（以秒为单位）。对于具有常规精度的指标，期间可以短到一分钟（60 秒），并且必须为 60 的倍数。对于以小于一分钟的间隔收集的高精度指标，期间可以是 1、5、10、30、60 或 60 的任意倍数。

• --dimensions — 可选。如果指标包含多个维度，则必须包含每个维度的值。CloudWatch 将每个唯一的维度组合视为一个单独的指标。如果未发布某个特定的维度组合，则无法检索该组合的统计数据。您必须指定创建指标时使用的同一维度。

• --statistics — 可选。百分位数之外的指标统计数据。对于百分位数统计数据，请使用 ExtendedStatistics. 调用 GetMetricStatistics 时，必须指定 Statistics 或 ExtendedStatistics，但不能同时指定两者。

  允许的值：

  • SampleCount

  • Average

  • Sum

  • Minimum

  • Maximum

• --extended-statistics — 可选。percentile 统计数据。指定介于 p0.0 到 p100 之间的值。调用 GetMetricStatistics 时，必须指定 Statistics 或 ExtendedStatistics，但不能同时指定两者。

• --unit — 可选。给定指标的单位。可以用多个单位报告指标。如果不提供单位，将返回所有单位。如果您仅指定指标不报告的单位，调用的结果将为空。

  可能的值：

  • Seconds

  • Microseconds

  • Milliseconds

  • Bytes

  • Kilobytes

  • Megabytes

  • Gigabytes

  • Terabytes

  • Bits

  • Kilobytes

  • Megabits

  • Gigabits

  • Terabits

  • Percent

  • Count

  • Bytes/Second

  • Kilobytes/Second

  • Megabytes/Second

  • Gigabytes/Second

  • Terabytes/Second

  • Bits/Second

  • Kilobits/Second

  • Megabits/Second

  • Gigabits/Second

  • Terabits/Second

  • Count/Second

  • None

以下示例查找 2 小时时段的最大 CPUUtilization，每隔 60 秒采样一次。

对于 Linux、macOS 或 Unix:

aws cloudwatch get-metric-statistics \
       --namespace AWS/DocDB \
       --dimensions \
           Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 \
       --metric-name CPUUtilization \
       --start-time 2019-02-11T05:00:00Z \
       --end-time 2019-02-11T07:00:00Z \
       --period 60 \
       --statistics Maximum

对于 Windows:

aws cloudwatch get-metric-statistics ^
       --namespace AWS/DocDB ^
       --dimensions ^
           Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 ^
       --metric-name CPUUtilization ^
       --start-time 2019-02-11T05:00:00Z ^
       --end-time 2019-02-11T07:00:00Z ^
       --period 60 ^
       --statistics Maximum

此操作的输出类似于以下内容：

{
       "Label": "CPUUtilization",
       "Datapoints": [
           {
               "Unit": "Percent",
               "Maximum": 4.49152542374361,
               "Timestamp": "2019-02-11T05:51:00Z"
           },
           {
               "Unit": "Percent",
               "Maximum": 4.25000000000485,
               "Timestamp": "2019-02-11T06:44:00Z"
           },
           ********* some output omitted for brevity *********
           {
               "Unit": "Percent",
               "Maximum": 4.33333333331878,
               "Timestamp": "2019-02-11T06:07:00Z"
           }
       ]
   }

Amazon DocumentDB 维度

Amazon DocumentDB的指标由账户或操作的值来限定。您可以使用 CloudWatch 控制台来检索由下表中的任意维度筛选的 Amazon DocumentDB数据。

监控对手

计数器指标对于空闲集群为非零值（通常为 ~50）。这是因为 Amazon DocumentDB 执行定期运行状况检查、内部操作和指标收集任务。

监控数据库连接

当您使用 db.runCommand( { serverStatus: 1 }) 等数据库引擎命令来查看连接数时，您最多可能会看到比通过 DatabaseConnections 在 CloudWatch. 中看到的数量多 10 个的连接。出现这种情况的原因是 Amazon DocumentDB 执行定期运行状况检查和指标收集任务，而这些任务不在 DatabaseConnections 中考虑到。DatabaseConnections 仅表示客户发起的连接。