Amazon DocumentDB イベントの管理 - Amazon DocumentDB
イベントカテゴリの表示Amazon DocumentDB イベントの表示

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 マネジメントコンソール
過去 24 時間で発生したAmazon DocumentDB インスタンスのすべてのイベントを表示するには

  1. にサインインし AWS マネジメントコンソール、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。

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

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

    スナップショットのフィルタリングイベントを示すイベントセクションのスクリーンショット。
Using the AWS CLI
過去 7 日間で発生したAmazon DocumentDB インスタンスのすべてのイベントを表示するには

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

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