使用 CloudWatch 监控 Amazon DocumentDB - Amazon DocumentDB
Amazon DocumentDB 指标查看 CloudWatch 数据Amazon DocumentDB 维度监控 Opcount监控数据库连接
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 CloudWatch 监控 Amazon DocumentDB

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

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

Amazon DocumentDB 指标

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

资源利用率
指标 描述
BackupRetentionPeriodStorageUsed 用于支持 Amazon DocumentDB 保留时段内的时间点还原功能的备份存储总量（以 GiB 为单位）。包含在 TotalBackupStorageBilled 指标报告的总数中。针对每个 Amazon DocumentDB 集群单独计算。
ChangeStreamLogSize 集群用于存储变更流日志的存储量（以兆字节为单位）。此值是集群总存储量的子集 (VolumeBytesUsed)，将影响集群的成本。有关存储定价的信息，请参阅Amazon DocumentDB 产品页面. 变更流日志大小取决于集群上发生了多少更改以及变更流日志的保留时间。有关变更流的更多信息，请参阅在 Amazon DocumentDB 中使用变更流。
CPUUtilization 实例占用的 CPU 百分比。
DatabaseConnections 每 1 分钟获取的实例上打开的连接数。
DatabaseConnectionsMax 在一分钟内，实例上的最大开放数据库连接数。
DatabaseCursors 每 1 分钟打开一次的实例上的游标数。
DatabaseCursorsMax 一分钟内实例上打开的游标的最大数量。
DatabaseCursorsTimedOut 在一分钟内超时的游标数。
FreeableMemory 随机存取内存的可用量 (以字节为单位)。
FreeLocalStorage

此指标报告每个实例中可用于临时表和日志的存储量。此值取决于实例类。您可通过为实例选择较大的实例类来增加对实例可用的存储空间量。
LowMemThrottleQueueDepth

由于以一分钟频率占用的可用内存不足而受限的请求的队列深度。
LowMemThrottleMaxQueueDepth

一分钟内由于可用内存不足而受限的请求的最大队列深度。
LowMemNumOperationsThrottled

在一分钟内，由于可用内存不足而受到限制的请求数。
SnapshotStorageUsed 给定 Amazon DocumentDB 集群的所有快照在其备份保留时段外消耗的备份存储总量（以 GiB 为单位）。包含在 TotalBackupStorageBilled 指标报告的总数中。针对每个 Amazon DocumentDB 集群单独计算。
SwapUsage 实例上使用的交换空间的大小。
TotalBackupStorageBilled 为给定 Amazon DocumentDB 集群计费时所针对的备份存储总量（以 GiB 为单位）。包含由 BackupRetentionPeriodStorageUsed 和 SnapshotStorageUsed 指标度量的备份存储。针对每个 Amazon DocumentDB 集群单独计算。
TransactionsOpen 每 1 分钟的频率在实例上打开的交易数。
TransactionsOpenMax 在一分钟内实例上打开的最大交易数。
VolumeBytesUsed 您的集群使用的存储量（以字节为单位）。此值将影响集群的成本。有关定价信息，请参阅Amazon DocumentDB 产品页面.
延迟
指标 描述
DBClusterReplicaLagMaximum 集群中主实例和每个 Amazon DocumentDB 实例之间的最大滞后量（以毫秒为单位）。
DBClusterReplicaLagMinimum 集群中主实例和每个副本实例之间的最小滞后量（以毫秒为单位）。
DBInstanceReplicaLag 在从主实例向副本实例复制更新时的滞后总量（以毫秒为单位）。
ReadLatency 每个磁盘 I/O 操作所需的平均时间。
WriteLatency 每个磁盘 I/O 操作所需的平均时间（以毫秒为单位）。
操作
指标 描述
DocumentsDeleted 一分钟内删除的文档的数量。
DocumentsInserted 一分钟时间内插入的文档的数量。
DocumentsReturned 一分钟内返回的文件数量。
DocumentsUpdated 一分钟内更新的文档的数量。
OpcountersCommand 在一分钟内发出的命令数。
OpcountersDelete 在一分钟内发出的删除操作的数量。
OpcountersGetmore 在一分钟内发行的 getmores 的数量。
OpcountersInsert 在一分钟时间内发出的插入操作的数量。
OpcountersQuery 在一分钟内发出的查询数。
OpcountersUpdate 在一分钟内发布的更新操作的数量。
TransactionsStarted 在一分钟内在实例上开始的交易数。
TransactionsCommitted 在一分钟内在实例上提交的交易数。
TransactionsAborted 在一分钟内实例中止的交易数。
TTLDeletedDocuments TTLMonitor 在一分钟内删除的文档数。
吞吐量
指标 描述
NetworkReceiveThroughput 集群中每个实例从客户端接收的网络吞吐量（以每秒字节数为单位）。此吞吐量不包括集群中的实例与集群卷之间的网络流量。
NetworkThroughput Amazon DocumentDB 集群中每个实例从客户端接收和传输到客户端的网络吞吐量（以每秒字节数为单位）。此吞吐量不包括集群中的实例与集群卷之间的网络流量。
NetworkTransmitThroughput 集群中每个实例发送到客户端的网络吞吐量（以每秒字节数为单位）。此吞吐量不包括集群中的实例与集群卷之间的网络流量。
ReadIOPS 每秒平均磁盘读取 I/O 操作数。Amazon DocumentDB 每分钟分别报告一次读取和写入 IOPS。
ReadThroughput 每秒从磁盘读取的平均字节数。
VolumeReadIOPs

集群卷中计费读取 I/O 操作的平均数量，每隔 5 分钟报告一次。计费读取操作数是在集群卷级别计算的，由集群中的所有实例聚合而来，然后每隔 5 分钟报告一次。此值是通过采用 5 分钟以上的读取操作数指标的值计算得来的。您可通过采用计费读取操作数指标的值并除以 300 秒来确定每秒的计费读取操作数。

例如，如果VolumeReadIOPs返回 13686，然后每秒的计费读取操作数为 45 (13686/300 = 45.62)。

您累积请求不在缓冲区缓存中因而必须从存储加载的数据库页的查询的计费读取操作数。您可能看到计费读取操作数出现峰值，因为查询结果是从存储中读取然后加载到缓冲区缓存中的。
VolumeWriteIOPs

集群卷中计费写入 I/O 操作的平均数量，每隔 5 分钟报告一次。计费写入操作数是在集群卷级别计算的，由集群中的所有实例聚合而来，然后每隔 5 分钟报告一次。此值是通过采用 5 分钟以上的写入操作数指标的值计算得来的。您可通过采用计费写入操作数指标的值并除以 300 秒来确定每秒的计费写入操作数。

例如，如果VolumeWriteIOPs返回 13686，然后每秒的计费写入操作数为 45 (13686/300 = 45.62)。

请注意，VolumeReadIOPs和VolumeWriteIOPs指标由 DocumentDB 存储层计算，其中包括主实例和副本实例执行的 iOS。每 20-30 分钟汇总一次数据，然后每隔 5 分钟报告一次，从而在该时间段内为该指标发出相同的数据点。如果您正在寻找在 1 分钟间隔内与插入操作关联的指标，则可以使用实例级 WriteIOPS 指标。该指标可在 Amazon DocumentDB 主实例的监控选项卡中找到。
WriteIOPS 每秒平均磁盘写入 I/O 操作数。在群集级别使用时，WriteIOPs在群集中的所有实例中进行评估。每分钟分别报告一次读取和写入 IOPS。
WriteThroughput 每秒写入磁盘的平均字节数。
系统
指标 描述
BufferCacheHitRatio 缓冲区缓存提供的请求的百分比。
DiskQueueDepth 对分布式存储卷的并发写入请求的数量。
EngineUptime 实例已运行的时间长度（以秒为单位）。
IndexBufferCacheHitRatio 缓冲区缓存提供的索引请求的百分比。删除索引、集合或数据库后，您可能会看到指标的峰值超过 100%。这将在 60 秒后自动更正。将来的补丁更新中将修复这一限制。
T3 实例指标
指标 描述
CPUCreditUsage 在测量周期内花费的 CPU 积分数。
CPUCreditBalance 实例产生的 CPU 积分数量。在 CPU 突增以及 CPU 积分的花费速度比获得速度快时，该余额将用完。
CPUSurplusCreditBalance 在 CPucreditBalance 值为零时，用于保持 CPU 性能而花费的超额 CPU 积分数。
CPUSurplusCreditsCharged 超过可在 24 小时内获得的 CPU 积分数上限的超额 CPU 积分数，因而会产生额外的费用。有关更多信息，请参阅 。监控 CPU 积分.

查看 CloudWatch 数据

您可以使用 Amazon CloudWatch 控制台、Amazon DocumentDB 控制台、Amazon Command Line Interface(Amazon CLI) 或者 CloudWatch API。

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

  1. 登录到Amazon Web Services Management Console，然后在以下位置打开 Amazon DocumentDB 控制台https://console.aws.amazon.com/docdb.

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

    提示

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

  3. 在 Cluster 导航框中，您将看到该列Cluster Identifier. 您的实例列在群集下，类似于下面的屏幕截图。

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

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

    下图显示了 Amazon DocumentDB 控制台中两个 CloudWatch 指标的图形表示方式，WriteIOPS和ReadIOPS.

    Amazon DocumentDB 控制台中的 18 个 CloudWatch 指标中的两个，即 write eiops 和 readiops。

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

  1. 登录到Amazon Web Services Management Console，然后在以下位置打开 Amazon DocumentDB 控制台https://console.amazonaws.cn/cloudwatch.

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

  3. 选择指标维度（例如，集群指标)。

  4. 这些区域有：所有指标选项卡显示中该维度的所有指标DocDB.

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

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

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

      将鼠标悬停在指标上方并选择 “添加到搜索” 来筛选指标。

要查看 Amazon DocumentDB 的 CloudWatch 数据，请使用 CloudWatchget-metric-statistics按照以下参数进行操作。

参数

  • --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 数据。

维度 描述
DBClusterIdentifier 筛选您为特定 Amazon DocumentDB 集群请求的数据。
DBClusterIdentifier, Role 筛选您为特定 Amazon DocumentDB 集群请求的数据，并按实例角色 (WRITER/READER) 聚合指标。例如，您可以聚合属于某个群集的所有 READER 实例的指标。
DBInstanceIdentifier 筛选您为特定数据库实例请求的数据。

监控 Opcount

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

监控数据库连接

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