

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Administración de eventos de Amazon DocumentDB
<a name="managing-events"></a>

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](limits.md#limits-regional_quotas).

**Topics**
+ [Visualización de las categorías de eventos de Amazon DocumentDB](#viewing-event-categories)
+ [Visualización de eventos de Amazon DocumentDB](#viewing-events)

## Visualización de las categorías de eventos de Amazon DocumentDB
<a name="viewing-event-categories"></a>

Cada tipo de recurso de Amazon DocumentDB, tiene tipos específicos de eventos que se pueden asociar a él. Puede utilizar la operación `describe-event-categories` de la AWS CLI 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`.

**Example**  
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
<a name="viewing-events"></a>

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](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI, o la operación [DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html) 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 Consola de administración de AWS ]

**Visualización de todos los eventos de las instancias de Amazon DocumentDB de las últimas 24 horas**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).

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

1. 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*.  
![\[Captura de pantalla de la sección de eventos que muestra el filtrado de eventos de instantáneas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/events-filtering.png)

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

**Visualización de 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](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) de la 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](event-auditing.md).