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

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

管理 Amazon DocumentDB 事件

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

重要

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

查看 Amazon DocumentDB 事件类别

每种 Amazon DocumentDB 资源类型与特定类型的事件关联。您可以将Amazon CLI describe-event-categories操作,查看事件类型和 Amazon DocumentDB 资源类型之间的映射。

Parameters

  • --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 资源的事件。Amazon DocumentDB 还可以通过使用describe-events Amazon CLI命令或DescribeEventsAmazon DocumentDB API 操作。如果您使用Amazon CLI或 Amazon DocumentDB API 查看事件,则可检索过去长达 14 天内的事件。

使用 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 (筛选条件) 列表按类型筛选事件。在文本框中输入期限以进一步筛选结果。例如,以下屏幕截图显示筛选snapshot事件.

    
                     显示为快照筛选事件的事件部分的屏幕截图。

使用 Amazon CLI

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

您可查看过去 7 天的所有 Amazon DocumentDB 实例事件,方法是运行describe-events Amazon CLI操作--duration将参数设置为10080(10,080 分钟).

aws docdb describe-events --duration 10080

筛选 Amazon DocumentDB 事件

要查看特定的 Amazon DocumentDB 事件,请使用describe-events操作。

Parameters

  • --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 事件