管理 Amazon DocumentDB 事件

Amazon DocumentDB（与 MongoDB 兼容） 记录与集群、实例、快照、安全组和集群参数组相关的事件。此信息包含事件的日期和时间、事件的源名称和源类型以及一条与事件相关的消息。

重要

对于某些管理功能，Amazon DocumentDB 使用与 Amazon RDS 和 Amazon Neptune 共享的操作技术。区域限制是指在区域级别管理，在 Amazon DocumentDB、Amazon RDS 和 Amazon Neptune 之间共有的限制。有关更多信息，请参阅区域配额。

查看 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-snapshot
  • db-cluster-snapshot
  • --filters — 可选。要仅查看 Amazon DocumentDB 的事件类别，请使用筛选器 --filter Name=engine,Values=docdb。

以下代码列出了与集群关联的事件类别。

对于 Linux、macOS 或 Unix:


1. aws docdb describe-event-categories \
2. --filter Name=engine,Values=docdb \
3. --source-type db-cluster

对于 Windows:


1. aws docdb describe-event-categories ^
2. --filter Name=engine,Values=docdb ^
3. --source-type db-cluster

此操作的输出将类似于下文（JSON 格式）。


1. {
2. "EventCategoriesMapList": [
3. {
4. "EventCategories": [
5. "notification",
6. "failure",
7. "maintenance",
8. "failover"
9. ],
10. "SourceType": "db-cluster"
11. }
12. ]
13. }

以下代码列出了与每种 Amazon DocumentDB 源类型关联的事件类别。


1. aws docdb describe-event-categories

此操作的输出将类似于下文（JSON 格式）。


1. {
2. "EventCategoriesMapList": [
3. {
4. "SourceType": "db-instance",
5. "EventCategories": [
6. "notification",
7. "failure",
8. "creation",
9. "maintenance",
10. "deletion",
11. "recovery",
12. "restoration",
13. "configuration change",
14. "read replica",
15. "backtrack",
16. "low storage",
17. "backup",
18. "availability",
19. "failover"
20. ]
21. },
22. {
23. "SourceType": "db-security-group",
24. "EventCategories": [
25. "configuration change",
26. "failure"
27. ]
28. },
29. {
30. "SourceType": "db-parameter-group",
31. "EventCategories": [
32. "configuration change"
33. ]
34. },
35. {
36. "SourceType": "db-snapshot",
37. "EventCategories": [
38. "notification",
39. "creation",
40. "deletion",
41. "restoration"
42. ]
43. },
44. {
45. "SourceType": "db-cluster",
46. "EventCategories": [
47. "notification",
48. "failure",
49. "maintenance",
50. "failover"
51. ]
52. },
53. {
54. "SourceType": "db-cluster-snapshot",
55. "EventCategories": [
56. "backup"
57. ]
58. }
59. ]
60. }

查看 Amazon DocumentDB 事件

您可通过 Amazon DocumentDB控制台（显示过去 24 小时的事件）检索 Amazon DocumentDB资源的事件。还可通过使用 describe-events AWS CLI 命令或 DescribeEvents Amazon DocumentDB API 操作来检索 Amazon DocumentDB 资源的事件。如果您使用 AWS CLI 或 Amazon DocumentDB API 查看事件，则可检索过去长达 14 天内的事件。

使用 AWS 管理控制台

查看过去 24 小时的所有 Amazon DocumentDB 实例事件

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb。
  2. 在导航窗格中，选择 Events。列表中显示可用的事件。
  3. 使用 Filter (筛选条件) 列表按类型筛选事件。在文本框中输入期限以进一步筛选结果。例如，以下屏幕截图显示为快照 事件筛选所有 Amazon DocumentDB事件。

![

```

  1. 显示为快照筛选事件的事件部分的屏幕截图。
  2. ](/projects/DocumentDB-20201111-zh/93920adc01830e4ba5a170091a201916.png) ```

使用 AWS CLI

查看过去 7 天的所有 Amazon DocumentDB实例事件

通过运行 describe-events AWS CLI 操作并将 --duration 参数设置为 10080（10080 分钟），您可查看过去 7 天的所有 Amazon DocumentDB 实例事件。


1. 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-snapshot
  • db-cluster-snapshot

以下示例列出您的所有 Amazon DocumentDB事件。


1. aws docdb describe-events --filters Name=engine,Values=docdb

此操作的输出将类似于下文（JSON 格式）。


1. {
2. "Events": [
3. {
4. "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3",
5. "Message": "instance created",
6. "SourceType": "db-instance",
7. "Date": "2018-12-11T21:17:40.023Z",
8. "SourceIdentifier": "sample-cluster-instance3",
9. "EventCategories": [
10. "creation"
11. ]
12. },
13. {
14. "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
15. "Message": "instance shutdown",
16. "SourceType": "db-instance",
17. "Date": "2018-12-11T21:25:01.245Z",
18. "SourceIdentifier": "docdb-2018-12-11-21-08-23",
19. "EventCategories": [
20. "availability"
21. ]
22. },
23. {
24. "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
25. "Message": "instance restarted",
26. "SourceType": "db-instance",
27. "Date": "2018-12-11T21:25:11.441Z",
28. "SourceIdentifier": "docdb-2018-12-11-21-08-23",
29. "EventCategories": [
30. "availability"
31. ]
32. }
33. ]
34. }

有关更多信息，请参阅 审核 Amazon DocumentDB 事件。