管理 Amazon DocumentDB 事件 - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

管理 Amazon DocumentDB 事件

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

重要

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

查看 Amazon DocumentDB 事件类别

每种 Amazon DocumentDB 资源类型具有与其关联的特定类型的事件。您可以使用 Amazon 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

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

对于 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 Amazon CLI 命令或 DescribeEvents Amazon DocumentDB API 操作来检索 Amazon DocumentDB 资源的事件。如果您使用 Amazon CLI 或 Amazon DocumentDB API 查看事件,则可检索长达过去 14 天的事件。

Using the Amazon Web Services Management Console
查看过去 24 小时的所有 Amazon DocumentDB 实例事件
  1. 登录到Amazon Web Services Management Console并打开 Amazon DocumentDB 控制台,网址:https://console.aws.amazon.com/docdb

  2. 在导航窗格中,选择 Events (事件)。列表中显示可用的事件。

  3. 使用 Filter (筛选条件) 列表按类型筛选事件。在文本框中输入期限以进一步筛选结果。例如,以下屏幕截图显示针对快照事件筛选所有 Amazon DocumentDB 事件。

    
                                   显示为快照筛选事件的事件部分的屏幕截图。
Using the Amazon CLI
查看过去 7 天的所有 Amazon DocumentDB 实例事件

通过使用 describe-events Amazon 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 活动