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 Clusters no 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 campo de Status da resposta da API DescribeDBCluster.

• Status de integridade da instância: esse status é mostrado na coluna Integridade da instância da tabela Clusters 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 Integridade da instância são baseados na métrica do sistema EngineUptime do Amazon CloudWatch.

• Status de manutenção: esse status é mostrado na coluna Manutenção da tabela Clusters no 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 da API PendingMaintenanceAction. 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 dos arquivos de log no Amazon CloudWatch Logs está sendo habilitada ou desabilitada para essa instância de banco de dados.
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, execute uma restauração point-in-time no último momento restaurável da instância.
inaccessible-encryption-credentials	Não faturado	A chave do AWS KMS que é usada para criptografar ou descriptografar a instância não pôde ser acessada.
incompatible-network	Não faturado	O Amazon DocumentDB está tentando executar uma ação de recuperação em uma instância, mas não consegue fazer isso porque a VPC está em um estado que impede a conclusão da ação. 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 um determinado point-in-time ou 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. Configure os alarmes do Amazon CloudWatch para adverti-lo quando o espaço de armazenamento estiver ficando baixo, para evitar essa situação.

Monitorar o status de uma instância usando o AWS Management Console ou AWS CLI

Para monitorar o status da instância, use AWS Management Console ou AWS CLI.

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.

   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 a AWS CLI para determinar o status de um cluster, use a operação describe-db-instances. 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 do sistema EngineUptime, disponível no CloudWatch, está mostrando o status de integridade 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.

Monitorar o status de uma instância usando o AWS Management Console

Para monitorar o status de integridade de sua instância, consulte AWS Management Console.

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

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.

   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 sistema EngineUptime do CloudWatch. Os valores na coluna Integridade da instância são atualizados automaticamente.