As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# 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 Console de gerenciamento da AWS 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 de cluster no Console de gerenciamento da AWS 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 Console de gerenciamento da AWS 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](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html).
**Topics**
+ [Valores de status de instâncias](#monitoring_docdb-instance_status-values)
+ [Monitorando o status da instância usando o Console de gerenciamento da AWS ou AWS CLI](#monitoring-instance-status)
+ [Status de integridade da instância](#instance-health-status-values)
+ [Monitorando o status de integridade da instância usando o Console de gerenciamento da AWS](#monitoring-instance-health-status)
## 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 | Description |
| --- | --- | --- |
| 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 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 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. É necessário 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 Console de gerenciamento da AWS ou AWS CLI
Use o Console de gerenciamento da AWS ou AWS CLI para monitorar o status da sua instância.
------
#### [ Using the Console de gerenciamento da AWS ]
Ao usar o Console de gerenciamento da AWS para determinar o status de um cluster, use o procedimento a seguir.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. 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.
![\[Lista de clusters e instâncias na página Clusters no console do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/clusters.png)
1. 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.
![\[Coluna Status, mostrando o status disponível para clusters e instâncias na página Clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/instance-status.png)
------
#### [ 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 Console de gerenciamento da AWS, 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 | Description |
| --- | --- |
| 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 Console de gerenciamento da AWS
Use o Console de gerenciamento da AWS para monitorar o status de saúde da sua instância.
Ao usar Console de gerenciamento da AWS, use as etapas a seguir para entender o status de integridade da instância.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. 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.
![\[Lista de clusters e instâncias na página Clusters no console do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/clusters.png)
1. 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:
![\[Coluna Integridade da instância, mostrando os estados íntegros e não íntegros das instâncias listadas na página Clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/health-status-1.png)
**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.