Monitoramento do status de um cluster do Amazon DocumentDB - Amazon DocumentDB
Valores de status do clusterMonitorar o status de um cluster

Monitoramento do status de um cluster do Amazon DocumentDB

O status de um cluster indica a integridade do cluster. Você pode visualizar o status de um cluster usando o console do Amazon DocumentDB ou o comando describe-db-clusters da AWS CLI.

Valores de status do cluster

A tabela a seguir lista os valores válidos para o status de um cluster.

cluster status (status do cluster) Descrição
active O cluster está ativo. Esse status se aplica somente a clusters elásticos.
available O cluster está íntegro e disponível. Esse status se aplica somente a clusters baseados em instâncias.
backing-up O backup do cluster está sendo executado no momento.
creating O cluster está sendo criado. Ele fica inacessível enquanto está sendo criado.
deleting O cluster está sendo excluído. Ele fica inacessível enquanto está sendo excluído.
failing-over Um failover da instância principal para uma réplica do Amazon DocumentDB está sendo executado.
inaccessible-encryption-credentials A chave do AWS KMS usada para criptografar ou descriptografar o cluster não pode ser acessada.
maintenance Uma atualização de manutenção está sendo aplicada ao cluster. Esse status é usado para a manutenção em nível de cluster que o Amazon DocumentDB programa com antecedência.
migrating Um snapshot do cluster está sendo restaurado em um cluster.
migration-failed Ocorreu uma falha na migração.
modifying O cluster está sendo modificado devido a uma solicitação do cliente para modificá-lo.
renaming O cluster está sendo renomeado devido a uma solicitação do cliente para renomeá-lo.
resetting-master-credentials As credenciais principais do cluster estão sendo redefinidas devido a uma solicitação do cliente para redefini-las.
upgrading A versão do mecanismo do cluster está sendo atualizada.

Monitorar o status de um cluster

Using the AWS Management Console

Ao usar a AWS Management Console para determinar o status de um cluster, use o procedimento a seguir.

  1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

  2. No painel de navegação, escolha Clusters.

  3. Na caixa de navegação Clusters, você verá a coluna Identificador do cluster. Suas instâncias estão listadas em clusters, semelhante à captura de tela abaixo.

    Captura de tela da página de clusters com exemplo de cluster mostrando o status ativo.

  4. Na coluna Identificador de cluster, encontre o nome da instância desejada. Em seguida, para localizar o status da instância, leia essa linha para a coluna Status, como mostrado a seguir.

    Captura de tela da página de clusters com exemplo de cluster mostrando o status ativo.
Using the AWS CLI

Ao usar a AWS CLI para determinar o status de um cluster, use a operação describe-db-clusters. O código a seguir descobre o status do cluster sample-cluster.

Para Linux, macOS ou Unix:

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

Para Windows:

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

A saída dessa operação é semelhante à seguinte.

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