Monitoring an Amazon DocumentDB cluster's status - Amazon DocumentDB
Cluster status valuesMonitoring a cluster's status
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Monitoring an Amazon DocumentDB cluster's status

The status of a cluster indicates the health of the cluster. You can view the status of a cluster by using the Amazon DocumentDB console or the Amazon CLI describe-db-clusters command.

Cluster status values

The following table lists the valid values for a cluster's status.

Cluster Status Description
active The cluster is active. This status applies to elastic clusters only.
available The cluster is healthy and available. This status applies to instance-based clusters only.
backing-up The cluster is currently being backed up.
creating The cluster is being created. It is inaccessible while it is being created.
deleting The cluster is being deleted. It is inaccessible while it is being deleted.
failing-over A failover from the primary instance to an Amazon DocumentDB replica is being performed.
inaccessible-encryption-credentials The Amazon KMS key used to encrypt or decrypt the cluster can't be accessed.
maintenance A maintenance update is being applied to the cluster. This status is used for cluster-level maintenance that Amazon DocumentDB schedules well in advance.
migrating A cluster snapshot is being restored to a cluster.
migration-failed A migration failed.
modifying The cluster is being modified because of a customer request to modify the cluster.
renaming The cluster is being renamed because of a customer request to rename it.
resetting-master-credentials The master credentials for the cluster are being reset because of a customer request to reset them.
upgrading The cluster engine version is being upgraded.

Monitoring a cluster's status

Using the Amazon Web Services Management Console

When using the Amazon Web Services Management Console to determine the status of a cluster, use the following procedure.

  1. Sign in to the Amazon Web Services Management Console, and open the Amazon DocumentDB console at https://console.amazonaws.cn/docdb.

  2. In the navigation pane, choose Clusters.

  3. In the Clusters navigation box, you'll see the column Cluster identifier. Your instances are listed under clusters, similar to the screenshot below.

    Screenshot of clusters page with sample-cluster showing active status.

  4. In the Cluster identifier column, find the name of the instance that you are interested in. Then, to find the status of the instance, read across that row to the Status column, as shown below.

    Screenshot of clusters page with sample-cluster showing active status.
Using the Amazon CLI

When using the Amazon CLI to determine the status of a cluster, use the describe-db-clusters operation. The following code finds the status of the cluster sample-cluster.

For Linux, macOS, or Unix:

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster  \
    --query 'DBClusters[*].[DBClusterIdentifier,Status]'

For Windows:

aws docdb describe-db-clusters ^
    --db-cluster-identifier sample-cluster  ^
    --query 'DBClusters[*].[DBClusterIdentifier,Status]'

Output from this operation looks something like the following.

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