Gestion des événements Amazon DocumentDB

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.

Affichage des catégories d'événements Amazon DocumentDB

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

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

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 ou de l'opération d'API Amazon DocumentDB DescribeEvents. 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.

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

3. 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.

   

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 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-eventsopé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.