

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

# Amazon DocumentDB イベントの管理
<a name="managing-events"></a>

Amazon DocumentDB (MongoDB との互換性あり) は、クラスター、インスタンス、スナップショット、セキュリティグループ、およびクラスターパラメータグループに関連するイベントのレコードを保持します。この情報には、イベントの日付と時刻、イベントのソース名とソースタイプ、イベントに関連付けられたメッセージなどがあります。

**重要**  
特定の管理機能のために、Amazon DocumentDB は Amazon RDS および Amazon Neptune と共有したオペレーションテクノロジーを使用します。Amazon DocumentDB、Amazon RDS、および Amazon Neptune 間でリージョンレベルで管理されている制限のあるリージョンが共有されています。詳細については、「[リージョン別クォータ](limits.md#limits-regional_quotas)」を参照してください。

**Topics**
+ [Amazon DocumentDB のイベントカテゴリの表示](#viewing-event-categories)
+ [Amazon DocumentDB イベントの表示](#viewing-events)

## Amazon DocumentDB のイベントカテゴリの表示
<a name="viewing-event-categories"></a>

各 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` を使用します。

**Example**  
次のコードは、クラスターに関連付けられているイベントカテゴリを一覧表示しています。  
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 イベントの表示
<a name="viewing-events"></a>

Amazon DocumentDB コンソールを使用して Amazon DocumentDB リソースのイベントを取得し、過去 24 時間のイベントを確認できます。また、Amazon DocumentDB リソースのイベントを取得するには、[describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI コマンド、または[DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html) Amazon DocumentDB API オペレーションを使用します。AWS CLI または Amazon DocumentDB API を使用してイベントを表示する場合は、最大で過去 14 日間のイベントを取得できます。

------
#### [ Using the AWS マネジメントコンソール ]

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

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

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

1. タイプ別にイベントをフィルタリングするには、[**フィルター**] リストを使用します。テキストボックスにキーワードを入力して、結果をさらに絞り込むこともできます。例えば、次のスクリーンショットは、*スナップショット* イベントのすべての Amazon DocumentDB イベントをフィルタリングすることを示しています  
![\[スナップショットのフィルタリングイベントを示すイベントセクションのスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/events-filtering.png)

------
#### [ Using the AWS CLI ]

**過去 7 日間で発生したAmazon DocumentDB インスタンスのすべてのイベントを表示するには**  
過去 7 日間で発生した Amazon DocumentDB インスタンスのすべてのイベントを表示するには、[describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) 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 イベントの監査](event-auditing.md)」を参照してください。