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

# 监控 Amazon DocumentDB 实例的状态
<a name="monitoring_docdb-instance_status"></a>

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

您可以对 Amazon DocumentDB 实例查看的状态有三个类型：
+ 实例状态：此状态显示在中集群表的 “**状态**” 列中， AWS 管理控制台 并显示实例的当前生命周期状况。**状态**中显示的值源自 `DescribeDBCluster` API 响应的 `Status` 字段。
+ 实例运行状况：此状态显示在中集群表的 “**实例运行状况**” 列中， AWS 管理控制台 并显示数据库引擎（负责管理和检索数据的组件）是否正在运行。**实例运行状况**列中显示的值基于 Amazon CloudWatch `EngineUptime` 系统指标。
+ 维护状态：此状态显示在中集群表的 “**维护**” 列中，表示需要应用于实例的任何维护事件的状态。 AWS 管理控制台 维护状态独立于其他实例的状态，并且源自 `PendingMaintenanceAction` API。有关维护状态的更多信息，请参阅[维护 Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html)。

**Topics**
+ [实例状态值](#monitoring_docdb-instance_status-values)
+ [使用 AWS 管理控制台 或监控实例状态 AWS CLI](#monitoring-instance-status)
+ [实例运行状况值](#instance-health-status-values)
+ [使用监控实例的运行状况 AWS 管理控制台](#monitoring-instance-health-status)

## 实例状态值
<a name="monitoring_docdb-instance_status-values"></a>

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


| 实例状态 | 已计费 | 说明 | 
| --- | --- | --- | 
| 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 管理控制台 或监控实例状态 AWS CLI
<a name="monitoring-instance-status"></a>

使用 AWS 管理控制台 或 AWS CLI 监控您的实例的状态。

------
#### [ Using the AWS 管理控制台 ]

使用 AWS 管理控制台 来确定群集的状态时，请按以下步骤操作。

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

1. 在导航窗格中，选择**集群**。
**注意**  
请注意，在集群导航框中，**集群标识符**列既显示集群又显示实例。实例列列于集群下，类似于下图。  
![\[Amazon DocumentDB 控制台中“集群”页面上的集群和实例列表。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/clusters.png)

1. 查找您感兴趣的实例的名称。然后，要查找实例的状态，请跨该行阅读至 **Status (状态)** 列，如下所示。  
![\[“状态”列，其中显示了“集群”页面上集群和实例的可用状态。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/instance-status.png)

------
#### [ 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"
          ]
      ]
```

------

## 实例运行状况值
<a name="instance-health-status-values"></a>

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


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

## 使用监控实例的运行状况 AWS 管理控制台
<a name="monitoring-instance-health-status"></a>

使用 AWS 管理控制台 来监控您的实例的运行状况。

使用时 AWS 管理控制台，请按照以下步骤了解实例的运行状况。

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

1. 在导航窗格中，选择**集群**。
**注意**  
在**集群**导航框中，**集群标识符**列既显示集群又显示实例。实例列列于集群下，类似于下图。  
![\[Amazon DocumentDB 控制台中“集群”页面上的集群和实例列表。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/clusters.png)

1. 查找您感兴趣的实例的名称。然后，要查找实例的状态，请跨该行阅读至 **实例运行状况**列，如下图所示：  
![\[“实例运行状况”列，其中显示了“集群”页面上所列实例的正常和不正常状态。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/health-status-1.png)
**注意**  
实例运行状况轮询每 60 秒进行一次，轮询基于 CloudWatch `EngineUptime`系统指标。**实例运行状况**列中的值自动更新。