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

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

管理 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:

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-snapshot", "EventCategories": [ "notification", "creation", "deletion", "restoration" ] }, { "SourceType": "db-cluster", "EventCategories": [ "notification", "failure", "maintenance", "failover" ] }, { "SourceType": "db-cluster-snapshot", "EventCategories": [ "backup" ] } ] }

查看 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.amazonaws.cn/docdb

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

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

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

使用 AWS CLI

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

通过运行 describe-events AWS CLI 操作并将 --duration 参数设置为 10080(10080 分钟),您可查看过去 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-snapshot

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