本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 監控 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>

下表列出執行個體的可能狀態值，以及每種狀態的計費方式。表中列出是否將依執行個體和儲存體計費、只針對儲存體計費、或不計費。在所有執行個體狀態下，一律要為備份用途付費。


| 執行個體狀態 | 計費 | Description | 
| --- | --- | --- | 
| available | 計費 | 執行個體運作正常可供使用。 | 
| backing-up | 計費 | 目前正在備份執行個體。 | 
| configuring-log-exports | 計費 | 正在啟用或停用此執行個體的 Amazon CloudWatch Logs 發佈日誌檔案。 | 
| creating | 不計費 | 正在建立執行個體。當執行個體正在建立時，無法存取執行個體。 | 
| deleting | 不計費 | 正在刪除執行個體。 | 
| failed | 不計費 | 執行個體失敗，Amazon DocumentDB 無法復原它。若要復原資料，請執行時間點還原，還原到執行個體最近一次可還原時間。 | 
| 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 | 計費 | 執行個體在嘗試還原到某個時間點或從快照還原時發生錯誤。 | 
| 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 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇**叢集**。
**注意**  
請注意，在叢集導覽方塊中，欄位**叢集識別符**會顯示叢集和執行個體。執行個體會列在叢集下方，如下圖所示。  
![\[Amazon DocumentDB 主控台中叢集頁面上的叢集和執行個體清單。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/clusters.png)

1. 尋找您感興趣的執行個體名稱。然後，閱讀該列上的 **Status (狀態)** 欄找出執行個體的狀態，如下所示。  
![\[狀態欄顯示叢集頁面上叢集和執行個體的可用狀態。\]](http://docs.aws.amazon.com/zh_tw/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>

下表列出執行個體的可能運作狀態值。位於 **叢集**資料表中的**執行個體運作**狀態欄 AWS 管理主控台會顯示資料庫引擎、負責儲存、管理和擷取資料的元件是否正常運作。此欄也會指出 CloudWatch 中可用的`EngineUptime`系統指標是否顯示每個執行個體的運作狀態。


| 執行個體運作狀態 | Description | 
| --- | --- | 
| 狀態良好 | 資料庫引擎正在 Amazon DocumentDB 執行個體中執行。 | 
| 運作狀態不佳 | 資料庫引擎未執行或在一分鐘內重新啟動。 | 

## 使用 監控執行個體運作狀態 AWS 管理主控台
<a name="monitoring-instance-health-status"></a>

使用 AWS 管理主控台 來監控執行個體的運作狀態。

使用 時 AWS 管理主控台，請使用下列步驟來了解執行個體的運作狀態。

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇**叢集**。
**注意**  
在**叢集**導覽方塊中，欄位**叢集識別符**會顯示叢集和執行個體。執行個體會列在叢集下方，如下圖所示。  
![\[Amazon DocumentDB 主控台中叢集頁面上的叢集和執行個體清單。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/clusters.png)

1. 尋找您感興趣的執行個體名稱。然後，若要尋找執行個體的狀態，請讀取該列中的**執行個體運作**狀態欄，如下圖所示：  
![\[執行個體運作狀態欄顯示叢集頁面上所列執行個體的運作狀態良好和運作狀態不佳。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/health-status-1.png)
**注意**  
執行個體運作狀態輪詢每 60 秒進行一次，並以 CloudWatch `EngineUptime`系統指標為基礎。**執行個體運作**狀態欄中的值會自動更新。