Administrar eventos de Amazon DocumentDB

Amazon DocumentDB (con compatibilidad con MongoDB) mantiene un registro de los eventos relacionados con los clústeres, las instancias, las instantáneas, los grupos de seguridad y los grupos de parámetros de clúster. Esta información incluye la fecha y hora del evento, el nombre del origen y el tipo del origen del evento y un mensaje relacionado con el evento.

importante

En determinadas características de administración, Amazon DocumentDB utiliza una tecnología operativa que comparte con Amazon RDS y Amazon Neptune. Los límites regionales, es decir, los límites que se aplican en el nivel de región, se comparten entre Amazon DocumentDB, Amazon RDS, y Amazon Neptune. Para obtener más información, consulte Cuotas regionales.

Visualización de las categorías de eventos de Amazon DocumentDB

Cada tipo de recurso de Amazon DocumentDB, tiene tipos específicos de eventos que se pueden asociar a él. Puede utilizar la operación de AWS CLI describe-event-categories para ver la correspondencia entre los tipos de eventos y los tipos de recursos de Amazon DocumentDB.

Parámetros

• --source-type: opcional. Utilice el parámetro --source-type para ver las categorías de eventos de un tipo de origen particular. Se permiten los siguientes valores:

  • db-cluster

  • db-instance

  • db-parameter-group

  • db-security-group

  • db-cluster-snapshot

• --filters: opcional. Para ver categorías de eventos únicamente para Amazon DocumentDB, utilice el filtro --filter Name=engine,Values=docdb.

El siguiente código muestra las categorías de eventos asociadas a los clústeres.

Para Linux, macOS o Unix:

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

Para Windows:

aws docdb describe-event-categories ^
    --filter Name=engine,Values=docdb ^
    --source-type db-cluster

La salida de esta operación será similar a lo que se indica a continuación (formato JSON).

{
    "EventCategoriesMapList": [
        {
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ],
            "SourceType": "db-cluster"
        }
    ]
}

El siguiente código muestra las categorías de eventos asociadas a cada tipo de recurso de Amazon DocumentDB.

aws docdb describe-event-categories

La salida de esta operación será similar a lo que se indica a continuación (formato 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"
            ]
        }
    ]
}

Visualización de eventos de Amazon DocumentDB

Puede recuperar eventos de los recursos de Amazon DocumentDB a través de la consola de Amazon DocumentDB, la cual muestra los eventos de las últimas 24 horas. También puede recuperar eventos para los recursos de Amazon DocumentDB utilizando el comando describe-events AWS CLI, o la operación DescribeEvents de la API de Amazon DocumentDB. Si utiliza la AWS CLI o la API de Amazon DocumentDB para ver eventos, puede recuperar eventos de los últimos 14 días como máximo.

Using the AWS Management Console

Para ver todos los eventos de las instancias de Amazon DocumentDB de las últimas 24 horas

1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb.

2. En el panel de navegación, seleccione Events. Los eventos disponibles aparecen en una lista.

3. Utilice la lista Filter (Filtro) para filtrar los eventos por tipo. Escriba un término en el cuadro de texto para filtrar aún más los resultados. Por ejemplo, la siguiente captura de pantalla muestra la filtración de todos los eventos de Amazon DocumentDB para los eventos de instantánea.

   

Using the AWS CLI

Para ver todos los eventos de las instancias de Amazon DocumentDB de los últimos 7 días

Puede ver todos los eventos de las instancias de Amazon DocumentDB de los últimos 7 días ejecutando la operación describe-events AWS CLI con el parámetro --duration establecido en 10080 (10 080 minutos).

aws docdb describe-events --duration 10080

Filtrado de eventos de Amazon DocumentDB

Para ver eventos de Amazon DocumentDB específicos, utilice la operación describe-events con los siguientes parámetros.

Parámetros

• --filter: necesario para limitar los valores devueltos a los eventos de Amazon DocumentDB. Utilice Name=engine,Values=docdb para filtrar todos los eventos únicamente para Amazon DocumentDB.

• --source-identifier: opcional. El identificador del origen de eventos para el que se devuelven eventos. Si se omite, se incluyen en los resultados los eventos de todos los orígenes.

• --source-type: opcional, a menos que se proporcione --source-identifier, entonces es obligatorio. Si se proporciona --source-identifier, --source-type debe coincidir con el tipo de --source-identifier. Se permiten los siguientes valores:

  • db-cluster

  • db-instance

  • db-parameter-group

  • db-security-group

  • db-cluster-snapshot

El siguiente ejemplo muestra todos los eventos de Amazon DocumentDB.

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

La salida de esta operación será similar a lo que se indica a continuación (formato 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"
            ]
        }
    ]
}

Para obtener más información, consulte Auditoría de eventos de Amazon DocumentDB.