监控 Amazon DocumentDB 实例的状态

Amazon DocumentDB 提供有关数据库中每个已配置实例当前状况的信息。

您可以对 Amazon DocumentDB 实例查看的状态有三个类型：

• 实例状态：此状态显示在中集群表的 “状态” 列中， AWS Management Console 并显示实例的当前生命周期状况。状态中显示的值源自 DescribeDBCluster API 响应的 Status 字段。

• 实例运行状况：此状态显示在中集群表的 “实例运行状况” 列中， AWS Management Console 并显示数据库引擎（负责管理和检索数据的组件）是否正在运行。实例运行状况列中显示的值基于 Amazon CloudWatch EngineUptime 系统指标。

• 维护状态：此状态显示在中集群表的 “维护” 列中，表示需要应用于实例的任何维护事件的状态。 AWS Management Console 维护状态独立于其他实例的状态，并且源自 PendingMaintenanceAction API。有关维护状态的更多信息，请参阅维护 Amazon DocumentDB。

实例状态值

下表列出实例的可能状态值以及如何对每个状态计费。其中显示是否对实例和存储计费、只对存储向您计费，还是不向您计费。对于所有实例状态，始终会针对备份用量向您计费。

实例状态	已计费	描述
available	计费	实例正常和可用。
backing-up	计费	当前正在备份实例。
configuring-log-exports	计费	此实例已启用或禁用将 CloudWatch 日志文件发布到 Amazon Logs。
creating	不计费	正在创建实例。无法访问正在创建的实例。
deleting	不计费	正在删除实例。
failed	不计费	实例已失败，Amazon DocumentDB 无法恢复其。要恢复数据，请 point-in-time恢复到实例的最新可恢复时间。
inaccessible-encryption-credentials	不计费	无法访问用于加密或解密实例的密 AWS KMS 钥。
incompatible-network	不计费	Amazon DocumentDB 正尝试对实例执行恢复操作，但无法执行此操作，因为 VPC 正处于一种阻止此操作完成的状态。例如，如果子网中的所有可用 IP 地址都在使用中，并且 Amazon DocumentDB 无法为实例获取 IP 地址，就会出现此状态。
maintenance	计费	Amazon DocumentDB 正在对此实例应用维护更新。此状态用于 Amazon DocumentDB 预先计划的实例级别维护。我们将通过此状态评估向客户公开其他维护操作的方式。
modifying	计费	按照请求正在修改实例。
rebooting	计费	按照请求或需要重启实例的 Amazon DocumentDB 过程正在重启实例。
renaming	计费	按照请求正在重命名实例。
resetting-master-credentials	计费	按照请求正在重置实例的主凭证。
restore-error	计费	该实例在尝试从快照恢复 point-in-time或时遇到错误。
starting	对存储计费	实例正在启动。
stopped	对存储计费	实例已停止。
stopping	对存储计费	正在停止实例。
storage-full	计费	实例超出了其存储分配容量。这是一种严重状态，应立即修复；请通过修改实例来扩展存储。将 Amazon CloudWatch 警报设置为在存储空间不足时向您发出警告，这样您就不会遇到这种情况。

使用 AWS Management Console 或监控实例状态 AWS CLI

使用 AWS Management Console 或 AWS CLI 监控您的实例的状态。

Using the AWS Management Console

使用 AWS Management Console 来确定群集的状态时，请按以下步骤操作。

1. 登录 AWS Management Console，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com

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

   注意

   请注意，在集群导航框中，集群标识符列既显示集群又显示实例。实例列列于集群下，类似于下图。

   

3. 查找您感兴趣的实例的名称。然后，要查找实例的状态，请跨该行阅读至 Status (状态) 列，如下所示。

   

Using the AWS CLI

使用确定 AWS CLI 集群状态时，请使用describe-db-instances操作。以下代码可查找实例 sample-cluster-instance-01 的状态。

对于 Linux、macOS 或 Unix：

aws docdb describe-db-instances \
          --db-instance-identifier sample-cluster-instance-01  \
          --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'

对于 Windows：

aws docdb describe-db-instances ^
          --db-instance-identifier sample-cluster-instance-01  ^
          --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'

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

[
          [
              "sample-cluster-instance-01",
              "available"
          ]
      ]

实例运行状况值

下表列出了实例的可能运行状况值。实例运行状况列位于的 Clu st ers 表中 AWS Management Console，显示数据库引擎（负责存储、管理和检索数据的组件）是否运行正常。此列还指明中 CloudWatch提供的EngineUptime系统指标是否显示每个实例的运行状况。

实例运行状况	描述
正常	数据库引擎正在 Amazon DocumentDB 实例中运行。
运行状况不佳	数据库引擎未在运行或已在不到一分钟前重启。

使用监控实例的运行状况 AWS Management Console

使用 AWS Management Console 来监控您的实例的运行状况。

使用时 AWS Management Console，请按照以下步骤了解实例的运行状况。

1. 登录 AWS Management Console，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com

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

   注意

   在集群导航框中，集群标识符列既显示集群又显示实例。实例列列于集群下，类似于下图。

   

3. 查找您感兴趣的实例的名称。然后，要查找实例的状态，请跨该行阅读至 实例运行状况列，如下图所示：

   

   注意

   实例运行状况轮询每 60 秒进行一次，轮询基于 CloudWatch EngineUptime系统指标。实例运行状况列中的值自动更新。