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-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 コンソールを使用して Amazon DocumentDB リソースのイベントを取得し、過去 24 時間のイベントを確認できます。また、Amazon DocumentDB リソースのイベントを取得するには、describe-events AWS CLI コマンド、またはDescribeEvents Amazon DocumentDB API オペレーションを使用します。AWS CLI または Amazon DocumentDB API を使用してイベントを表示する場合は、最大で過去 14 日間のイベントを取得できます。

Using the AWS Management Console

過去 24 時間で発生したAmazon DocumentDB インスタンスのすべてのイベントを表示するには

1. AWS Management Console にサインインして Amazon DocumentDB コンソール (https://console.aws.amazon.com/docdb) を開きます。

2. ナビゲーションペインの [Events] (イベント) を選択します。使用できるイベントがリストに表示されます。

3. タイプ別にイベントをフィルタリングするには、[フィルター] リストを使用します。テキストボックスにキーワードを入力して、結果をさらに絞り込むこともできます。例えば、次のスクリーンショットは、スナップショット イベントのすべての Amazon DocumentDB イベントをフィルタリングすることを示しています

   

Using the AWS CLI

過去 7 日間で発生したAmazon DocumentDB インスタンスのすべてのイベントを表示するには

過去 7 日間で発生した Amazon DocumentDB インスタンスのすべてのイベントを表示するには、describe-events AWS CLI オペレーションとの --duration パラメータに 10080 (10,080分) を設定します。

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 イベントの監査」を参照してください。