本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理 Amazon DocumentDB 事件
Amazon DocumentDB（与 MongoDB 兼容）记录与集群、实例、快照、安全组和集群参数组相关的事件。此信息包含事件的日期和时间、事件的源名称和源类型以及一条与事件相关的消息。
**重要**
对于某些管理功能，Amazon DocumentDB 使用与 Amazon RDS 和 Amazon Neptune 共享的操作技术。区域限制是指在区域级别管理，在 Amazon DocumentDB、Amazon RDS 和 Amazon Neptune 之间共有的限制。有关更多信息，请参阅 [区域配额](limits.md#limits-regional_quotas)。
**Topics**
+ [查看 Amazon DocumentDB 事件类别](#viewing-event-categories)
+ [查看 Amazon DocumentDB 事件](#viewing-events)
## 查看 Amazon DocumentDB 事件类别
每种 Amazon DocumentDB 资源类型具有与其关联的特定类型的事件。您可以使用 AWS CLI `describe-event-categories` 操作查看事件类型和 Amazon DocumentDB 资源类型之间的映射。
**参数**
+ **--source-type**—可选。可以使用 `--source-type` 参数查看特定源类型的事件类别。以下是允许的值：
+ `db-cluster`
+ `db-instance`
+ `db-parameter-group`
+ `db-security-group`
+ `db-cluster-snapshot`
+ **--filters**—可选。要仅查看 Amazon DocumentDB 的事件类别，请使用筛选器 `--filter Name=engine,Values=docdb`。
**Example**
以下代码列出了与集群关联的事件类别。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-event-categories \
--filter Name=engine,Values=docdb \
--source-type db-cluster
```
对于 Windows：
```
aws docdb describe-event-categories ^
--filter Name=engine,Values=docdb ^
--source-type db-cluster
```
此操作的输出将类似于下文（JSON 格式）。
```
{
"EventCategoriesMapList": [
{
"EventCategories": [
"notification",
"failure",
"maintenance",
"failover"
],
"SourceType": "db-cluster"
}
]
}
```
以下代码列出了与每种 Amazon DocumentDB 源类型关联的事件类别。
```
aws docdb describe-event-categories
```
此操作的输出将类似于下文（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"
]
}
]
}
```
## 查看 Amazon DocumentDB 事件
您可通过 Amazon DocumentDB 控制台（显示过去 24 小时的事件）检索 Amazon DocumentDB 资源的事件。您还可以通过使用 [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI 命令或 [DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html) Amazon DocumentDB API 操作来检索 Amazon DocumentDB 资源的事件。如果您使用 AWS CLI 或 Amazon DocumentDB API 查看事件，则可检索长达过去 14 天的事件。
------
#### [ Using the AWS 管理控制台 ]
**查看过去 24 小时的所有 Amazon DocumentDB 实例事件**
1. 登录到AWS 管理控制台并打开 Amazon DocumentDB 控制台，网址：[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。
1. 在导航窗格中，选择 **Events (事件)**。列表中显示可用的事件。
1. 使用 **Filter (筛选条件)** 列表按类型筛选事件。在文本框中输入期限以进一步筛选结果。例如，以下屏幕截图显示针对*快照*事件筛选所有 Amazon DocumentDB 事件。
![\[显示为快照筛选事件的事件部分的屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/events-filtering.png)
------
#### [ Using the AWS CLI ]
**查看过去 7 天的所有 Amazon DocumentDB 实例事件**
通过使用 [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI 命令并将 `--duration` 参数设置为 `10080` （10,080 分钟），您可查看过去 7 天的所有 Amazon DocumentDB 实例事件。
```
aws docdb describe-events --duration 10080
```
**筛选 Amazon DocumentDB 事件**
要查看特定 Amazon DocumentDB 事件，请使用带有以下参数的 `describe-events` 操作。
**参数**
+ **--filter**—必需，用于限制 Amazon DocumentDB 事件的返回值。使用 **Name=engine,Values=docdb** 仅筛选 Amazon DocumentDB 的所有事件。
+ **--source-identifier**—可选。为其返回事件的事件源的标识符。如果省略，则在结果中包含来自所有源的事件。
+ **--source-type**—可选，除非提供 `--source-identifier`，则为必需。如果提供 `--source-identifier`，则 `--source-type` 必须与 `--source-identifier` 的类型一致。以下是允许的值：
+ `db-cluster`
+ `db-instance`
+ `db-parameter-group`
+ `db-security-group`
+ `db-cluster-snapshot`
以下示例列出您的所有 Amazon DocumentDB 事件。
```
aws docdb describe-events --filters Name=engine,Values=docdb
```
此操作的输出将类似于下文（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"
]
}
]
}
```
------
有关更多信息，请参阅 [审核 Amazon DocumentDB 事件](event-auditing.md)。