

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Gestion des événements Amazon DocumentDB
<a name="managing-events"></a>

Amazon DocumentDB (compatible avec MongoDB) conserve un enregistrement des événements liés à vos clusters, instances, instantanés, groupes de sécurité et groupes de paramètres de cluster. Les informations consignées comprennent la date et l'heure de l'événement, le nom et le type de source de l'événement, ainsi qu'un message associé à l'événement.

**Important**  
Pour certaines fonctionnalités de gestion, Amazon DocumentDB utilise une technologie opérationnelle partagée avec Amazon RDS et Amazon Neptune. Les limites régionales, qui sont régies au niveau de la région, sont partagées entre Amazon DocumentDB, Amazon RDS et Amazon Neptune. Pour de plus amples informations, veuillez consulter [Quotas régionaux](limits.md#limits-regional_quotas).

**Topics**
+ [Affichage des catégories d'événements Amazon DocumentDB](#viewing-event-categories)
+ [Affichage des événements Amazon DocumentDB](#viewing-events)

## Affichage des catégories d'événements Amazon DocumentDB
<a name="viewing-event-categories"></a>

Chaque type de ressource Amazon DocumentDB est associé à des types d'événements spécifiques. Vous pouvez utiliser cette AWS CLI `describe-event-categories` opération pour afficher le mappage entre les types d'événements et les types de ressources Amazon DocumentDB.

**Paramètres**
+ **--source-type**—Facultatif. Utilisez le paramètre `--source-type` pour afficher les catégories d’événement d’un type source en particulier. Les valeurs suivantes sont autorisées :
  + `db-cluster`
  + `db-instance`
  + `db-parameter-group`
  + `db-security-group`
  + `db-cluster-snapshot`
+ **--filters**—Facultatif. Pour afficher les catégories d'événements uniquement pour Amazon DocumentDB, utilisez le filtre. `--filter Name=engine,Values=docdb`

**Example**  
Le code suivant répertorie les catégories d'événement associées à des clusters.  
Pour Linux, macOS ou Unix :  

```
aws docdb describe-event-categories \
    --filter Name=engine,Values=docdb \
    --source-type db-cluster
```
Pour Windows :  

```
aws docdb describe-event-categories ^
    --filter Name=engine,Values=docdb ^
    --source-type db-cluster
```
La sortie de cette opération ressemble à ceci (format JSON).  

```
{
    "EventCategoriesMapList": [
        {
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ],
            "SourceType": "db-cluster"
        }
    ]
}
```
Le code suivant répertorie les catégories d'événements associées à chaque type de source Amazon DocumentDB.  

```
aws docdb describe-event-categories
```
La sortie de cette opération ressemble à ceci (format 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"
            ]
        }
    ]
}
```

## Affichage des événements Amazon DocumentDB
<a name="viewing-events"></a>

Vous pouvez récupérer les événements relatifs à vos ressources Amazon DocumentDB via la console Amazon DocumentDB, qui affiche les événements des dernières 24 heures. Vous pouvez également récupérer des événements pour vos ressources Amazon DocumentDB à l'aide de la AWS CLI commande [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) ou de l'opération d'API Amazon DocumentDB [DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html). Si vous utilisez l'API Amazon DocumentDB AWS CLI ou l'API Amazon DocumentDB pour consulter les événements, vous pouvez récupérer les événements des 14 derniers jours.

------
#### [ Using the AWS Management Console ]

**Pour afficher tous les événements des instances Amazon DocumentDB des dernières 24 heures**

1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)

1. Dans le volet de navigation, sélectionnez **Events**. Les évènements disponibles s'affichent sous forme de liste.

1. Utilisez la liste **Filtre** pour filtrer les événements par type. Saisissez un terme dans la zone de texte pour affiner vos résultats. Par exemple, la capture d'écran suivante montre le filtrage de tous les événements Amazon DocumentDB pour les événements *instantanés*.  
![\[Capture d'écran de la rubrique affichant les événements de filtrage pour les instantanés.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/events-filtering.png)

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

**Pour consulter tous les événements des instances Amazon DocumentDB des 7 derniers jours**  
Vous pouvez consulter tous les événements d'instance Amazon DocumentDB des 7 derniers jours en exécutant l' AWS CLI opération [describe-events](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) avec le `--duration` paramètre défini sur `10080` (10 080 minutes).

```
aws docdb describe-events --duration 10080
```

**Filtrage des événements Amazon DocumentDB**

Pour voir des événements Amazon DocumentDB spécifiques, utilisez l'`describe-events`opération avec les paramètres suivants.

**Paramètres**
+ **--filter**—Obligatoire pour limiter les valeurs renvoyées aux événements Amazon DocumentDB. **Name=engine,Values=docdb**À utiliser pour filtrer tous les événements pour Amazon DocumentDB uniquement.
+ **--source-identifier**—Facultatif. Identifiant de la source de l'événement pour laquelle les événements sont renvoyés. Si cet argument n'est pas spécifié, les événements de toutes les sources sont inclus dans les résultats.
+ **--source-type**—Facultatif, à moins que `--source-identifier` cela ne soit fourni, puis obligatoire. Si le `--source-identifier` est fourni, le `--source-type` doit approuver le type du `--source-identifier`. Les valeurs suivantes sont autorisées :
  + `db-cluster`
  + `db-instance`
  + `db-parameter-group`
  + `db-security-group`
  + `db-cluster-snapshot`

L'exemple suivant répertorie tous vos événements Amazon DocumentDB.

```
aws docdb describe-events --filters Name=engine,Values=docdb
```

La sortie de cette opération ressemble à ceci (format 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"
            ]
        }
    ]
}
```

------

Pour de plus amples informations, veuillez consulter [Audit des événements Amazon DocumentDB](event-auditing.md).