Monitoring an Amazon DocumentDB Cluster’s Status

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 AWS CLI describe-db-clusters command.

Cluster Status Values

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

Cluster Status	Description
`available`	The cluster is healthy and available.
`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 AWS 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 AWS Management Console

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

Sign in to the AWS Management Console, and open the Amazon DocumentDB console at https://console.aws.amazon.com/docdb.
In the navigation pane, choose Clusters.

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.
              ](/projects/DocumentDB-20201111-en/144057ee73540088f753b799d5e3a342.png)

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.
              ](/projects/DocumentDB-20201111-en/d69ee469e051795f0142807f2f4da68d.png)

Monitoring a Cluster’s Status Using the AWS CLI

When using the AWS 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"
    ]
]