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á.
# Gerenciando eventos do Amazon DocumentDB
O Amazon DocumentDB (compatível com MongoDB) mantém um registro de eventos que se relacionam a seus clusters, instâncias, snapshots, grupos de segurança e grupos de parâmetros do cluster. Essas informações incluem a data e a hora do evento, o nome e o tipo de origem do evento, além de uma mensagem que está associada ao evento.
**Importante**
Para determinados recursos de gerenciamento, o Amazon DocumentDB usa a tecnologia operacional que é compartilhada com o Amazon RDS e o Amazon Neptune. Os limites de região, limites que são governados no nível da Região, são compartilhados entre o Amazon DocumentDB, o Amazon RDS e o Amazon Neptune. Para obter mais informações, consulte [Cotas regionais](limits.md#limits-regional_quotas).
**Topics**
+ [Visualização das categorias de eventos do Amazon DocumentDB](#viewing-event-categories)
+ [Visualizando eventos do Amazon DocumentDB](#viewing-events)
## Visualização das categorias de eventos do Amazon DocumentDB
Cada tipo de recurso do Amazon DocumentDB tem tipos específicos de eventos que podem ser associados a ele. Você pode usar a operação de AWS CLI `describe-event-categories` para visualizar o mapeamento entre os tipos de evento e os tipos de recursos do Amazon DocumentDB.
**Parâmetros**
+ **--source-type**—Opcional. Use o parâmetro `--source-type` para ver as categorias de evento para um determinado tipo de origem. Os seguintes valores são permitidos:
+ `db-cluster`
+ `db-instance`
+ `db-parameter-group`
+ `db-security-group`
+ `db-cluster-snapshot`
+ **--filters**—Opcional. Para visualizar as categorias de eventos apenas do Amazon DocumentDB, use o filtro `--filter Name=engine,Values=docdb`.
**Example**
O código a seguir lista as categorias de eventos associadas aos clusters.
Para Linux, macOS ou Unix:
```
aws docdb describe-event-categories \
--filter Name=engine,Values=docdb \
--source-type db-cluster
```
Para Windows:
```
aws docdb describe-event-categories ^
--filter Name=engine,Values=docdb ^
--source-type db-cluster
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"EventCategoriesMapList": [
{
"EventCategories": [
"notification",
"failure",
"maintenance",
"failover"
],
"SourceType": "db-cluster"
}
]
}
```
O código a seguir lista as categorias de eventos associadas a cada tipo de origem do Amazon DocumentDB.
```
aws docdb describe-event-categories
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"EventCategoriesMapList": [
{
"SourceType": "db-instance",
"EventCategories": [
"notification",
"failure",
"creation",
"maintenance",
"deletion",
"recovery",
"restoration",
"configuration change",
"read replica",
"backtrack",
"low storage",
"backup",
"availability",
"failover"
]
},
{
"SourceType": "db-security-group",
"EventCategories": [
"configuration change",
"failure"
]
},
{
"SourceType": "db-parameter-group",
"EventCategories": [
"configuration change"
]
},
{
"SourceType": "db-cluster",
"EventCategories": [
"notification",
"failure",
"maintenance",
"failover"
]
},
{
"SourceType": "db-cluster-snapshot",
"EventCategories": [
"backup"
]
}
]
}
```
## Visualizando eventos do Amazon DocumentDB
Você pode recuperar eventos para seus recursos do Amazon DocumentDB pelo console do Amazon DocumentDB, que mostra eventos das últimas 24 horas. Você também pode recuperar eventos para seus recursos do Amazon DocumentDB usando o comando [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI ou a operação [DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html) da API do Amazon DocumentDB. Se você usar a AWS CLI ou a API Amazon DocumentDB para visualizar eventos, poderá recuperar eventos até os últimos 14 dias.
------
#### [ Using the Console de gerenciamento da AWS ]
**Para visualizar todos os eventos de instâncias do Amazon DocumentDB nas últimas 24 horas**
1. Faça login no Console de gerenciamento da AWS e abra 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 **Eventos**. Os eventos disponíveis aparecem em uma lista.
1. Use a lista **Filtro** para filtrar os eventos por tipo. Insira um termo na caixa de texto para filtrar os resultados. Por exemplo, a captura de tela a seguir mostra a filtragem de todos os eventos do Amazon DocumentDB para eventos *snapshot*.
![\[Captura de tela da seção de eventos mostrando eventos de filtragem para snapshots.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/events-filtering.png)
------
#### [ Using the AWS CLI ]
**Para visualizar todos os eventos de instância do Amazon DocumentDB dos últimos 7 dias**
Você pode visualizar todos os eventos de instância do Amazon DocumentDB dos últimos 7 dias executando a operação [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI com o parâmetro `--duration` definido como `10080` (10.080 minutos).
```
aws docdb describe-events --duration 10080
```
**Filtragem para eventos do Amazon DocumentDB**
Para ver os eventos específicos do Amazon DocumentDB, use a operação `describe-events` com os seguintes parâmetros.
**Parâmetros**
+ **--filter**—Necessário para limitar os valores retornados ao evento Amazon DocumentDB. Use **Name=engine,Values=docdb** para filtrar todos os eventos somente para o Amazon DocumentDB.
+ **--source-identifier**—Opcional. O identificador da origem do evento para o qual os eventos são retornados. Se omitido, os eventos de todas as origens são incluídos nos resultados.
+ **--source-type**—Opcional, a menos que `--source-identifier` seja fornecido, então é necessário. Se `--source-identifier` for fornecido, `--source-type` deve estar de acordo com o tipo do `--source-identifier`. Os seguintes valores são permitidos:
+ `db-cluster`
+ `db-instance`
+ `db-parameter-group`
+ `db-security-group`
+ `db-cluster-snapshot`
O exemplo a seguir lista todos os eventos do Amazon DocumentDB.
```
aws docdb describe-events --filters Name=engine,Values=docdb
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"Events": [
{
"SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3",
"Message": "instance created",
"SourceType": "db-instance",
"Date": "2018-12-11T21:17:40.023Z",
"SourceIdentifier": "sample-cluster-instance3",
"EventCategories": [
"creation"
]
},
{
"SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
"Message": "instance shutdown",
"SourceType": "db-instance",
"Date": "2018-12-11T21:25:01.245Z",
"SourceIdentifier": "docdb-2018-12-11-21-08-23",
"EventCategories": [
"availability"
]
},
{
"SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
"Message": "instance restarted",
"SourceType": "db-instance",
"Date": "2018-12-11T21:25:11.441Z",
"SourceIdentifier": "docdb-2018-12-11-21-08-23",
"EventCategories": [
"availability"
]
}
]
}
```
------
Para obter mais informações, consulte [Auditar eventos do Amazon DocumentDB](event-auditing.md).