管理 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.aws.amazon.com/docdb。

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

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

   ![

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

使用 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 事件。