使用 CloudWatch 监控 Amazon DocumentDB dWatch - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

使用 CloudWatch 监控 Amazon DocumentDB dWatch

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 为单位)。包含由 BackupRetentionPeriodStorageUsedSnapshotStorageUsed 指标度量的备份存储。针对每个 Amazon DocumentDB 集群单独计算。
TransactionsOpen 以 1 分钟频率执行的实例上打开的事务数。
TransactionsOpenMax 一分钟内在实例上打开的最大事务数。
VolumeBytesUsed 您的集群使用的存储量(以字节为单位)。此值将影响集群的成本。有关定价信息,请参阅Amazon DocumentDB 产品页面.
Latency
指标 说明
DBClusterReplicaLagMaximum 集群中主实例和每个 Amazon DocumentDB 实例之间的最大滞后量(以毫秒为单位)。
DBClusterReplicaLagMinimum 集群中主实例和每个副本实例之间的最小滞后量(以毫秒为单位)。
DBInstanceReplicaLag 在从主实例向副本实例复制更新时的滞后总量(以毫秒为单位)。
ReadLatency 每个磁盘 I/O 操作所需的平均时间。
WriteLatency 每个磁盘 I/O 操作所需的平均时间(以毫秒为单位)。
Operations
指标 说明
DocumentsDeleted 一分钟内已删除文档的数量。
DocumentsInserted 一分钟内插入的文档数。
DocumentsReturned 一分钟内返回的文档数。
DocumentsUpdated 一分钟内更新的文档数。
OpcountersCommand 一分钟内发出的命令数。
OpcountersDelete 一分钟内发出的删除操作数。
OpcountersGetmore 在一分钟内发布的发货数量。
OpcountersInsert 一分钟内发出的插入操作数。
OpcountersQuery 一分钟内发出的查询数。
OpcountersUpdate 一分钟内发出的更新操作数。
TransactionsStarted 一分钟内在实例上启动的事务处理数。
TransactionsCommitted 一分钟内在实例上提交的事务数。
TransactionsAborted 在一分钟内在实例上中止的事务处理数。
TTLDeletedDocuments TTL监控器在一分钟内删除的文档数。
Throughput
指标 说明
NetworkReceiveThroughput 集群中每个实例从客户端接收的网络吞吐量(以每秒字节数为单位)。此吞吐量不包括集群中的实例与集群卷之间的网络流量。
NetworkThroughput Amazon DocumentDB 集群中每个实例从客户端接收和发送到客户端的网络吞吐量(以每秒字节数为单位)。此吞吐量不包括集群中的实例与集群卷之间的网络流量。
NetworkTransmitThroughput 集群中每个实例发送到客户端的网络吞吐量(以每秒字节数为单位)。此吞吐量不包括集群中的实例与集群卷之间的网络流量。
ReadIOPS 每秒平均磁盘读取 I/O 操作数。Amazon DocumentDB 每 1 分钟分别报告一次读取和写入 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)。

请注意,VolumeReadIOPsVolumeWriteIOPs度量是由 DocumentDB 存储层计算的,它包括由主实例和副本实例执行的 iOS。每 20-30 分钟聚合一次数据,然后每隔 5 分钟报告一次,从而在该时段内为指标发出相同的数据点。如果您要在 1 分钟的时间间隔内寻找与插入操作相关的指标,则可以使用实例级别的 WriteIOPS 指标。该指标位于您的 Amazon DocumentDB 主实例的监控选项卡中。

WriteIOPS 每秒平均磁盘写入 I/O 操作数。在群集级别上使用时,WriteIOPs在群集中的所有实例之间进行评估。每分钟分别报告一次读取和写入 IOPS。
WriteThroughput 每秒写入磁盘的平均字节数。
System
指标 说明
BufferCacheHitRatio 缓冲区缓存提供的请求的百分比。
DiskQueueDepth 对分布式存储卷的并发写入请求数。
EngineUptime 实例已运行的时间长度(以秒为单位)。
IndexBufferCacheHitRatio 缓冲区缓存提供的索引请求的百分比。删除索引、集合或数据库后,您可能会看到指标的峰值超过 100%。这将在 60 秒后自动更正。将来的修补程序更新中将修复该限制。
T3 实例指标
指标 说明
CPUCreditUsage 在测量周期内花费的 CPU 积分数。
CPUCreditBalance 实例产生的 CPU 积分数量。在 CPU 突增以及 CPU 积分的花费速度比获得速度快时,该余额将用完。
CPUSurplusCreditBalance 在 CPU 积分平衡值为零时,用于保持 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. 在 Clusters (集群) 导航框中,您将看到Cluster Identifier. 您的实例在集群下列出,类似于下面的屏幕截图。

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

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

    下图显示了 Amazon DocumentDB 控制台中两个 CloudWatch 指标的图形表示形式,WriteIOPSReadIOPS.

    
                        Amazon DocumentDB 控制台中的 18 个 CloudWatch 指标中的两个。

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

  1. 登录到Amazon Web Services Management Console,然后打开 Amazon DocumentDB 控制台https://console.amazonaws.cn/cloudwatch.

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

  3. 选择指标维度(例如,集群指标)。

  4. 这些区域有:所有指标选项卡显示DocDB.

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

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

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

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

若要查 CloudWatch 马逊文档数据库的 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 时,必须指定 StatisticsExtendedStatistics,但不能同时指定两者。

    允许的值:

    • SampleCount

    • Average

    • Sum

    • Minimum

    • Maximum

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

  • --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 指标为空闲集群具有非零值(通常为 50)。这是因为 Amazon DocumentDB 执行定期运行状况检查、内部操作和指标收集任务。

监控数据库连接

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