Monitoramento do status de uma instância do Amazon DocumentDB

O Amazon DocumentDB fornece informações sobre a condição atual de cada instância configurada no banco de dados.

Há três tipos de status que você pode visualizar para uma instância do Amazon DocumentDB:

• Status da instância: esse status é mostrado na coluna Status da tabela de cluster AWS Management Console e mostra a condição atual do ciclo de vida da instância. Os valores mostrados na coluna Status são derivados do Status campo da DescribeDBCluster API resposta.

• Status de integridade da instância: esse status é mostrado na coluna Integridade da instância da tabela de cluster no AWS Management Console e mostra se o mecanismo de banco de dados, o componente responsável por gerenciar e recuperar dados, está em execução. Os valores mostrados na coluna Instance health são baseados na métrica CloudWatch EngineUptime do sistema Amazon.

• Status de manutenção: esse status é mostrado na coluna Manutenção da tabela de cluster AWS Management Console e indica o status de qualquer evento de manutenção que precise ser aplicado a uma instância. O status de manutenção é independente do status da outra instância e é derivado do PendingMaintenanceActionAPI. Para obter mais informações sobre o status de manutenção, consulte Manutenção do Amazon DocumentDB.

Valores de status de instâncias

A tabela a seguir lista os possíveis valores de status de instâncias e como cada status é cobrado. Ela mostra se você será cobrado pela instância e pelo armazenamento, somente pelo armazenamento ou se não será cobrado. Para todos os status de instância, você sempre será cobrado pelo uso de backup.

Status da instância	Faturado	Descrição
available	Faturado	A instância está íntegra e disponível.
backing-up	Faturado	No momento, está sendo feito o backup da instância.
configuring-log-exports	Faturado	A publicação de arquivos de log no Amazon CloudWatch Logs está sendo ativada ou desativada para essa instância.
creating	Não faturado	A instância está sendo criada. A instância não fica inacessível enquanto está sendo criada.
deleting	Não faturado	A instância está sendo excluída.
failed	Não faturado	Houve falha na instância e o Amazon DocumentDB não pôde recuperá-la. Para recuperar os dados, faça uma point-in-time restauração no horário restaurável mais recente da instância.
inaccessible-encryption-credentials	Não faturado	A AWS KMS chave usada para criptografar ou descriptografar a instância não pôde ser acessada.
incompatible-network	Não faturado	O Amazon DocumentDB está tentando realizar uma ação de recuperação em uma instância, mas não consegue fazer isso porque VPC está em um estado que impede que a ação seja concluída. Este status pode ocorrer se, por exemplo, todos os endereços IP disponíveis em uma sub-rede estiverem em uso e o Amazon DocumentDB for incapaz de obter um endereço IP para a instância.
maintenance	Faturado	O Amazon DocumentDB está aplicando uma atualização de manutenção na instância de banco de dados. Este status é usado para a manutenção de nível de instância que o Amazon DocumentDB agenda com antecedência. Estamos avaliando maneiras de expor ações adicionais de manutenção para clientes com este status.
modifying	Faturado	A instância está sendo alterada devido a uma solicitação.
rebooting	Faturado	A instância está sendo reinicializada devido a uma solicitação ou a um processo do Amazon DocumentDB que exige a reinicialização da instância.
renaming	Faturado	A instância está sendo renomeada devido a uma solicitação.
resetting-master-credentials	Faturado	As credenciais principais da instância estão sendo redefinidas devido a uma solicitação.
restore-error	Faturado	A instância encontrou um erro ao tentar restaurar para point-in-time ou a partir de um snapshot.
starting	Faturado para armazenamento	A instância está iniciando.
stopped	Faturado para armazenamento	A instância está interrompida.
stopping	Faturado para armazenamento	A instância está sendo interrompida.
storage-full	Faturado	A instância alcançou sua alocação de capacidade de armazenamento. Este é um status crítico e deve ser resolvido imediatamente. Você deve aumentar o armazenamento verticalmente modificando a instância. Defina CloudWatch os alarmes da Amazon para avisá-lo quando o espaço de armazenamento estiver ficando baixo, para que você não se depare com essa situação.

Monitorando o status da instância usando o AWS Management Console ou AWS CLI

Use o AWS Management Console ou AWS CLI para monitorar o status da sua instância.

Using the AWS Management Console

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

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

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

   nota

   Observe que, na caixa de navegação Clusters, a coluna Identificador do cluster mostra tanto os clusters quanto as instâncias. As instâncias estão listadas embaixo dos clusters, semelhante à captura de tela abaixo.

   

3. Encontre o nome da instância de seu interesse. Em seguida, para localizar o status da instância, leia essa linha para a coluna Status, como mostrado a seguir.

   

Using the AWS CLI

Ao usar o AWS CLI para determinar o status de um cluster, use a describe-db-instances operação. O código a seguir verifica o status da instância sample-cluster-instance-01.

Para Linux, macOS ou Unix:

aws docdb describe-db-instances \
          --db-instance-identifier sample-cluster-instance-01  \
          --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'

Para Windows:

aws docdb describe-db-instances ^
          --db-instance-identifier sample-cluster-instance-01  ^
          --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'

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

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

Status de integridade da instância

A tabela a seguir lista os valores possíveis do status de integridade das instâncias. A coluna Integridade da instância, localizada na tabela Clusters no AWS Management Console, mostra se o mecanismo de banco de dados, o componente responsável por armazenar, gerenciar e recuperar dados, está operando normalmente. Essa coluna também indica se a métrica EngineUptime do sistema, disponível em CloudWatch, está mostrando o status de saúde de cada instância.

Status de integridade da instância	Descrição
integridade	O mecanismo de banco de dados está sendo executado na instância do Amazon DocumentDB.
não íntegro	O mecanismo de banco de dados não está funcionando ou foi reiniciado há menos de um minuto.

Monitorando o status de integridade da instância usando o AWS Management Console

Use o AWS Management Console para monitorar o status de saúde da sua instância.

Ao usar AWS Management Console, use as etapas a seguir para entender o status de integridade da instância.

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

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

   nota

   Na caixa de navegação Clusters, a coluna Identificador do cluster mostra tanto os clusters quanto as instâncias. As instâncias estão listadas embaixo dos clusters, semelhante à captura de tela abaixo.

   

3. Encontre o nome da instância de seu interesse. Em seguida, para localizar o status da instância, leia essa linha cruzando com a coluna Status, como mostrado a seguir:

   

   nota

   A pesquisa do status de integridade da instância ocorre a cada 60 segundos e é baseada na métrica do CloudWatch EngineUptime sistema. Os valores na coluna Integridade da instância são atualizados automaticamente.