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.
# Monitorización de Amazon DocumentDB
La supervisión de sus AWS servicios es una parte importante para mantener sus sistemas en buen estado y funcionando de manera óptima. Es aconsejable recopilar datos de monitorización de todas las partes de su solución de AWS para que le resulte más sencillo depurar y solucionar los errores o la reducción del rendimiento, en caso de que ocurran. Antes de comenzar a monitorizar sus soluciones de AWS , le recomendamos que se plantee las siguientes preguntas:
+ ¿Cuáles son los objetivos de la supervisión?
+ ¿Qué recursos va a monitorizar?
+ ¿Con qué frecuencia va a monitorizar estos recursos?
+ ¿Qué herramientas de supervisión va a utilizar?
+ ¿Quién es el responsable de realizar el seguimiento?
+ ¿A quién se va a notificar y qué ocurre si algo va mal?
Para comprender los patrones de rendimiento actual, identificar las anomalías de rendimiento y elaborar métodos para la resolución de problemas, debe establecer métricas de rendimiento de referencia para distintos momentos y bajo diferentes condiciones de carga. A medida que monitorice su solución de AWS , le recomendamos que guarde los datos de monitorización históricos como referencia futura y para establecer sus métricas de referencia.
En general, los valores aceptables para las métricas de desempeño dependen del aspecto de la referencia y de lo que hace la aplicación. Investigue las variaciones coherentes o de las tendencias con respecto a la referencia. A continuación, se ofrecen algunas sugerencias sobre tipos concretos de métricas:
+ **Consumo elevado de CPU o RAM**: unos valores elevados de consumo de CPU o RAM pueden ser adecuados si se ajustan a los objetivos de su aplicación (de rendimiento o simultaneidad, por ejemplo) y son los esperados.
+ **Consumo de volumen de almacenamiento**: investigue el consumo de almacenamiento (`VolumeBytesUsed`) si el espacio utilizado está por sistema alrededor o por encima del 85 % del espacio del volumen de almacenamiento. Determine si es posible eliminar datos del volumen de almacenamiento o archivar los datos en un sistema diferente para liberar espacio. Para obtener más información, consulte [Almacenamiento de Amazon DocumentDB](how-it-works.md#how-it-works.storage) y [Cuotas y límites de Amazon DocumentDB](limits.md).
+ **Tráfico de red**: para el tráfico de red, hable con el administrador de su sistema para saber cuál es el rendimiento esperado para la red de su dominio y para su conexión a Internet. Investigue el tráfico de red si el rendimiento es por sistema inferior al esperado.
+ **Conexiones a bases de datos**: valore la posibilidad de restringir las conexiones a las bases de datos si ve que hay un alto número de conexiones de usuarios junto con una reducción en el rendimiento y el tiempo de respuesta de la instancia. El mejor número de conexiones de usuarios para su instancia variará en función de la clase de instancia y de la complejidad de las operaciones que se estén llevando a cabo.
+ **Métricas de IOPS**: los valores esperados para las métricas de IOPS dependen de la especificación del disco y la configuración del servidor, así que debe usar su referencia para conocer los valores típicos. Investigue si los valores son por sistema diferentes de los valores de referencia. Para un rendimiento óptimo de IOPS, asegúrese de que el conjunto de trabajo típico se ajuste a la memoria para minimizar las operaciones de lectura y escritura.
Amazon DocumentDB (compatible con MongoDB) proporciona una variedad de CloudWatch métricas de Amazon que puede supervisar para determinar el estado y el rendimiento de sus instancias y clústeres de Amazon DocumentDB. Puede ver las métricas de Amazon DocumentDB mediante diversas herramientas, como la consola Amazon DocumentDB AWS CLI CloudWatch , la API y Performance Insights.
**Topics**
+ [Monitorización del estado de un clúster](monitoring_docdb-cluster_status.md)
+ [Monitorización del estado de una instancia](monitoring_docdb-instance_status.md)
+ [Visualización de recomendaciones de Amazon DocumentDB](view-docdb-recommendations.md)
+ [Suscripciones de eventos](event-subscriptions.md)
+ [Supervisión de Amazon DocumentDB con CloudWatch](cloud_watch.md)
+ [Registro de llamadas a la API de Amazon DocumentDB con CloudTrail](logging-with-cloudtrail.md)
+ [Creación de perfiles de operaciones](profiling.md)
+ [Supervisión con información sobre rendimiento](performance-insights.md)
# Supervisión del estado de un clúster de Amazon DocumentDB
El estado de un clúster indica la situación de este. Puede ver el estado de un clúster mediante la consola de Amazon DocumentDB o el AWS CLI `describe-db-clusters` comando.
**Topics**
+ [Valores de estado del clúster](#monitoring_docdb-status_values)
+ [Monitorización del estado de un clúster](#monitor-cluster-status)
## Valores de estado del clúster
En la siguiente tabla se muestran los valores válidos para el estado de un clúster.
| Estado del clúster | Description (Descripción) |
| --- | --- |
| active | El clúster está activo. Este estado se aplica únicamente a los clústeres elásticos. |
| available | El clúster funciona correctamente y está disponible. Este estado solo se aplica a clústeres basados en instancias. |
| backing-up | Se está creando una copia de seguridad del clúster. |
| creating | El clúster se está creando. No se puede obtener acceso a él mientras se está creando. |
| deleting | El clúster se está eliminando. No se puede obtener acceso a él mientras se está eliminando. |
| failing-over | Se está realizando una conmutación por error de la instancia principal a una réplica de Amazon DocumentDB. |
| inaccessible-encryption-credentials | No se puede acceder a la AWS KMS clave utilizada para cifrar o descifrar el clúster. |
| maintenance | Se está aplicando una actualización de mantenimiento al clúster. Este estado se usa para el mantenimiento de nivel de clúster que Amazon DocumentDB programa con mucha antelación. |
| migrating | Se está restaurando una instantánea de clúster en un clúster. |
| migration-failed | Una migración no se ha realizado correctamente. |
| modifying | El clúster se está modificando porque un cliente ha solicitado su modificación. |
| renaming | El nombre del clúster se está cambiando porque un cliente lo ha solicitado. |
| resetting-master-credentials | Las credenciales maestras del clúster se están restableciendo porque un cliente lo ha solicitado. |
| upgrading | Se está actualizando la versión del motor del clúster. |
## Monitorización del estado de un clúster
------
#### [ Using the Consola de administración de AWS ]
Cuando utilice el Consola de administración de AWS para determinar el estado de un clúster, utilice el siguiente procedimiento.
1. [Inicie sesión en y abra la Consola de administración de AWS 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 **Clusters (Clústeres)**.
1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres en la que se muestra cómo se anida una instancia en un clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. En la columna **Identificador de clúster**, busque el nombre de la instancia que le interese. A continuación, para encontrar el estado de la instancia, consulte en esa fila la columna **Estado**, tal y como se muestra a continuación.
![\[Instancia de clúster en la que se muestra el estado disponible.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Cuando utilice el AWS CLI para determinar el estado de un clúster, utilice la operación. `describe-db-clusters` El siguiente código busca el estado del clúster `sample-cluster`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Supervisión del estado de un clúster de Amazon DocumentDB
Amazon DocumentDB proporciona información sobre el estado actual de cada instancia configurada de la base de datos.
Hay tres tipos de estado que puede ver para una instancia de Amazon DocumentDB:
+ Estado de la instancia: este estado se muestra en la columna **Estado** de la tabla de clústeres Consola de administración de AWS y muestra el estado actual del ciclo de vida de la instancia. Los valores que se muestran en la columna **Estado** se derivan del campo `Status` de la respuesta de la API de `DescribeDBCluster`.
+ Estado de estado de la instancia: este estado se muestra en la columna de **estado de la instancia** de la tabla de clústeres de la Consola de administración de AWS y muestra si el motor de base de datos, el componente responsable de administrar y recuperar los datos, está en funcionamiento. Los valores que se muestran en la columna **Estado de la instancia** se basan en la métrica CloudWatch `EngineUptime` del sistema Amazon.
+ Estado de mantenimiento: este estado se muestra en la columna **Mantenimiento** de la tabla de clústeres Consola de administración de AWS e indica el estado de cualquier evento de mantenimiento que deba aplicarse a una instancia. El estado de mantenimiento es independiente del estado de las demás instancias y se deriva de la API de `PendingMaintenanceAction`. Para obtener más información sobre el estado del mantenimiento, consulte [Mantenimiento de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html).
**Topics**
+ [Valores de estado de instancia](#monitoring_docdb-instance_status-values)
+ [Monitorear el estado de la instancia mediante Consola de administración de AWS o AWS CLI](#monitoring-instance-status)
+ [Estado de una instancia](#instance-health-status-values)
+ [Monitorear el estado de salud de la instancia mediante el Consola de administración de AWS](#monitoring-instance-health-status)
## Valores de estado de instancia
En la siguiente tabla se muestran los posibles valores de estado de las instancias y cómo se factura para cada estado. Muestra si se le facturará la instancia y el almacenamiento, solo el almacenamiento o si no se le facturará. Para todos los estados de instancia, se le factura siempre el uso de copia de seguridad.
| estado de instancias | Facturado | Description (Descripción) |
| --- | --- | --- |
| available | Facturado | La instancia funciona correctamente y está disponible. |
| backing-up | Facturado | Se está creando una copia de seguridad de la instancia. |
| configuring-log-exports | Facturado | La publicación de archivos de registro en Amazon CloudWatch Logs está habilitada o deshabilitada en esta instancia. |
| creating | No facturado | La instancia se está creando. No se puede obtener acceso a la instancia mientras se está creando. |
| deleting | No facturado | La instancia se está eliminando. |
| failed | No facturado | La instancia ha generado un error y Amazon DocumentDB no ha podido recuperarla. Para recuperar los datos, realice una point-in-time restauración a la última hora de restauración de la instancia. |
| inaccessible-encryption-credentials | No facturado | No se pudo acceder a la AWS KMS clave que se usa para cifrar o descifrar la instancia. |
| incompatible-network | No facturado | Amazon DocumentDB está intentando realizar una acción de recuperación en una instancia, pero no puede hacerlo porque la VPC está en un estado que impide completar la acción. Este estado puede darse si, por ejemplo, todas las direcciones IP disponibles en una subred estaban en uso y Amazon DocumentDB no puede obtener una dirección IP para la instancia. |
| maintenance | Facturado | Amazon DocumentDB está aplicando una actualización de mantenimiento a la instancia. Este estado se usa para el mantenimiento de nivel de instancia que Amazon DocumentDB programa con mucha antelación. Estamos evaluando formas de exponer otras acciones de mantenimiento a los clientes a través de este estado. |
| modifying | Facturado | La instancia se está modificando debido a una solicitud para modificar la instancia. |
| rebooting | Facturado | La instancia se está reiniciando debido a una solicitud o un proceso de Amazon DocumentDB que requiere el reinicio de la instancia. |
| renaming | Facturado | El nombre de la instancia se está cambiando debido a una solicitud de cambio de nombre. |
| resetting-master-credentials | Facturado | Las credenciales maestras de la instancia se están restableciendo debido a una solicitud de restablecimiento. |
| restore-error | Facturado | La instancia detectó un error al intentar realizar la restauración en una instantánea point-in-time o desde ella. |
| starting | Facturado para almacenamiento | La instancia se está iniciando. |
| stopped | Facturado para almacenamiento | La instancia se ha detenido. |
| stopping | Facturado para almacenamiento | La instancia se está deteniendo. |
| storage-full | Facturado | La instancia ha alcanzado su asignación de capacidad de almacenamiento. Es un estado crítico y se debe corregir de inmediato. Escale verticalmente el almacenamiento modificando la instancia. Configura CloudWatch las alarmas de Amazon para que te avisen cuando el espacio de almacenamiento se esté agotando para que no te encuentres con esta situación. |
## Monitorear el estado de la instancia mediante Consola de administración de AWS o AWS CLI
Usa Consola de administración de AWS o AWS CLI para monitorear el estado de tu instancia.
------
#### [ Using the Consola de administración de AWS ]
Cuando utilice el Consola de administración de AWS para determinar el estado de un clúster, utilice el siguiente procedimiento.
1. [Inicie sesión en y abra la Consola de administración de AWS 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 **Clusters (Clústeres)**.
**nota**
Tenga en cuenta que en el cuadro de navegación de clústeres, la columna **Identificador de clústeres** muestra tanto los clústeres como las instancias. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Lista de clústeres e instancias de la página Clústeres de la consola de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/clusters.png)
1. Busque el nombre de la instancia que le interesa. A continuación, para encontrar el estado de la instancia, consulte en esa fila la columna **Status (Estado)**, tal y como se muestra a continuación.
![\[Columna de estado en la que se muestra el estado disponible de los clústeres y las instancias en la página Clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/instance-status.png)
------
#### [ Using the AWS CLI ]
Cuando utilice el AWS CLI para determinar el estado de un clúster, utilice la operación. `describe-db-instances` El siguiente código muestra el estado de la instancia `sample-cluster-instance-01`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance-01 \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
Para Windows:
```
aws docdb describe-db-instances ^
--db-instance-identifier sample-cluster-instance-01 ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceStatus]'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
[
[
"sample-cluster-instance-01",
"available"
]
]
```
------
## Estado de una instancia
Encuentre los valores de estado posibles para instancias de base de datos en la siguiente tabla. La columna de **estado de la instancia**, ubicada en la tabla de **clústeres** del Consola de administración de AWS, muestra si el motor de base de datos, el componente responsable de almacenar, administrar y recuperar los datos, funciona con normalidad. Esta columna también indica si la métrica `EngineUptime` del sistema, disponible en CloudWatch, muestra el estado de cada instancia.
| Estado de una instancia | Description (Descripción) |
| --- | --- |
| buen estado | El motor de base de datos se ejecuta en la instancia de Amazon DocumentDB. |
| Mal estado | El motor de base de datos no se está ejecutando o se reinició hace menos de un minuto. |
## Monitorear el estado de salud de la instancia mediante el Consola de administración de AWS
Utilice el Consola de administración de AWS para supervisar el estado de salud de la instancia.
Cuando la utilices Consola de administración de AWS, sigue los siguientes pasos para entender el estado de salud de la instancia.
1. [Inicie sesión en y abra la Consola de administración de AWS 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 **Clusters (Clústeres)**.
**nota**
Tenga en cuenta que en el cuadro de navegación **Clústeres**, la columna **Identificador del clúster** muestra tanto los clústeres como las instancias. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Lista de clústeres e instancias de la página Clústeres de la consola de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/clusters.png)
1. Busque el nombre de la instancia que le interesa. A continuación, para encontrar el estado de la instancia, consulte en esa fila la columna **Estado**, tal y como se muestra a continuación:
![\[Columna de estado de las instancias en la que se muestra el buen estado y el mal estado de las instancias que aparecen en la página Clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/health-status-1.png)
**nota**
El sondeo del estado de las instancias se realiza cada 60 segundos y se basa en la métrica del CloudWatch `EngineUptime` sistema. Los valores de la columna **Estado de la instancia** se actualizan automáticamente.
# Visualización de recomendaciones de Amazon DocumentDB
Amazon DocumentDB proporciona una lista de recomendaciones automatizadas para recursos de base de datos, como instancias y clústeres. Estas recomendaciones proporcionan instrucciones de las prácticas recomendadas analizando los datos de rendimiento, el uso y la configuración de la instancia y clúster.
Para ver ejemplos de estas recomendaciones, consulte lo siguiente:
| Tipo | Descripción | Recomendación | Información adicional |
| --- | --- | --- | --- |
| Una instancia | El clúster solo contiene una instancia | Rendimiento y disponibilidad: recomendamos añadir otra instancia con la misma clase de instancia en una zona de disponibilidad diferente. | [Alta disponibilidad y replicación de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/replication.html) |
Amazon DocumentDB genera recomendaciones para un recurso cuando se crea o modifica el recurso. Amazon DocumentDB analiza también periódicamente sus recursos y genera recomendaciones.
**Visualización de las recomendaciones de Amazon DocumentDB y toma de medidas al respecto**
1. [Inicie sesión en y abra la Consola de administración de AWS 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 **Recomendaciones**:
![\[Panel de navegación de la consola de Amazon DocumentDB con la opción Recomendaciones seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/recommendations-nav-1.png)
1. En el cuadro de diálogo **Recomendaciones**, amplíe la sección de interés y seleccione la tarea recomendada.
En el siguiente ejemplo, la tarea recomendada se aplica a un clúster de Amazon DocumentDB con una sola instancia. La recomendación es añadir otra instancia para mejorar el rendimiento y la disponibilidad.
![\[El formulario de Recomendaciones, en el que se muestra una tarea recomendada seleccionada para un clúster de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/recommendations-1.png)
1. Haga clic en **Aplicar ahora**.
En este ejemplo, aparece el cuadro de diálogo **Agregar instancias**:
![\[El formulario Añadir instancias con opciones para la configuración de las instancias.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/add-instances-1.png)
1. Modifique la configuración de la nueva instancia y haga clic en **Crear**.
# Uso de suscripciones a eventos de Amazon DocumentDB
Amazon RDS utiliza Amazon Simple Notification Service (Amazon SNS) para proporcionar notificaciones cuando se produce un evento de Amazon DocumentDB. Estas notificaciones pueden estar en cualquier formato compatible con Amazon SNS Región de AWS, como un correo electrónico, un mensaje de texto o una llamada a un punto de conexión HTTP.
Amazon DocumentDB agrupa estos eventos en categorías a las que puede suscribirse para recibir una notificación cada vez que se produzca un evento en esa categoría. Puede suscribirse a una categoría de eventos para una instancia, un clúster, una instantánea, una instantánea de clúster, o para un grupo de parámetros. Por ejemplo, si se suscribe a la categoría Backup de una instancia determinada, recibe una notificación cada vez que se produzca un evento relacionado con las copias de seguridad que afecte a dicha instancia. También recibirá una notificación cuando cambie una suscripción de eventos.
Los eventos se producen en el clúster y en el nivel de instancia, por lo que puede recibir eventos si se suscribe a un clúster o a una instancia.
Las suscripciones de eventos se envían a las direcciones que se proporcionan al crear la suscripción. Es posible que le interese crear distintas suscripciones como, por ejemplo, una que reciba todas las notificaciones de eventos y otra que incluya únicamente los eventos críticos para las instancias de producción. Puede desactivar fácilmente las notificaciones sin eliminar una suscripción. Para ello, defina el botón de opción **Activado** en **No** en la consola de Amazon DocumentDB.
**importante**
Amazon DocumentDB no garantiza el orden de los eventos enviados en una secuencia de eventos. El orden de los eventos está sujeto a cambio.
Amazon DocumentDB utiliza el nombre de recurso de Amazon (ARN) de un tema de Amazon SNS para identificar cada suscripción. La consola de Amazon DocumentDB crea el ARN automáticamente cuando se crea la suscripción.
La facturación de las suscripciones a eventos de Amazon DocumentDB se realiza a través de Amazon SNS. Se aplican las tarifas de Amazon SNS cuando se utiliza la notificación de eventos. Para obtener más información, consulte Amazon Simple Notification Service Pricing. Además de los cargos de Amazon SNS, Amazon DocumentDB no factura las suscripciones a eventos.
**Topics**
+ [Suscripción a eventos](event-subscriptions.subscribe.md)
+ [Administración de las suscripciones de](event-subscriptions.managing.md)
+ [Categorías y mensajes](event-subscriptions.categories-messages.md)
# Suscripción a eventos de Amazon DocumentDB
Puede utilizar la consola Amazon DocumentDB para suscribirse a las suscripciones a eventos de la siguiente manera:
1. Inicie sesión Consola de administración de AWS en[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación seleccione **Event Subscriptions (Suscripciones de eventos)**.
![\[Panel de navegación de la consola Amazon DocumentDB con la opción Suscripciones a eventos resaltada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/subscribe-event-subs.png)
1. En la página **Event Subscriptions (Suscripciones de eventos)** seleccione **Create Event Subscription (Crear suscripción de eventos)**.
![\[Panel Suscripciones a eventos con el botón Crear suscripción a eventos resaltado en la esquina superior derecha.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/subscribe-create.png)
1. En el cuadro de diálogo **Create Event Subscription (Crear suscripción de eventos)**, haga lo siguiente:
+ En **Name (Nombre)** escriba un nombre para la suscripción de notificación de evento.
![\[El formulario Crear suscripción a eventos, en el que se muestra la sección Detalles y el campo de entrada del Nombre.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/subscribe-name.png)
+ En **Destino**, seleccione a dónde quiere enviar las notificaciones. Puede elegir un **ARN** existente o elegir **Nuevo tema de correo electrónico** para introducir el nombre de un tema y una lista de destinatarios.
![\[La sección Destino con opciones para especificar dónde se enviarán las notificaciones.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/subscribe-target.png)
+ En **Origen** elija un tipo de origen. En función del tipo de origen que haya seleccionado, seleccione las categorías y orígenes del evento de las que desea recibir notificaciones.
![\[La sección Origen permite seleccionar un tipo de origen desde el que recibir las notificaciones de eventos.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/subscribe-source.png)
+ Seleccione **Crear**.
![\[La sección Origen con el botón Crear en la esquina inferior derecha.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/subscribe-create-2.png)
# Administración de suscripciones a notificaciones de eventos de Amazon DocumentDB
Si selecciona **Suscripciones a eventos** en el panel de navegación de la consola de Amazon DocumentDB, puede ver las categorías de suscripciones y una lista de sus suscripciones actuales. También puede modificar o eliminar una suscripción específica.
## Modificación de sus suscripciones actuales de notificación de eventos de Amazon DocumentDB
1. Inicie sesión en el correo Consola de administración de AWS electrónico[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación seleccione **Event Subscriptions (Suscripciones de eventos)**. El panel **Event subscriptions (Suscripciones de eventos)** muestra todas sus suscripciones a notificaciones de eventos.
![\[Panel de navegación de la consola Amazon DocumentDB con la opción Suscripciones a eventos resaltada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/modify-event-subs.png)
1. En el panel **Event subscriptions (Suscripciones de eventos)**, elija la suscripción que desea modificar y elija **Edit (Editar)**.
![\[El panel de Suscripciones a eventos, en el que se muestra la suscripción seleccionada y el botón Editar.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/modify-edit.png)
1. Realice los cambios que desee en la suscripción en las secciones **Target (Objetivo)** o **Source (Fuente)**. Puede añadir o eliminar identificadores de origen activándolos o desactivándolos en la sección Origen.
![\[El formulario de Modificar suscripción a eventos con la sección Destino resaltada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/modify-target.png)
1. Elija **Modificar**. La consola de Amazon DocumentDB indica que se está modificando la suscripción.
![\[El final del formulario de Modificar suscripción a eventos con el botón Modificar resaltado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/modify-button.png)
## Eliminación de una suscripción de notificación de eventos de Amazon DocumentDB
Puede eliminar una suscripción cuando ya no la necesite. Los suscriptores del tema dejarán de recibir notificaciones de los eventos especificados en la suscripción.
1. Inicie sesión en el correo Consola de administración de AWS electrónico[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación seleccione **Event Subscriptions (Suscripciones de eventos)**.
![\[Panel de navegación de la consola Amazon DocumentDB con la opción Suscripciones a eventos resaltada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/delete-event-subs.png)
1. En el panel **Suscripciones a eventos**, seleccione la suscripción que desea eliminar.
![\[El panel de Suscripciones a eventos, en el que se muestra la suscripción seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/delete-select.png)
1. Elija **Eliminar**.
![\[El panel de Suscripciones a eventos con el botón Eliminar resaltado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/delete-delete.png)
1. Aparecerá una ventana emergente en la que se le preguntará si desea eliminar esta notificación de forma permanente. Elija **Eliminar**.
![\[Un cuadro de diálogo que confirma la eliminación de la suscripción a eventos con el botón Eliminar resaltado en la esquina inferior derecha.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/event-subs/delete-delete-2.png)
# Categorías y mensajes de eventos de Amazon DocumentDB
Amazon DocumentDB genera un número significativo de eventos en categorías a las que puede suscribirse a través de la consola. Cada categoría se aplica a un tipo de origen, que puede ser una instancia, un clúster, una instantánea o un grupo de parámetros.
**nota**
Amazon DocumentDB utiliza las definiciones de eventos de Amazon RDS existentes y. IDs
## Eventos de Amazon DocumentDB que se originan en instancias
| Categoría | Description (Descripción) |
| --- | --- |
| availability | Instancia reiniciada. |
| disponibilidad | Instancia cerrada. |
| cambio de configuración | Se está aplicando la modificación a la clase de instancia. |
| cambio de configuración | Ha finalizado la aplicación de la modificación a una clase de instancia. |
| cambio de configuración | Restablezca las credenciales principales. |
| creación | Instancia creada. |
| eliminación | Se ha eliminado la instancia |
| error | Se ha producido un error en la instancia debido a una configuración incompatible o a un problema de almacenamiento subyacente. Comience a point-in-time-restore para la instancia. |
| notificación | Se ha detenido la instancia. |
| notificación | Se ha iniciado la instancia. |
| notificación | La instancia se está iniciando debido a que se supera el tiempo máximo permitido para estar detenida. |
| recuperación | Se ha iniciado la recuperación de la instancia. El tiempo de recuperación dependerá de la cantidad de datos que deban recuperarse. |
| recuperación | Ha finalizado la recuperación de la instancia. |
| Creación de parches de seguridad | La actualización del sistema operativo está disponible para su instancia. Para obtener más información acerca de cómo se aplican las actualizaciones, consulte [Mantenimiento de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-maintain.html). |
## Eventos de Amazon DocumentDB que se originan en un clúster
| Categoría | Description (Descripción) |
| --- | --- |
| creación | Se ha creado un clúster |
| eliminación | Se ha eliminado un clúster. |
| conmutación por error | Volver a promocionar el principal anterior. |
| conmutación por error | Se ha completado la conmutación por error en la instancia. |
| conmutación por error | Se ha iniciado la misma conmutación por error de AZ en la instancia de base de datos: %s |
| conmutación por error | Se ha iniciado la misma conmutación por error de AZ en la instancia de base de datos: %s |
| conmutación por error | Se ha iniciado la conmutación por error entre AZ en la instancia de base de datos: %s |
| mantenimiento | Se ha parcheado el clúster. |
| mantenimiento | El clúster de base de datos tiene un estado que no se puede actualizar: %s |
| notificación | El clúster se ha detenido. |
| notificación | El clúster se ha iniciado. |
| notificación | La detención del clúster ha producido un error. |
| notificación | El clúster se está iniciando debido a que se supera el tiempo máximo permitido para estar detenida. |
| notificación | Se ha cambiado el nombre del clúster de %s a %s. |
## Eventos de Amazon DocumentDB que se originan en una instantánea de clúster
En la siguiente tabla se muestra la categoría de eventos y una lista de los eventos que pueden producirse cuando el tipo de origen es una instantánea de clúster de Amazon DocumentDB.
| Categoría | Description (Descripción) |
| --- | --- |
| copia de seguridad | Crear una instantánea manual del clúster. |
| copia de seguridad | Se ha creado una instantánea manual del clúster. |
| copia de seguridad | Creación de instantáneas de clúster automatizadas. |
| copia de seguridad | Se ha creado una instantánea de clúster automatizada. |
## Eventos de Amazon DocumentDB que se originan en un grupo de parámetros
En la siguiente tabla, se muestra la categoría de eventos y una lista de eventos correspondiente a un grupo de parámetros como tipo de origen.
| Categoría | Description (Descripción) |
| --- | --- |
| cambio de configuración | Se actualizó el parámetro %s a %s con el método de aplicación %s |
# Supervisión de Amazon DocumentDB con CloudWatch
Amazon DocumentDB (compatible con MongoDB) se integra con Amazon CloudWatch para que pueda recopilar y analizar las métricas operativas de sus clústeres. Puede supervisar estas métricas mediante la CloudWatch consola, la consola Amazon DocumentDB, AWS Command Line Interface (AWS CLI) o la CloudWatch API.
CloudWatch también le permite configurar alarmas para que se le notifique si el valor de una métrica supera un umbral que especifique. Incluso puedes configurar Amazon CloudWatch Events para que tome medidas correctivas en caso de que se produzca una infracción. Para obtener más información sobre el uso CloudWatch y las alarmas, consulta la [ CloudWatch documentación de Amazon](https://docs.aws.amazon.com/cloudwatch/index.html).
**Topics**
+ [Métricas de Amazon DocumentDB](#cloud_watch-metrics_list)
+ [Visualización CloudWatch de datos](#cloud_watch-view_data)
+ [Dimensiones de Amazon DocumentDB](#cloud_watch-metrics_dimensions)
+ [Supervisión de métricas de Opcounter](#cloud_watch-monitoring_opcounters)
+ [Supervisión de conexiones a bases de datos](#cloud_watch-monitoring_connections)
## Métricas de Amazon DocumentDB
Para monitorizar el estado y el rendimiento del clúster e instancias de Amazon DocumentDB, puede consultar las siguientes métricas en la consola de Amazon DocumentDB.
**nota**
Las métricas de las siguientes tablas se aplican tanto a los clústeres elásticos como a los basados en instancias.
**Topics**
+ [Métricas de utilización de recursos](#resource-utilization)
+ [Métricas de latencia](#latency-metrics)
+ [NVMe-métricas de instancias respaldadas](#nvme-metrics)
+ [Métricas operativas](#operations-metrics)
+ [Métricas de rendimiento](#throughput-metrics)
+ [Métricas del sistema](#system-metrics)
+ [Métricas de la instancia T3](#t3-instance-metrics)
### Métricas de utilización de recursos
| Métrica | Description (Descripción) |
| --- | --- |
| BackupRetentionPeriodStorageUsed | La cantidad total de almacenamiento de copias de seguridad en bytes utilizada para admitir la función de point-in-time restauración dentro de la ventana de retención de Amazon DocumentDB. Se incluye en el total registrado por la métrica TotalBackupStorageBilled. Se calcula de forma independiente para cada clúster de Amazon DocumentDB. |
| ChangeStreamLogSize | La cantidad de almacenamiento que utiliza el clúster para almacenar el registro de flujos de cambios en megabytes. Este valor es un subconjunto del almacenamiento total del clúster (VolumeBytesUsed) y afecta al costo del clúster. Para obtener información acerca de los precios de almacenamiento, consulte la [página del producto de Amazon DocumentDB](https://aws.amazon.com//documentdb/pricing). El tamaño del registro de flujos de cambios es una función que indica la cantidad de cambios que se realizan en el clúster y el periodo en el que se conservará dicho registro de flujos de cambios. Para obtener más información acerca de las secuencias de cambio, consulte [Uso de flujos de cambios con Amazon DocumentDB](change_streams.md). |
| CPUUtilization | Porcentaje de CPU usado por una instancia. |
| DatabaseConnections | El número de conexiones abiertas (activas e inactivas) en una instancia tomada en una frecuencia de 1 minuto. |
| DatabaseConnectionsMax | El número máximo de conexiones abiertas (activas e inactivas) en una instancia en un período de 1 minuto. |
| DatabaseConnectionsLimit | El número máximo de conexiones de bases de datos simultáneas (activas e inactivas) permitidas en una instancia en un momento dado. |
| DatabaseCursors | El número de cursores abiertos en una instancia tomados en una frecuencia de 1 minuto. |
| DatabaseCursorsMax | El número máximo de cursores abiertos en una instancia en un período de 1 minuto. |
| DatabaseCursorsLimit | El número máximo de cursores permitidos en una instancia en un momento dado. |
| DatabaseCursorsTimedOut | El número de cursores cuyo tiempo de espera se agotó en un período de 1 minuto. |
| FreeableMemory | Cantidad de memoria de acceso aleatorio disponible en bytes. |
| FreeLocalStorage | Esta métrica indica la cantidad de almacenamiento disponible en cada instancia para las tablas y los registros temporales. Este valor depende de la clase de instancia. Puede aumentar la cantidad de espacio de almacenamiento libre para una instancia eligiendo una clase de instancia más grande para ella. (Esto no se aplica a DocumentDB Serverless). |
| LowMemThrottleQueueDepth | La profundidad de la cola para las solicitudes que están limitadas debido a la poca memoria disponible tomada en una frecuencia de 1 minuto. |
| LowMemThrottleMaxQueueDepth | La profundidad máxima de la cola para las solicitudes que están limitadas debido a la poca memoria disponible en un período de 1 minuto. |
| LowMemNumOperationsThrottled | El número de solicitudes que están limitadas debido a la poca memoria disponible en un período de 1 minuto. |
| SnapshotStorageUsed | La cantidad total de almacenamiento de copias de seguridad en bytes consumida por todas las instantáneas de un clúster de Amazon DocumentDB determinado fuera de su período de retención de la copia de seguridad. Se incluye en el total registrado por la métrica TotalBackupStorageBilled. Se calcula de forma independiente para cada clúster de Amazon DocumentDB. |
| SwapUsage | La cantidad de espacio de intercambio utilizado en la instancia. |
| TotalBackupStorageBilled | La cantidad total de almacenamiento de copias de seguridad en bytes facturada para un clúster de Amazon DocumentDB determinado. Incluye el almacenamiento de copias de seguridad medido por las métricas BackupRetentionPeriodStorageUsed y SnapshotStorageUsed. Se calcula de forma independiente para cada clúster de Amazon DocumentDB. |
| TransactionsOpen | El número de transacciones abiertas en una instancia en una frecuencia de 1 minuto. |
| TransactionsOpenMax | El número máximo de transacciones abiertas en una instancia en un período de 1 minuto. |
| TransactionsOpenLimit | El número máximo de transacciones simultáneas permitidas en una instancia en un momento dado. |
| VolumeBytesUsed | Cantidad de almacenamiento utilizada por el clúster en bytes. Este valor afecta al costo del clúster. Para obtener información acerca de los precios, consulte la [página del producto de Amazon DocumentDB](https://aws.amazon.com//documentdb/pricing). |
### Métricas de latencia
| Métrica | Description (Descripción) |
| --- | --- |
| DBClusterReplicaLagMaximum | Retardo máximo en milisegundos entre la instancia principal y cada instancia de base de datos de Amazon DocumentDB del clúster. |
| DBClusterReplicaLagMinimum | Retardo mínimo en milisegundos entre la instancia principal y cada instancia de réplica del clúster. |
| DBInstanceReplicaLag | La cantidad de retardo, en milisegundos, cuando la replicación actualiza desde la instancia principal a una instancia de réplica. |
| ReadLatency | La cantidad media de tiempo que tarda cada operación de disco I/O . |
| WriteLatency | La cantidad media de tiempo, en milisegundos, que se tarda en realizar cada I/O operación de disco. |
### NVMe-métricas de instancias respaldadas
| Métrica | Description (Descripción) |
| --- | --- |
| NVMeStorageCacheHitRatio | El porcentaje de solicitudes que se responden desde la caché por niveles. |
| FreeNVMeStorage | La cantidad de almacenamiento efímero NVMe disponible. |
| ReadIOPSNVMeStorage | El número promedio de I/O operaciones de lectura de disco para almacenamiento efímero NVMe . |
| ReadLatencyNVMeStorage | El tiempo medio que tarda cada I/O operación de lectura de disco en el almacenamiento efímero NVMe . |
| ReadThroughputNVMeStorage | El número promedio de bytes leídos del disco por segundo para el almacenamiento efímero NVMe . |
| WriteIOPSNVMeStorage | El número promedio de I/O operaciones de escritura en disco en un almacenamiento efímero NVMe . |
| WriteLatencyNVMeStorage | El tiempo medio que tarda cada I/O operación de escritura en disco en el almacenamiento efímero NVMe . |
| WriteThroughputNVMeStorage | El número promedio de bytes escritos en el disco por segundo para el almacenamiento efímero NVMe . |
### Métricas operativas
| Métrica | Description (Descripción) |
| --- | --- |
| DocumentsDeleted | El número de documentos eliminados en un período de 1 minuto. |
| DocumentsInserted | El número de documentos insertados en un período de 1 minuto. |
| DocumentsReturned | El número de documentos devueltos en un período de 1 minuto. |
| DocumentsUpdated | El número de documentos actualizados en un período de 1 minuto. |
| OpcountersCommand | El número de comandos emitidos en un período de 1 minuto. |
| OpcountersDelete | El número de operaciones de eliminación emitidas en un período de 1 minuto. |
| OpcountersGetmore | El número de getmores emitidos en un período de 1 minuto. |
| OpcountersInsert | El número de operaciones de inserción emitidas en un período de 1 minuto. |
| OpcountersQuery | El número de consultas emitidas en un período de 1 minuto. |
| OpcountersUpdate | El número de operaciones de actualización emitidas en un período de 1 minuto. |
| TransactionsStarted | El número de transacciones iniciadas en una instancia en un período de 1 minuto. |
| TransactionsCommitted | El número de transacciones realizadas en una instancia en un período de 1 minuto. |
| TransactionsAborted | El número de transacciones canceladas en una instancia en un período de 1 minuto. |
| TTLDeletedDocuments | El número de documentos eliminados por a TTLMonitor en un período de 1 minuto. |
### Métricas de rendimiento
| Métrica | Description (Descripción) |
| --- | --- |
| NetworkReceiveThroughput | Cantidad de rendimiento de red en bytes por segundo recibida de los clientes por cada instancia del clúster. Este rendimiento no incluye el tráfico de red entre las instancias del clúster y el volumen del clúster. |
| NetworkThroughput | Cantidad de rendimiento de red en bytes por segundo recibida de los clientes y transmitida a ellos por cada instancia del clúster de Amazon DocumentDB. Este rendimiento no incluye el tráfico de red entre las instancias del clúster y el volumen del clúster. |
| NetworkTransmitThroughput | Cantidad de rendimiento de red en bytes por segundo enviada a los clientes por cada instancia del clúster de base de datos. Este rendimiento no incluye el tráfico de red entre las instancias del clúster y el volumen del clúster. |
| ReadIOPS | El número medio de I/O operaciones de lectura del disco por segundo. Amazon DocumentDB indica las IOPS de lectura y escritura por separado, en intervalos de 1 minuto. |
| ReadThroughput | El número medio de bytes leídos del disco por segundo. |
| StorageNetworkReceiveThroughput | Cantidad de rendimiento de red en bytes por segundo recibida del volumen de almacenamiento del clúster de Amazon DocumentDB por cada instancia del clúster. |
| StorageNetworkTransmitThroughput | Cantidad de rendimiento de red en bytes por segundo enviada al volumen de almacenamiento del clúster de Amazon DocumentDB por cada instancia del clúster. |
| StorageNetworkThroughput | Cantidad de rendimiento de red en bytes por segundo recibida y enviada al volumen de almacenamiento del clúster de Amazon DocumentDB por cada instancia del clúster de Amazon DocumentDB. |
| VolumeReadIOPs | El número promedio de I/O operaciones de lectura facturadas desde un volumen de clúster, registrado en intervalos de 5 minutos. Las operaciones de lectura facturadas se calculan en el nivel del volumen de clúster, se agrupan para todas las instancias del clúster y se notifican a intervalos de 5 minutos. El valor se calcula tomando el valor de la métrica de operaciones de lectura a lo largo de un periodo de 5 minutos. Puede determinar la cantidad de operaciones de lectura facturadas por segundo tomando el valor de la métrica de operaciones de lectura facturadas y dividiéndola por 300 segundos. Por ejemplo, si las `VolumeReadIOPs` devuelven 13 686, las operaciones de lectura facturadas por segundo serán 45 (13 686/300 = 45,62). Las operaciones de lectura facturadas se acumulan para las consultas que solicitan páginas de la base de datos que no están presentes en la caché del búfer y que por tanto se deben cargar desde el almacenamiento. Es posible que aparezcan picos en las operaciones de lectura facturadas, ya que los resultados de la consulta se leen desde el almacenamiento y se cargan en la caché del búfer. |
| VolumeWriteIOPs | El número promedio de I/O operaciones de escritura facturadas desde un volumen de clúster, registrado en intervalos de 5 minutos. Las operaciones de escritura facturadas se calculan en el nivel del volumen de clúster, se agrupan para todas las instancias del clúster y se notifican a intervalos de 5 minutos. El valor se calcula tomando el valor de la métrica de operaciones de escritura a lo largo de un periodo de 5 minutos. Puede determinar la cantidad de operaciones de escritura facturadas por segundo tomando el valor de la métrica de operaciones de escritura facturadas y dividiendo por 300 segundos. Por ejemplo, si las `VolumeWriteIOPs` devuelven 13 686, las operaciones de escritura facturadas por segundo serán 45 (13 686/300 = 45,62). Tenga en cuenta que `VolumeReadIOPs` las `VolumeWriteIOPs` métricas se calculan mediante la capa de almacenamiento de DocumentDB e incluyen las IOs realizadas por las instancias principal y de réplica. Los datos se agregan cada 20 a 30 minutos y después, se generan informes en intervalos de 5 minutos, por lo que se emite el mismo punto de datos para la métrica en el período de tiempo. Si busca una métrica que se correlacione con tus operaciones de inserción en un intervalo de 1 minuto, puede usar la métrica WriteIOps a nivel de instancia. La métrica está disponible en la pestaña de supervisión de la instancia principal de Amazon DocumentDB. |
| WriteIOPS | El número promedio de I/O operaciones de escritura en disco por segundo. Cuando se utilizan a nivel de clúster, WriteIOPs se evalúan en todas las instancias del clúster. Las IOPS de lectura y escritura se registran por separado, en intervalos de 1 minuto. |
| WriteThroughput | Número medio de bytes que se escriben en el disco por segundo. |
### Métricas del sistema
| Métrica | Description (Descripción) |
| --- | --- |
| AvailableMVCCIds | Un contador que muestra el número de operaciones de escritura restantes disponibles antes de llegar a cero. Cuando este contador llegue a cero, el clúster pasará al modo de solo lectura hasta que IDs se recupere y se recicle. El contador disminuye con cada operación de escritura y aumenta a medida que la recolección de basura recicla el MVCC antiguo. IDs |
| BufferCacheHitRatio | Porcentaje de solicitudes que se responden desde la caché de búfer. |
| DiskQueueDepth | El número de I/O operaciones que están esperando a escribirse o leerse desde el disco. |
| EngineUptime | Cantidad de tiempo en segundos que la instancia lleva en ejecución. |
| IndexBufferCacheHitRatio | Porcentaje de solicitudes de índice que se responden desde la caché de búfer. Es posible que vea un pico superior al 100 % en la métrica justo después de eliminar un índice, una colección o una base de datos. Esto se resolverá automáticamente después de 60 segundos. Esta limitación se corregirá en una actualización futura del parche. |
| LongestActiveGCRuntime | Duración en segundos del proceso activo de recopilación de elementos no utilizados más prolongado. Se actualiza cada minuto y realiza un seguimiento únicamente de las operaciones activas, excluyendo los procesos que se completan en el intervalo de un minuto. |
### Métricas de la instancia T3
| Métrica | Description (Descripción) |
| --- | --- |
| CPUCreditUsage | El número total de créditos de CPU que se han gastado durante el periodo de medición. |
| CPUCreditBalance | El número de créditos de la CPU que ha acumulado una instancia. Este saldo se agota cuando la CPU realiza ráfagas y los créditos de CPU se gastan más rápido de lo que se obtienen. |
| CPUSurplusCreditBalance | El número de créditos de CPU sobrantes que se utilizan para mantener el rendimiento de la CPU cuando el valor de CPUCredit equilibrio es cero. |
| CPUSurplusCreditsCharged | El número de créditos de CPU sobrantes que superen la cantidad máxima de créditos de CPU que se pueden obtener en un periodo de 24 horas y que, por lo tanto, generan gastos adicionales. Para obtener más información, consulte [Monitoreo de sus créditos CPU](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-monitoring-cpu-credits.html). |
## Visualización CloudWatch de datos
Puede ver CloudWatch los datos de Amazon mediante la CloudWatch consola, la consola Amazon DocumentDB, AWS Command Line Interface (AWS CLI) o la CloudWatch API.
------
#### [ Using the Consola de administración de AWS ]
Para ver CloudWatch las métricas mediante la consola de administración de Amazon DocumentDB, complete los siguientes pasos.
1. [Inicie sesión en y abra la Consola de administración de AWS 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 **Clusters (Clústeres)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres en la que se muestra cómo se anida una instancia en un clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. En la lista de instancias, seleccione el nombre de la instancia de la que desea ver las métricas.
1. En la página de resumen de instancias resultante, seleccione la pestaña **Monitorización** para ver las representaciones gráficas de las métricas de su instancia de Amazon DocumentDB. Como se debe generar un gráfico para cada métrica, los **CloudWatch**gráficos pueden tardar unos minutos en rellenarse.
La siguiente imagen muestra las representaciones gráficas de dos CloudWatch métricas en la consola Amazon DocumentDB y`WriteIOPS`. `ReadIOPS`
![\[Dos gráficos de líneas que representan las métricas de WriteIOPS y CloudWatch ReadiOps en la consola Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cw-metrics-con.png)
------
#### [ Using the CloudWatch Management Console ]
Para ver CloudWatch las métricas mediante la consola de CloudWatch administración, complete los siguientes pasos.
1. Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en. [https://console.aws.amazon.com/cloudwatch](https://console.aws.amazon.com/cloudwatch)
1. En el panel de navegación, seleccione **Métricas**. A continuación, en la lista de nombres de servicios, elija **DocDB**.
1. Elija una dimensión de métrica (por ejemplo, **Métricas del clúster**).
1. La pestaña **Todas las métricas** muestra todas las métricas para dicha dimensión en **DocDB**.
1. Para ordenar la tabla, utilice el encabezado de columna.
1. Para representar gráficamente una métrica, active la casilla de verificación situada junto a ella. Para seleccionar todas las métricas, seleccione la casilla de verificación en la fila de encabezado de la tabla.
1. Para filtrar por métrica, coloque el cursor sobre el nombre de la métrica y seleccione la flecha desplegable situada junto al nombre de la métrica. A continuación, selecciona **Añadir a la búsqueda**, como se muestra en la siguiente imagen.
![\[En la pestaña Todas las métricas, se muestran las métricas y aparece una lista desplegable para el nombre de la métrica.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cloudwatch-filter-metrics.png)
------
#### [ Using the AWS CLI ]
Para ver CloudWatch los datos de Amazon DocumentDB, utilice la CloudWatch `get-metric-statistics` operación con los siguientes parámetros.
**Parameters**
+ **--namespace**: obligatorio. El espacio de nombres del servicio para el que desea obtener métricas de CloudWatch . Para Amazon DocumentDB, debe ser `AWS/DocDB`.
+ **--metric-name**: obligatorio. El nombre de la métrica para la que desea obtener datos.
+ **--start-time**: obligatorio. La marca temporal que determina el primer punto de datos que se va a devolver.
El valor especificado es inclusivo; los resultados incluyen puntos de datos con la marca temporal especificada. La marca temporal debe estar en el formato UTC ISO 8601 (por ejemplo, 2016-10-03T23:00:00 Z).
+ **--end-time**: obligatorio. La marca temporal que determina el último punto de datos que se va a devolver.
El valor especificado es inclusivo; los resultados incluyen puntos de datos con la marca temporal especificada. La marca temporal debe estar en el formato UTC ISO 8601 (por ejemplo, 2016-10-03T23:00:00 Z).
+ **--period**: obligatorio. El grado de detalle, en segundos, de los puntos de datos devueltos. Para las métricas con una resolución normal, un periodo puede ser tan breve como un minuto (60 segundos) y debe ser un múltiplo de 60. Para las métricas de alta resolución que se recopilan a intervalos de menos de un minuto, el periodo puede ser 1, 5, 10, 30, 60 o cualquier múltiplo de 60.
+ **--dimensions**— Opcional. Si la métrica contiene varias dimensiones, debe incluir un valor para cada dimensión. CloudWatch trata cada combinación única de dimensiones como una métrica independiente. No se pueden recuperar estadísticas utilizando combinaciones de dimensiones que no se han publicado. Debe especificar las mismas dimensiones que se utilizaron al crear las métricas.
+ **--statistics**: opcional. La estadística de la métrica, distinta del percentil. Para la estadística de percentil, utilice `ExtendedStatistics`. Cuando llama a `GetMetricStatistics`, debe especificar `Statistics` o `ExtendedStatistics`, pero no ambos.
**Valores permitidos:**
+ `SampleCount`
+ `Average`
+ `Sum`
+ `Minimum`
+ `Maximum`
+ **--extended-statistics**: opcional. La estadística `percentile`. Especifique valores comprendidos entre p0.0 y p100. Cuando llama a `GetMetricStatistics`, debe especificar `Statistics` o `ExtendedStatistics`, pero no ambos.
+ **--unit**: opcional. La unidad de una métrica determinada. Las métricas se pueden registrar en varias unidades. Si no se especifica una unida, se devuelven todas las unidades. Si especifica solo una unidad que la métrica no registra, los resultados de la llamada son nulos.
**Valores posibles:**
+ `Seconds`
+ `Microseconds`
+ `Milliseconds`
+ `Bytes`
+ `Kilobytes`
+ `Megabytes`
+ `Gigabytes`
+ `Terabytes`
+ `Bits`
+ `Kilobytes`
+ `Megabits`
+ `Gigabits`
+ `Terabits`
+ `Percent`
+ `Count`
+ `Bytes/Second`
+ `Kilobytes/Second`
+ `Megabytes/Second`
+ `Gigabytes/Second`
+ `Terabytes/Second`
+ `Bits/Second`
+ `Kilobits/Second`
+ `Megabits/Second`
+ `Gigabits/Second`
+ `Terabits/Second`
+ `Count/Second`
+ `None`
**Example**
En el siguiente ejemplo se busca el valor máximo de `CPUUtilization` para un periodo de 2 horas tomando una muestra cada 60 segundos.
Para Linux, macOS o Unix:
```
aws cloudwatch get-metric-statistics \
--namespace AWS/DocDB \
--dimensions \
Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 \
--metric-name CPUUtilization \
--start-time 2019-02-11T05:00:00Z \
--end-time 2019-02-11T07:00:00Z \
--period 60 \
--statistics Maximum
```
Para Windows:
```
aws cloudwatch get-metric-statistics ^
--namespace AWS/DocDB ^
--dimensions ^
Name=DBInstanceIdentifier,Value=docdb-2019-01-09-23-55-38 ^
--metric-name CPUUtilization ^
--start-time 2019-02-11T05:00:00Z ^
--end-time 2019-02-11T07:00:00Z ^
--period 60 ^
--statistics Maximum
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"Label": "CPUUtilization",
"Datapoints": [
{
"Unit": "Percent",
"Maximum": 4.49152542374361,
"Timestamp": "2019-02-11T05:51:00Z"
},
{
"Unit": "Percent",
"Maximum": 4.25000000000485,
"Timestamp": "2019-02-11T06:44:00Z"
},
********* some output omitted for brevity *********
{
"Unit": "Percent",
"Maximum": 4.33333333331878,
"Timestamp": "2019-02-11T06:07:00Z"
}
]
}
```
------
## Dimensiones de Amazon DocumentDB
Las métricas de Amazon DocumentDB se identifican por los valores de la cuenta o de la operación. Puede utilizar la CloudWatch consola para recuperar los datos de Amazon DocumentDB filtrados por cualquiera de las dimensiones de la tabla siguiente.
| Dimensión | Description (Descripción) |
| --- | --- |
| DBClusterIdentifier | Filtra los datos solicitados que son específicos del clúster de Amazon DocumentDB. |
| DBClusterIdentifier, Role | Filtra los datos solicitados para un clúster de Amazon DocumentDB específico, agrupando las métricas por rol de instancia (WRITER/READER). Por ejemplo, puede agregar métricas para todas las instancias READER que pertenezcan a un clúster. |
| DBInstanceIdentifier | Filtra los datos solicitados para una instancia de base de datos específica. |
## Supervisión de métricas de Opcounter
Las métricas de Opcounter tienen un valor distinto de cero (normalmente \$1 50) para los clústeres inactivos. Esto se debe a que Amazon DocumentDB realiza comprobaciones de estado periódicas, operaciones internas y tareas de recopilación de métricas.
## Supervisión de conexiones a bases de datos
Al ver el número de conexiones mediante comandos del motor de base de datos, por ejemplo`db.runCommand( { serverStatus: 1 })`, es posible que vea hasta 10 conexiones más de las que ve. `DatabaseConnections` CloudWatch Esto ocurre porque Amazon DocumentDB realiza comprobaciones de estado periódicas y tareas de recopilación de métricas que no se tienen en cuenta en `DatabaseConnections`. `DatabaseConnections` representa únicamente las conexiones iniciadas por el cliente.
# Registro de llamadas a la API de Amazon DocumentDB con AWS CloudTrail
Amazon DocumentDB (con compatibilidad con MongoDB) se integra con AWS CloudTrail, un servicio que proporciona un registro de las medidas adoptadas por un usuario, un rol o un servicio de AWS en Amazon DocumentDB (compatible con MongoDB). CloudTrail obtiene todas las llamadas a la AWS CLI API para Amazon DocumentDB como eventos, incluidas las llamadas procedentes de la consola de Amazon DocumentDB y de las llamadas de código de la SDK de Amazon DocumentDB. Si crea un registro de seguimiento, puede habilitar la entrega continua de eventos de CloudTrail a un bucket de Amazon S3, incluidos los eventos de Amazon DocumentDB. Si no configura un registro de seguimiento, puede ver los eventos más recientes en la consola de CloudTrail en el **Historial de eventos**. Mediante la información que CloudTrail recopila, se puede determinar la petición que se envió a Amazon DocumentDB (con compatibilidad con MongoDB), la dirección IP desde la que se realizó la petición, quién la realizó, cuándo se realizó y otros detalles adicionales.
**importante**
Para determinadas funciones de administración, Amazon DocumentDB utiliza tecnología operativa que se comparte con Amazon Relational Database Service (Amazon RDS). Las llamadas a la consola de Amazon DocumentDB, la AWS CLI y la API se registran como llamadas realizadas a la API de Amazon RDS.
Para obtener más información sobre AWS CloudTrail, consulte la [Guía del usuario de AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Información de Amazon DocumentDB en CloudTrail
CloudTrail se habilita en su Cuenta de AWS cuando se crea la cuenta. Cuando se produce una actividad en Amazon DocumentDB (con compatibilidad con MongoDB), dicha actividad se registra en un evento de CloudTrail junto con los eventos de los demás servicios de AWS en **Historial de eventos**. Puede ver, buscar y descargar eventos recientes en su Cuenta de AWS. Para obtener más información, consulte [Ver eventos con el historial de eventos de CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Para mantener un registro continuo de los eventos en su Cuenta de AWS, incluidos los eventos de Amazon DocumentDB (con compatibilidad con MongoDB), cree un registro de seguimiento. Un registro de seguimiento permite a CloudTrail enviar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las Regiones de AWS. El registro de seguimiento registra los eventos de todas las regiones de la partición de AWS y envía los archivos de registro al bucket de Amazon S3 especificado. También es posible configurar otros servicios de AWS para analizar en profundidad y actuar en función de los datos de eventos recopilados en los registros de CloudTrail. Para obtener más información, consulte los siguientes temas en la *Guía del usuario de AWS CloudTrail*:
+ [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [Consulte Servicios e integraciones compatibles con CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configuración de notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Recepción de archivos de registro de CloudTrail de multirregiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Recepción de archivos de registro de CloudTrail de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Cada entrada de registro o evento incluye información acerca de quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente:
+ Si la solicitud se realizó con las credenciales raíz o del usuario.
+ Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.
+ Si la solicitud la realizó otro servicio de AWS.
Para obtener más información, consulte el [Elemento userIdentity de CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
# Creación de perfiles de operaciones en Amazon DocumentDB
Puede utilizar el generador de perfiles en Amazon DocumentDB (compatible con MongoDB) para registrar el tiempo de ejecución y los detalles de las operaciones realizadas en el clúster. El generador de perfiles es útil para monitorizar las operaciones más lentas del clúster para ayudarle a mejorar el rendimiento de las consultas individuales y el rendimiento general del clúster.
De forma predeterminada, la característica del generador de perfiles está deshabilitada. Cuando está activado, el generador de perfiles registra en Amazon Logs las operaciones que tardan más de un valor límite definido por el cliente (por ejemplo, 100 ms). CloudWatch Los detalles registrados incluyen el comando con perfil, la hora, el resumen del plan y los metadatos del cliente. Una vez registradas las operaciones en CloudWatch Logs, puede utilizar CloudWatch Logs Insights para analizar, supervisar y archivar los datos de creación de perfiles de Amazon DocumentDB. En la sección [Consultas comunes](#profiling.common-queries) se proporcionan consultas comunes.
Cuando está habilitado, el generador de perfiles utiliza recursos adicionales en el clúster. Le recomendamos que comience con un valor de umbral alto (por ejemplo, 500 ms) y que reduzca gradualmente el valor para identificar las operaciones lentas. Comenzar con un valor umbral de 50 ms puede provocar problemas de rendimiento en el clúster para aplicaciones de alto rendimiento. El generador de perfiles está habilitado en el nivel de clúster y funciona en todas las instancias y bases de datos de un clúster. Amazon DocumentDB registra las operaciones en Amazon CloudWatch Logs según el mejor esfuerzo posible.
Aunque Amazon DocumentDB no impone ningún cargo adicional para habilitar el generador de perfiles, se le cobran las tarifas estándar por el uso de Logs. CloudWatch Para obtener información sobre CloudWatch los precios de Logs, consulta [ CloudWatch los precios de Amazon](https://aws.amazon.com/cloudwatch/pricing/).
**Topics**
+ [Operaciones admitidas](#profiling.supported-commands)
+ [Limitaciones](#profiling.limitations)
+ [Habilitación del generador de perfiles](#profiling.enable-profiling)
+ [Deshabilitación del generador de perfiles](#profiling.disable-profiling)
+ [Deshabilitación de la exportación de registros del generador de perfiles](#profiling.disabling-logs-export)
+ [Acceso a los registros del generador de perfiles](#profiling.accessing)
+ [Consultas comunes](#profiling.common-queries)
## Operaciones admitidas
El generador de perfiles de Amazon DocumentDB admite las siguientes operaciones:
+ `aggregate`
+ `count`
+ `delete`
+ `distinct`
+ `find` (OP\$1QUERY y comando)
+ `findAndModify`
+ `insert`
+ `update`
## Limitaciones
El generador de perfiles de consultas lento solo puede emitir registros del generador de perfiles si todo el conjunto de resultados de la consulta puede caber en un lote y si el conjunto de resultados es inferior a 16 MB (tamaño máximo de BSON). Los conjuntos de resultados de más de 16 MB se dividen automáticamente en varios lotes.
La mayoría de los controladores o carcasas pueden establecer un tamaño de lote predeterminado que sea pequeño. Puede especificar el tamaño del lote como parte de su consulta. Con el fin de capturar registros de consultas lentos, recomendamos un tamaño de lote que supere el tamaño del conjunto de resultados esperado. Si no está seguro del tamaño del conjunto de resultados o si varía, también puede establecer el tamaño del lote en un número grande (por ejemplo, 100 000).
Sin embargo, si se utiliza un tamaño de lote mayor, será necesario recuperar más resultados de la base de datos antes de enviar una respuesta al cliente. En el caso de algunas consultas, esto puede provocar demoras más prolongadas antes de obtener los resultados. Si no planea consumir todo el conjunto de resultados, es posible que gaste más en I/Os procesar la consulta y desperdiciar el resultado.
## Habilitación del generador de perfiles de Amazon DocumentDB
Habilitar el generador de perfiles en un clúster es un proceso de tres pasos. Asegúrese de completar todos los pasos o los registros de creación de perfiles no se enviarán a CloudWatch Logs. El generador de perfiles se establece en el nivel de clúster y se realiza en todas las bases de datos e instancias del clúster.
**Habilitación del generador de perfiles en un clúster**
1. Dado que no puede modificar un grupo de parámetros de clúster predeterminado, asegúrese de que dispone de un grupo de parámetros de clúster personalizado disponible. Para obtener más información, consulte [Creación de grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-create.md).
1. Con un grupo de parámetros de clúster personalizado disponible, modifique los siguientes parámetros: `profiler`, `profiler_threshold_ms` y `profiler_sampling_rate`. Para obtener más información, consulte [Modificación de grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-modify.md).
1. Cree o modifique el clúster para utilizar el grupo de parámetros del clúster personalizado y permitir la exportación de `profiler` registros a CloudWatch registros.
En las siguientes secciones, se muestra cómo implementar estos pasos con Consola de administración de AWS y AWS Command Line Interface (AWS CLI).
------
#### [ Using the Consola de administración de AWS ]
1. Antes de comenzar, cree un clúster de Amazon DocumentDB y un grupo de parámetros de clúster personalizado si aún no tiene uno. Para obtener más información, consulte [Creación de grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-create.md) y [Creación de un clúster de Amazon DocumentDB](db-cluster-create.md).
1. Utilice un grupo de parámetros de clúster personalizado disponible para modificar los siguientes parámetros. Para obtener más información, consulte [Modificación de grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ `profiler`: habilita o deshabilita la creación de perfiles de consultas. Los valores permitidos son `enabled ` y `disabled`. El valor predeterminado es `disabled`. Para habilitar la creación de perfiles, establezca el valor en `enabled`.
+ `profiler_threshold_ms`— Cuando `profiler` está configurado en`enabled`, se ` profiler_threshold_ms` registran todos los comandos que tardan más de lo que tarda CloudWatch. Los valores permitidos son `[50-INT_MAX]`. El valor predeterminado es `100`.
+ `profiler_sampling_rate`: la fracción de las operaciones lentas que deben registrarse o crear un perfil. Los valores permitidos son `[0.0-1.0]`. El valor predeterminado es `1.0`.
1. Modifica tu clúster para usar el grupo de parámetros de clúster personalizado y configura las exportaciones de registros del generador de perfiles para que se publiquen en Amazon CloudWatch.
1. En el panel de navegación, elija **Clusters (Clústeres)** para agregar el grupo de parámetros personalizado a un clúster.
1. Elija el botón situado a la izquierda del nombre del clúster al que desea asociar el grupo de parámetros. Seleccione **Actions (Acciones)** y, a continuación, **Modify (Modificar)** para modificar el clúster.
1. En **Cluster options (Opciones de clúster)**, elija el grupo de parámetros personalizados del paso anterior para agregárselo al clúster.
1. En **Exportaciones de registros**, selecciona **Registros de Profiler** para publicarlos en Amazon CloudWatch.
1. Elija **Continue (Continuar)** para ver un resumen de las modificaciones.
1. Después de verificar los cambios, puede aplicarlos inmediatamente o durante el siguiente período de mantenimiento en **Scheduling of modifications (Programación de modificaciones)**.
1. Elija **Modify cluster (Modificar clúster)** para actualizar el clúster con el nuevo grupo de parámetros.
------
#### [ Using the AWS CLI ]
El siguiente procedimiento habilita el generador de perfiles en todas las operaciones admitidas para el clúster `sample-cluster`.
1. Antes de comenzar, asegúrese de tener un grupo de parámetros de clúster personalizado disponible; para ello, ejecute el siguiente comando y revise el resultado de un grupo de parámetros de clúster cuyo nombre no contenga `default` y cuya familia de grupos de parámetros sea `docdb3.6`. Si no tiene un grupo de parámetros de clúster distinto del predeterminado, consulte [Creación de grupos de parámetros de clúster de Amazon DocumentDB](cluster_parameter_groups-create.md).
```
aws docdb describe-db-cluster-parameter-groups \
--query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName,DBParameterGroupFamily]'
```
En el siguiente resultado, solo `sample-parameter-group ` cumple ambos criterios.
```
[
[
"default.docdb3.6",
"docdb3.6"
],
[
"sample-parameter-group",
"docdb3.6"
]
]
```
1. Utilizando el grupo de parámetros de clúster personalizado, modifique los siguientes parámetros:
+ `profiler`: habilita o deshabilita la creación de perfiles de consultas. Los valores permitidos son `enabled ` y `disabled`. El valor predeterminado es `disabled`. Para habilitar la creación de perfiles, establezca el valor en `enabled`.
+ `profiler_threshold_ms`— Cuando `profiler` está configurado en`enabled`, todos los comandos tardan más tiempo del que `profiler_threshold_ms` se registran. CloudWatch Los valores permitidos son `[50-INT_MAX]`. El valor predeterminado es `100`.
+ `profiler_sampling_rate`: la fracción de las operaciones lentas que deben registrarse o crear un perfil. Los valores permitidos son `[0.0-1.0]`. El valor predeterminado es `1.0`.
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters ParameterName=profiler,ParameterValue=enabled,ApplyMethod=immediate \
ParameterName=profiler_threshold_ms,ParameterValue=100,ApplyMethod=immediate \
ParameterName=profiler_sampling_rate,ParameterValue=0.5,ApplyMethod=immediate
```
1. Modifique el clúster de Amazon DocumentDB para que utilice el grupo de parámetros de clúster personalizado `sample-parameter-group` del paso anterior y establezca el parámetro `--enable-cloudwatch-logs-exports` a `profiler`.
El siguiente código modifica el clúster `sample-cluster` para que utilice el `sample-parameter-group` del paso anterior y lo añade `profiler` a las exportaciones de CloudWatch registros habilitadas.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--db-cluster-parameter-group-name sample-parameter-group \
--cloudwatch-logs-export-configuration '{"EnableLogTypes":["profiler"]}'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2020-04-07T02:05:12.479Z",
"Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "3.6.0",
"LatestRestorableTime": "2020-04-08T22:08:59.317Z",
"Port": 27017,
"MasterUsername": "test",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"EnabledCloudwatchLogsExports": [
"profiler"
],
"DeletionProtection": true
}
}
```
------
## Deshabilitación del generador de perfiles de Amazon DocumentDB
Para deshabilitar el generador de perfiles, deshabilite tanto el `profiler` parámetro como la exportación de `profiler` registros a CloudWatch Logs.
### Deshabilitación del generador de perfiles
Puede deshabilitar el `profiler` parámetro utilizando las teclas Consola de administración de AWS o AWS CLI de la siguiente manera.
------
#### [ Using the Consola de administración de AWS ]
El siguiente procedimiento utiliza el Consola de administración de AWS para deshabilitar Amazon DocumentDB`profiler`.
1. [Inicie sesión en y abra la Consola de administración de AWS 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 **Grupos de parámetros**. A continuación, elija el nombre del grupo de parámetros de clúster en el que desea deshabilitar el generador de perfiles.
1. En la página **Cluster parameters (Parámetros de clúster)** resultante, seleccione el botón situado a la izquierda del parámetro `profiler` y elija **Edit (Editar)**.
1. En el cuadro de diálogo **Modify profiler (Modificar generador de perfiles)**, elija `disabled` en la lista.
1. Elija **Modify cluster parameter (Modificar el parámetro de clúster)**.
------
#### [ Using the AWS CLI ]
Para deshabilitar `profiler` en un clúster mediante la AWS CLI, modifique el clúster tal y como se muestra a continuación.
```
aws docdb modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name sample-parameter-group \
--parameters ParameterName=profiler,ParameterValue=disabled,ApplyMethod=immediate
```
------
## Deshabilitación de la exportación de registros del generador de perfiles
Puede deshabilitar la exportación de `profiler` registros a CloudWatch registros utilizando las opciones Consola de administración de AWS o bien de la siguiente AWS CLI manera.
------
#### [ Using the Consola de administración de AWS ]
El siguiente procedimiento utiliza el Consola de administración de AWS para deshabilitar la exportación de registros a Amazon DocumentDB. CloudWatch
1. [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 **Clusters (Clústeres)**. Elija el botón situado a la izquierda del nombre del clúster para el que desea deshabilitar la exportación de registros.
1. En el menú **Actions (Acciones)**, elija **Modify (Modificar)**.
1. Desplácese hacia abajo hasta la sección **Log exports (Exportaciones de registros)** y desactive **Profiler logs (Registros del generador de perfiles)**.
1. Elija **Continuar**.
1. Revise los cambios y, a continuación, elija cuándo desea que se aplique este cambio en su clúster:
+ **Apply during the next scheduled maintenance window (Aplicar durante el siguiente periodo de mantenimiento programado)**
+ **Apply immediately (Aplicar inmediatamente)**
1. Elija **Modificar clúster**.
------
#### [ Using the AWS CLI ]
El siguiente código modifica el clúster e inhabilita los registros del generador de `sample-cluster ` perfiles. CloudWatch
**Example**
Para Linux, macOS o Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
Para Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--cloudwatch-logs-export-configuration '{"DisableLogTypes":["profiler"]}'
```
La salida de esta operación será similar a lo que se indica a continuación.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2020-04-08T02:05:17.266Z",
"Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "3.6.0",
"LatestRestorableTime": "2020-04-09T05:14:44.356Z",
"Port": 27017,
"MasterUsername": "test",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"DeletionProtection": true
}
}
```
------
## Acceso a los registros del generador de perfiles de Amazon DocumentDB
Sigue estos pasos para acceder a los registros de tu perfil en Amazon CloudWatch.
1. Abre la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Asegúrese de que se encuentra en la misma región que el clúster de Amazon DocumentDB.
1. En el panel de navegación, elija **Logs (Registros)**.
1. Para encontrar los registros del generador de perfiles de su clúster, en la lista, elija `/aws/docdb/yourClusterName/profiler`.
Los registros de perfil de cada una de las instancias están disponibles debajo de los nombres de instancia respectivos.
## Consultas comunes
A continuación se muestran algunas consultas comunes que puede utilizar para analizar los comandos con perfil. Para obtener más información sobre CloudWatch Logs Insights, consulte [Análisis de datos de registro con CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) y [consultas de muestra](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax-examples.html).
### Obtención de las 10 operaciones más lentas en una colección especificada
```
filter ns="test.foo" | sort millis desc | limit 10
```
### Obtención de todas las operaciones de actualización de una colección que tardaron más de 60 ms
```
filter millis > 60 and op = "update"
```
### Obtención de las 10 operaciones más lentas del último mes
```
sort millis desc | limit 10
```
### Obtener todas las consultas con un resumen de plan COLLSCAN
```
filter planSummary="COLLSCAN"
```
# Supervisión con información sobre rendimiento
Información sobre rendimiento amplía las características de monitorización existentes de Amazon DocumentDB para ilustrar el desempeño de su clúster y le ayuda a analizar cualquier problema que le afecte. Con el panel de Información sobre rendimiento, puede visualizar la carga de la base de datos y filtrarla por esperas, instrucciones de consulta, hosts o usuarios.
**nota**
Performance Insights solo está disponible para los clústeres basados en instancias de Amazon DocumentDB 3.6, 4.0, 5.0 y 8.0.
**¿Para qué sirve?**
+ Visualice el rendimiento de la base de datos: visualice la carga para determinar cuándo y dónde se encuentra la carga en la base de datos
+ Determine la causa de la carga en la base de datos: determine qué consultas, hosts y aplicaciones contribuyen a la carga de la instancia
+ Determine cuándo hay carga en su base de datos: amplíe el panel de Información sobre rendimiento para centrarse en eventos específicos o reduzca el tamaño para observar las tendencias a lo largo de un período de tiempo más amplio
+ Alerta sobre la carga de la base de datos: acceda automáticamente a las nuevas métricas de carga de la base de datos desde CloudWatch donde podrá monitorizar las métricas de carga de la base de datos junto con otras métricas de Amazon DocumentDB y establecer alertas en ellas.
**¿Cuáles son las limitaciones de Información sobre rendimiento de Amazon DocumentDB?**
+ Performance Insights en las regiones AWS GovCloud (EE. UU. Este) y AWS GovCloud (EE. UU. Oeste) no están disponibles
+ La Información sobre rendimiento para Amazon DocumentDB retiene hasta 7 días de datos de rendimiento
+ Las consultas de más de 1024 bytes no se agregan en Información sobre rendimiento
**Topics**
+ [Conceptos de Información sobre rendimiento](performance-insights-concepts.md)
+ [Activación y desactivación de Información sobre rendimiento](performance-insights-enabling.md)
+ [Configuración de directivas de acceso para información sobre rendimiento](performance-insights-policies.md)
+ [Análisis de métricas mediante el panel de Información sobre rendimiento](performance-insights-analyzing.md)
+ [Recuperación de métricas con la API de Información sobre rendimiento](performance-insights-metrics.md)
+ [CloudWatch Métricas de Amazon para Performance Insights](performance-insights-cloudwatch.md)
+ [Métricas de contador para Información sobre rendimiento](performance-insights-counter-metrics.md)
# Conceptos de Información sobre rendimiento
**Topics**
+ [Sesiones activas promedio](#performance-insights-concepts-sessions)
+ [Dimensiones](#performance-insights-concepts-dimensions)
+ [Max vCPU](#performance-insights-concepts-maxvcpu)
## Sesiones activas promedio
La carga de base de datos mide el nivel de actividad en la base de datos. La métrica clave en Información sobre rendimiento es `DB Load`, que se recopila cada segundo. La unidad para la métrica `DBLoad` es el *promedio de sesiones activas (AAS)* de la instancia de Amazon DocumentDB.
Una sesión *activa* es una conexión que ha enviado trabajo a la instancia de Amazon DocumentDB y está esperando una respuesta. Por ejemplo, si envía una consulta a una instancia de Amazon DocumentDB, la sesión de base de datos estará activa mientras el motor de base de datos procesa la consulta.
Para obtener un promedio de sesiones activas, la Información sobre rendimiento muestrea el número de sesiones que ejecutan una consulta al mismo tiempo. El AAS es el total del número de sesiones dividido entre el total del número de muestras. En la tabla siguiente se muestran 5 ejemplos consecutivos de una consulta en ejecución.
| Ejemplo | Número de sesiones que ejecutan una consulta | AAS | Cálculo |
| --- | --- | --- | --- |
| 1 | 2 | 2 | 2 sesiones / 1 muestra |
| 2 | 0 | 1 | 2 sesiones / 2 muestras |
| 3 | 4 | 2 | 6 sesiones / 3 muestras |
| 4 | 0 | 1.5 | 6 sesiones / 4 muestras |
| 5 | 4 | 2 | 10 sesiones / 5 muestras |
En el ejemplo anterior, la carga de base de datos para el intervalo de tiempo de 1 a 5 es 2 AAS. Un aumento en la carga de base de datos significa que, en promedio, se están ejecutando más sesiones en la base de datos.
## Dimensiones
La métrica `DB Load` es distinta de las demás métricas de series temporales porque puede desglosarla en subcomponentes llamados dimensiones. Las dimensiones son una especie de categorías de las diferentes características de la métrica `DB Load`. Cuando se diagnostican problemas de rendimiento, las dimensiones más útiles son los **eventos de espera** y **top SQL**.
**estados de espera**
Un *evento de espera* hace que una instrucción de consulta espere a que ocurra un evento específico antes de que pueda continuar ejecutándose. Por ejemplo, una instrucción de consulta podría esperar hasta que se desbloqueara un recurso bloqueado. Al combinar `DB Load` con eventos de espera, puede obtener una imagen completa del estado de la sesión. Estos son varios estados de espera de Amazon DocumentDB:
| Estado de espera de Amazon DocumentDB | Descripción del estado de espera |
| --- | --- |
| Pestillo | El estado de espera de pestillo se produce cuando la sesión está esperando para paginar el conjunto de búferes. La entrada y salida frecuentes del conjunto de búferes puede producirse con mayor frecuencia cuando el sistema procesa consultas frecuentes de gran tamaño, escanea colecciones o cuando el grupo de búferes es demasiado pequeño para gestionar todo el conjunto de trabajo. |
| CPU | El estado de espera de la CPU se produce cuando la sesión está esperando en la CPU. |
| CollectionLock | El estado de CollectionLock espera se produce cuando la sesión está esperando a que se bloquee la colección. Estos eventos se producen cuando hay operaciones de DDL en la colección. |
| DocumentLock | El estado de DocumentLock espera se produce cuando la sesión está esperando a que se bloquee un documento. Un número elevado de escrituras simultáneas en el mismo documento contribuirá a que haya más estados de DocumentLock espera en ese documento. |
| SystemLock | El estado de SystemLock espera se produce cuando la sesión está en espera en el sistema. Esto puede ocurrir cuando hay consultas frecuentes de larga duración, transacciones de larga duración o mucha simultaneidad en el sistema. |
| E/S | El estado de espera de la E/S se produce cuando la sesión está esperando en la E/S. |
| BufferLock | El estado de BufferLock espera se produce cuando la sesión está esperando a que se bloquee una página compartida del búfer. BufferLockLos estados de espera pueden prolongarse si otros procesos mantienen los cursores abiertos en las páginas solicitadas. |
| LowMemThrottle | El estado de LowMemThrottle espera se produce cuando la sesión está en espera debido a una gran presión de memoria en la instancia de Amazon DocumentDB. Si este estado persiste durante mucho tiempo, considere la posibilidad de escalar verticalmente la instancia para proporcionar memoria adicional. Para obtener más información, consulte [Recurso de origen](https://docs.aws.amazon.com/documentdb/latest/developerguide/how-it-works.html). |
| BackgroundActivity | El estado de BackgroundActivity espera se produce cuando la sesión está en espera de un proceso interno del sistema. |
| Otro | El otro estado de espera es un estado de espera interno. Si este estado persiste durante mucho tiempo, considere la posibilidad de finalizar esta consulta. Para obtener más información, consulte [¿Cómo puedo encontrar y terminar las consultas que tardan mucho en ejecutarse o se bloquean?](https://docs.aws.amazon.com/documentdb/latest/developerguide/user_diagnostics.html#user_diagnostics-query_terminating.html) |
**Consultas principales**
Mientras que los eventos de espera muestran los cuellos de botella, las consultas principales indican qué consultas están contribuyendo más a la carga de la base de datos. Por ejemplo, es posible que, aunque haya muchas consultas ejecutándose actualmente en la base de datos, una de ellas consuma el 99 % de la carga de la base de datos. En este caso, es posible que la carga alta indique un problema con la consulta.
## Max vCPU
En el panel, el gráfico de **Carga de base de datos** recopila, agrega y muestra información de la sesión. Para ver si las sesiones activas superan el máximo de la CPU, observe su relación con la línea **Máximo de la CPU virtual**. El valor **Máximo de la vCPU** se determina por el número de núcleos de vCPU (CPU virtual) de la instancia de Amazon DocumentDB.
Si la carga de base de datos suele estar por encima de la línea **Máximo de la CPU virtual** y el estado de espera principal es CPU, la CPU del sistema está sobrecargada. En este caso, quizá sea conveniente limitar las conexiones con la instancia, ajustar las consultas con una carga de CPU alta o pensar en la posibilidad de usar una clase de instancia de mayor tamaño. Si hay instancias altas y uniformes en cualquier estado de espera, eso indica que es posible que haya problemas de contención de recursos o cuellos de botella que hay que resolver. Esto puede ser así aunque la carga de base de datos no cruce la línea de **Máximo de la CPU virtual**.
# Activación y desactivación de Información sobre rendimiento
Para poder usar Información sobre rendimiento, debe activarlo en su instancia de base de datos. Si lo necesita, podrá desactivarlo más adelante. La activación y desactivación de Información sobre rendimiento no provoca tiempos de inactividad, un reinicio o una conmutación por error.
El agente Información sobre rendimiento consume CPU y memoria limitadas en el host de base de datos. Cuando la carga de la base de datos es alta, el agente limita el impacto en el rendimiento mediante la recopilación de datos con menos frecuencia.
## Activación de Información sobre rendimiento al crear un clúster
En la consola, puede activar o desactivar Información sobre rendimiento al crear o modificar una nueva instancia de base de datos.
### Utilización del Consola de administración de AWS
En la consola, puede activar o desactivar Información sobre rendimiento al crear un clúster de Amazon DocumentDB. Cuando cree un nuevo clúster de Amazon DocumentDB, active Información sobre rendimiento con la opción **Habilitar Información sobre rendimiento** de la sección **Información sobre rendimiento**.
**Instrucciones de la consola**
1. Para crear un clúster, siga las instrucciones para [Creación de un clúster de base de datos de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-create.html).
1. En la sección Información sobre rendimiento, elija **Activar Información sobre rendimiento**.
![\[En la sección Información sobre rendimiento, elija Habilitar Información sobre rendimiento.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/select-performance-insights.png)
**nota**
El período de retención de datos de Información sobre rendimiento será de siete días.
** AWS KMS clave**: especifique su clave AWS KMS. Performance Insights cifra todos los datos potencialmente confidenciales con su AWS KMS clave. Las datos se cifran en reposo y en tránsito. Para obtener más información, consulte Configuración de una AWS AWS KMS política para Performance Insights.
## Activación y desactivación al modificar una instancia
Puede modificar una instancia de base de datos para habilitar Información sobre rendimiento mediante la consola o la AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
**Instrucciones de la consola**
1. [Inicie sesión en y abra la Consola de administración de AWS consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Seleccione **Clusters (Clústeres)**.
1. Seleccione una instancia de base de datos y elija **Modificar**.
1. En la sección Información sobre rendimiento, elija **Activar Información sobre rendimiento** o **Desactivar Información sobre rendimiento**.
**nota**
Si elige **Activar Performance Insights**, puede especificar su AWS AWS KMS clave. Performance Insights cifra todos los datos potencialmente confidenciales con su AWS KMS clave. Las datos se cifran en reposo y en tránsito. Para obtener más información, consulte [Cifrado de datos de Amazon DocumentDB en reposo](https://docs.aws.amazon.com/documentdb/latest/developerguide/encryption-at-rest.html).
1. Elija **Continuar**.
1. En **Programación de modificaciones**, elija **Aplicar inmediatamente**. Si elige **Aplicar durante la próxima ventana de mantenimiento programada**, la instancia ignora esta configuración y habilita de inmediato Información sobre rendimiento.
1. Elija **Modificar instancia**.
------
#### [ Using the AWS CLI ]
Al usar los `modify-db-instance` AWS AWS CLI comandos `create-db-instance` o, puede habilitar Performance Insights especificando `--enable-performance-insights` o deshabilitarlo especificando`--no-enable-performance-insights`.
En el siguiente procedimiento, se describe cómo se activa o desactiva Información sobre rendimiento en una instancia de base de datos a través de AWS AWS CLI.
**AWS AWS CLI instrucciones**
Llame al `modify-db-instance` AWS AWS CLI comando y proporcione los siguientes valores:
+ `--db-instance-identifer`: nombre de la instancia de la base de datos.
+ `--enable-performance-insights` para activarlo o `--no-enable-performance-insights` para desactivarlo.
**Example**
El siguiente ejemplo habilita Información sobre rendimiento para `sample-db-instance`:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-db-instance \
--enable-performance-insights
```
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-db-instance ^
--enable-performance-insights
```
------
# Configuración de directivas de acceso para información sobre rendimiento
Para acceder a Información sobre rendimiento, debe tener los permisos adecuados de AWS Identity and Access Management (IAM). Tiene las siguientes opciones para conceder acceso:
+ Asocie la política administrada `AmazonRDSPerformanceInsightsReadOnly` a un conjunto de permisos o a un rol.
+ Cree una política de IAM personalizada y asóciela a un conjunto de permisos o a un rol.
Además, si especificó una clave administrada por el cliente al activar Información sobre rendimiento, asegúrese de que los usuarios de su cuenta tengan los permisos `kms:Decrypt` y `kms:GenerateDataKey` sobre la clave de KMS.
**nota**
[Para la encryption-at-rest administración de AWS KMS claves y grupos de seguridad, Amazon DocumentDB aprovecha la tecnología operativa que se comparte con Amazon RDS.](https://aws.amazon.com/rds)
## Adjuntar la RDSPerformance InsightsReadOnly política de Amazon a un director de IAM
`AmazonRDSPerformanceInsightsReadOnly`es una política AWS gestionada que concede acceso a todas las operaciones de solo lectura de la API Performance Insights de Amazon DocumentDB. Actualmente, todas las operaciones de esta API son de solo lectura. Si asocia `AmazonRDSPerformanceInsightsReadOnly` a un conjunto de permisos o a un rol, el destinatario puede utilizar Información de rendimiento con las demás características de la consola.
## Creación de una política de IAM personalizada para la información sobre rendimiento
Para los usuarios que no tienen la política `AmazonRDSPerformanceInsightsReadOnly`, puede conceder acceso a Información sobre rendimiento creando o modificando una política de IAM administrada por el usuario. Al asociar la política a un conjunto de permisos o a un rol, el destinatario puede utilizar Información de rendimiento.
**Creación de una política personalizada**
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación, seleccione **Políticas**.
1. Elija **Create Policy (Crear política)**.
1. En la página **Create Policy (Crear política)**, elija la pestaña JSON.
1. Copie y pegue el siguiente texto y *us-east-1* sustitúyalo por el nombre de su AWS región y su número de cuenta de *111122223333* cliente.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "rds:DescribeDBInstances",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "rds:DescribeDBClusters",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": "pi:DescribeDimensionKeys",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetDimensionKeyDetails",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetadata",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:GetResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceDimensions",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
},
{
"Effect": "Allow",
"Action": "pi:ListAvailableResourceMetrics",
"Resource": "arn:aws:pi:us-east-1:111122223333:metrics/rds/*"
}
]
}
```
------
1. Elija **Review policy (Revisar política)**.
1. Proporcione un nombre para la política y, opcionalmente, una descripción, a continuación, elija **Create policy (Crear política)**.
Ahora ya puede asociar la política a un conjunto de permisos o a un rol. En el procedimiento siguiente, se presupone que ya tiene un usuario para este fin.
**Asociación de la política a un usuario**
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación, seleccione **Users**.
1. Elija en la lista un usuario existente.
**importante**
Para utilizar Información sobre rendimiento, asegúrese de tener acceso a Amazon DocumentDB además de la política personalizada. [Por ejemplo, la política **AmazonDocDBReadOnlyAccess**predefinida proporciona acceso de solo lectura a Amazon DocDB. Para obtener más información, consulte Administrar el acceso mediante políticas.](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAM.html#security_iam_access-manage)
1. En la página **Resumen**, elija **Añadir permisos**.
1. Elija **Attach existing policies directly (Adjuntar políticas existentes directamente)**. En **Search (Buscar)**, escriba los primeros caracteres del nombre de la política, como se muestra más abajo.
![\[Elección de una política\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/pi-add-permissions.png)
1. Elija la política y, a continuación, elija **Next: Review**.
1. Elija **Add permissions (Agregar permisos)**.
## Configuración de una AWS KMS política para Performance Insights
Performance Insights utiliza AWS KMS key y para cifrar datos confidenciales. Cuando habilita la información sobre rendimiento a través de la API o la consola, tiene las siguientes opciones:
+ Elija la opción predeterminada Clave administrada de AWS.
Amazon DocumentDB usa el Clave administrada de AWS para su nueva instancia de base de datos. Amazon DocumentDB crea una Clave administrada de AWS para su cuenta. AWS Su AWS cuenta tiene una cuenta de Amazon DocumentDB diferente Clave administrada de AWS para cada AWS región.
+ Elija una clave administrada por el cliente.
Si especifica una clave administrada por el cliente, los usuarios de su cuenta que llamen a la API de Performance Insights necesitarán los permisos `kms:Decrypt` y `kms:GenerateDataKey` sobre la clave de KMS. Puede configurar estos permisos a través de directivas de IAM. Sin embargo, le recomendamos que administre estos permisos a través de su política de claves de KMS. Para obtener más información, consulte [ Uso de políticas clave en AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html).
**Example**
La siguiente política de claves de ejemplo muestra cómo agregar instrucciones a la claves de KMS. Estas instrucciones permiten el acceso a la información sobre rendimiento. En función de cómo la utilice AWS KMS, es posible que desee cambiar algunas restricciones. Antes de agregar sentencias a la directiva, elimine todos los comentarios.
# Análisis de métricas mediante el panel de Información sobre rendimiento
El panel de Información sobre rendimiento contiene información de desempeño de la base de datos para ayudarle a analizar y solucionar los problemas de desempeño. En la página del panel principal, encontrará información sobre la carga de la base de datos (DB load). Puede “dividir” la carga de la base de datos por dimensiones, como eventos de espera o de consulta.
**Topics**
+ [Información general del panel de Información sobre rendimiento](performance-insights-dashboard-overview.md)
+ [Apertura del panel de Información sobre rendimiento](performance-insights-dashboard-opening.md)
+ [Análisis de carga de la base de datos mediante estados de espera](performance-insights-analyzing-db-load.md)
+ [Información general sobre la pestaña Top queries](performance-insights-top-queries.md)
+ [Ampliación del gráfico de carga de base de datos](performance-insights-zoom-db-load.md)
# Información general del panel de Información sobre rendimiento
El panel es la forma más sencilla de interactuar con Información sobre rendimiento. El siguiente ejemplo muestra el panel de una instancia de Amazon DocumentDB. De forma predeterminada, el panel de Información sobre rendimiento muestra los datos de la última hora.
![\[Panel de Información sobre rendimiento en el que se muestra el uso de la CPU y la carga de la base de datos a lo largo del tiempo para una instancia de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/overview-dashboard.png)
El panel está dividido en las partes siguientes:
1. **Métricas de contador**: muestra los datos para métricas de contador de rendimiento específicas.
1. **Gráfico de carga de base de datos**: muestra cómo se compara la carga de base de datos con la capacidad de instancia de base de datos representada por la línea de **vCPU máximas**.
1. **Principales dimensiones**: muestra las dimensiones principales que contribuyen a la carga de la base de datos. Estas dimensiones incluyen `waits`, `queries`, `hosts`, `databases` y `applications`.
**Topics**
+ [Gráfico Counter metrics (Métricas de contador)](#performance-insights-overview-metrics)
+ [Gráfico Database load (Carga de base de datos)](#performance-insights-overview-db-load-chart)
+ [Tabla de dimensiones principales](#performance-insights-overview-top-dimensions)
## Gráfico Counter metrics (Métricas de contador)
Con las métricas de contador, puede personalizar el panel de Información sobre rendimiento para que incluya hasta 10 gráficos adicionales. Estos gráficos muestran una selección de docenas de métricas de rendimiento de sistemas operativos y bases de datos. Esta información se puede correlacionar con la carga de base de datos para ayudar a identificar y analizar problemas de rendimiento.
El gráfico **Counter metrics (Métricas de contador)** muestra los datos para los contadores de rendimiento.
![\[Gráfico de métricas del contador en el que se muestra el uso de la CPU a lo largo del tiempo.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/counter-metrics.png)
Para cambiar los contadores de rendimiento, elija **Administrar métricas**. Puede seleccionar varias **métricas del sistema operativo** como se muestra en la siguiente captura de pantalla. Para ver los detalles de cualquier métrica, sitúe el cursor sobre el nombre de la métrica.
![\[Interfaz de selección de métricas del panel de control de Información sobre rendimiento con opciones de métricas del sistema operativo.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/overview-os-metrics.png)
## Gráfico Database load (Carga de base de datos)
El gráfico **Carga de base de datos** muestra cómo se compara la carga de base de datos con la capacidad de la instancia de base de datos representada por la línea **Max vCPU (Máximo de vCPU)**. De forma predeterminada, el gráfico de líneas apilado representa la carga de base de datos como promedio de sesiones activas por unidad de tiempo. La carga de base de datos está dividida (agrupada) por estados de espera.
![\[Gráfico de carga de la base de datos en el que se muestra el promedio de sesiones activas a lo largo del tiempo, con un pico de uso de la CPU casi al final.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/database-load.png)
**Carga de base de datos dividida por dimensiones**
Puede elegir ver la carga como sesiones activas agrupadas por cualquier dimensión admitida. En la imagen siguiente, se muestran las dimensiones de una instancia de Amazon DocumentDB.
![\[Gráfico en el que se muestra la carga de la base de datos con varias opciones de «segmentación» en una lista desplegable.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/database-load-sliced.png)
**Detalles de carga de base de datos de un elemento de dimensión**
Para consultar los detalles de un elemento de carga de base de datos dentro de una dimensión, pase el cursor sobre el nombre de elemento. En la imagen siguiente, se muestran los detalles de una instrucción de consulta.
![\[Gráfico de barras en el que se muestra la carga de la base de datos con detalles adicionales que se muestran al pasar el cursor sobre el nombre de un elemento.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/database-load-details.png)
Para consultar los detalles de cualquier elemento para el periodo de tiempo seleccionado en la leyenda, coloque el cursor sobre ese elemento.
![\[Gráfico de barras en el que se muestra la carga de la base de datos con detalles adicionales que se muestran al pasar el cursor sobre una barra.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/database-load-hover.png)
## Tabla de dimensiones principales
La **tabla de dimensiones principales** divide la carga de base de datos por diferentes dimensiones. Una dimensión es una categoría o “dividir por” para diferentes características de la carga de base de datos. Si la dimensión es consulta, **Consultas principales** muestra las instrucciones de consulta que más contribuyen a la carga de bases de datos.
Elija cualquiera de las siguientes pestañas de dimensión.
![\[La pestaña Dimensiones de las consultas principales, en la que se muestran las dos consultas principales.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/top-dimensions.png)
En la siguiente tabla, se proporciona una breve descripción de cada pestaña.
| Tab | Description (Descripción) |
| --- | --- |
| Esperas principales | El evento por el que la base de datos de backend está esperando. |
| Consultas principales | Las instrucciones de consulta que se están ejecutando |
| Hosts principales | El IP del host y el puerto del cliente conectado |
| Bases de datos principales | El nombre de la base de datos a la que está conectado el cliente. |
| Aplicaciones principales | El nombre de la aplicación que está conectada a la base de datos. |
Para obtener más información sobre cómo analizar las consultas mediante la pestaña **Consulta principal**, consulte [Información general sobre la pestaña Top queries](performance-insights-top-queries.md).
# Apertura del panel de Información sobre rendimiento
**Para ver el panel de Performance Insights en la consola de AWS administración, siga estos pasos:**
1. Abra la consola Performance Insights en [https://console.aws.amazon.com/docdb/](https://console.aws.amazon.com/docdb/home#performance-insights).
1. Elija una instancia de base de datos. Se muestra el panel de Información sobre rendimiento para esa instancia de Amazon DocumentDB.
En instancias de Amazon DocumentDB con Información sobre rendimiento habilitado, también puede acceder al panel eligiendo el elemento **Sesiones** en la lista de instancias de base de datos. En **Actividad actual**, el elemento **Sesiones** muestra la carga de la base de datos en el como promedio de sesiones activas en los últimos cinco minutos. La barra muestra gráficamente la carga. Cuando la barra está vacía, la instancia está inactiva. Conforme aumenta la carga, la barra se va completando en azul. Cuando la carga supera el número de virtuales CPUs (vCPUs) de la clase de instancia, la barra se pone roja, lo que indica un posible cuello de botella.
![\[La página Clústeres, en la que se muestra un clúster regional de Amazon DocumentDB y la CPU y la actividad actual de cada instancia de clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/opening-clusters.png)
1. (Opcional) Elija un intervalo de tiempo diferente seleccionando un botón en la parte superior derecha. Por ejemplo, para cambiar el intervalo a 1 horas, seleccione **1h**.
![\[Los botones de intervalo de tiempo oscilan entre cinco minutos y una semana.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/opening-time.png)
En la siguiente captura de pantalla, el intervalo de carga de la base de datos es de 1 horas.
![\[Gráfico de barras en el que se muestra la carga de la base de datos medida en el promedio de sesiones activas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/opening-db-load.png)
1. Para actualizar los datos automáticamente, habilite **Actualización automática**.
![\[El botón de actualización automática está activado y aparece junto a los botones de intervalo de tiempo.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/opening-auto-refresh.png)
El panel de información sobre rendimiento se actualiza automáticamente con nuevos datos. La frecuencia de actualización depende de la cantidad de datos mostrados:
+ 5 minutos actualiza cada 5 segundos.
+ 1 hora actualiza cada minuto.
+ 5 horas actualiza cada minuto.
+ 24 horas actualiza cada 5 minutos.
+ 1 semana actualiza cada hora.
# Análisis de carga de la base de datos mediante estados de espera
Si el gráfico **Carga de base de datos** indica que hay un cuello de botella, puede averiguar de dónde procede la carga. Para ello, fíjese en la tabla de elementos de carga principales situada debajo del gráfico **Carga de base de datos**. Elija un elemento en particular, como una consulta o un usuario, para ampliar la información de ese elemento y ver los detalles.
La carga de base de datos agrupada por esperas y principales consultas normalmente ofrece la máxima información sobre problemas de rendimiento. La carga de la base de datos agrupada por esperas indica si hay algún cuello de botella de simultaneidad o recursos en la base de datos. En este caso, la pestaña **Consultas principales** de la tabla de elementos de carga principales indica qué consultas están contribuyendo a esa carga.
Este es el flujo de trabajo típico para diagnosticar los problemas de desempeño:
1. Revise el gráfico **Carga de base de datos** para ver si hay algún incidente de carga de base de datos que sobrepase la línea **Máximo de CPU**.
1. De ser así, fíjese en el gráfico **Carga de base de datos** e identifique qué estado o estados de espera son los principales responsables.
1. Para identificar las consultas de resumen que están provocando la carga, consulte qué consultas de la pestaña **Top queries** de la tabla de elementos de carga principales están contribuyendo más a esos estados de espera. Para identificarlas, utilice la columna **Carga de base de datos por espera**.
1. Elija una de estas consultas de resumen en la pestaña **Top queries** para ampliarla y ver las consultas secundarias que contiene.
También puede ver qué hosts o aplicaciones generan más carga seleccionando los **Alojamientos principales** o **Aplicaciones principales**, respectivamente. Los nombres de las aplicaciones se especifican en la cadena de conexión a la instancia de Amazon DocumentDB. `Unknown` indica que no se especificó el campo de la aplicación.
Por ejemplo, en el panel que se muestra a continuación, la espera de la **sincronización de archivos de registro** se corresponde con la mayor parte de la carga de base de datos. Al seleccionar la consulta principal en **Consultas principales**, se analizará el diagrama de carga de la base de datos para centrarse en la mayor carga que aporta la consulta seleccionada.
![\[Gráfico de carga de base de datos en el que se muestra el pico de uso de la CPU. La pestaña Consultas principales correspondiente muestra las consultas que más contribuyen a los estados de espera.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/db-load-1.png)
![\[Gráfico de carga de la base de datos en el que se muestra el pico de uso de la CPU para la consulta que es el que más contribuye a los estados de espera. La pestaña Consultas principales correspondiente muestra las consultas secundarias de esa consulta.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/db-load-2.png)
# Información general sobre la pestaña Top queries
De forma predeterminada, la pestaña **Consultas principales** muestra las consultas que más contribuyen a la carga de base de datos. Puede analizar el texto de la consulta para ajustarlas.
**Topics**
+ [Resúmenes de consultas](#performance-insights-top-queries-digests)
+ [Carga por esperas (AAS)](#performance-insights-top-queries-aas)
+ [Visualización de información detallada de la consulta](#performance-insights-top-queries-query-info)
+ [Acceso al texto de consulta de la declaración](#performance-insights-top-queries-accessing-text)
+ [Visualización y descarga del texto de consulta de la declaración](#performance-insights-top-queries-viewing-downloading)
## Resúmenes de consultas
Un *resumen de consultas* es un compuesto de múltiples consultas reales que son similares en estructura, pero que pueden tener diferentes valores literales. El resumen reemplaza los valores codificados por un signo de interrogación. Por ejemplo, un resumen de una consulta podría verse de la siguiente manera:
```
{"find":"customerscollection","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}
```
Este resumen podría incluir las siguientes consultas secundarias:
```
{"find":"customerscollection","filter":{"FirstName":"Karrie"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Met"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
{"find":"customerscollection","filter":{"FirstName":"Rashin"},"sort":{"key":{"$numberInt":"1"}},"limit":{"$numberInt":"3"}}
```
Para ver las instrucciones de consulta literales de un resumen, seleccione la consulta y, a continuación, elija el símbolo más (`+`). En la siguiente captura de pantalla, la consulta seleccionada es un resumen.
![\[La tabla Consultas principales, en la que se muestra un resumen de consultas ampliado con una consulta secundaria seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/top-queries-literal.png)
**nota**
Un resumen de consultas agrupa sentencias de consulta similares, pero no redacta información confidencial.
## Carga por esperas (AAS)
En **Consultas principales**, la columna **Carga por espera (AAS)** ilustra el porcentaje de carga de la base de datos asociada con cada elemento de carga principal. Esta columna refleja la carga de ese elemento por cualquier agrupación que se haya seleccionado actualmente en el **gráfico de carga de base de datos**. Por ejemplo, es posible que pueda agrupar el gráfico **DB load** (Carga de base de datos) por estados de espera. En este caso, la barra **DB Load by Waits (Carga de base de datos por esperas)** estaría dimensionada, segmentada y dividida por colores para mostrar en qué proporción contribuye esa consulta a un estado de espera. También muestra qué estados de espera afectan a la consulta seleccionada.
![\[Gráfico de barras en el que se muestra la carga de la base de datos agrupada por estados de espera de CPU, E/S y bloqueo. La tabla correspondiente muestra las consultas principales en función de la carga por espera.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/top-queries-aas.png)
## Visualización de información detallada de la consulta
En la tabla **Consulta principal**, puede abrir un *resumen de situación* para consultar su información. La información aparece en el panel inferior.
![\[La tabla Consultas principales, en la que se muestra una declaración de consulta seleccionada y la información de la consulta a continuación.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/top-queries-detailed.png)
Los siguientes tipos de identificadores (IDs) están asociados a las sentencias de consulta:
1. **ID de consulta de soporte**: un valor hash del ID de consulta. Este valor solo sirve para hacer referencia a un ID de consulta cuando se trabaja con AWS Support. AWS Support no tiene acceso a la consulta ni al texto IDs de la consulta reales.
1. **Compatibilidad con ID de resumen**: un valor hash del ID de resumen. Este valor solo sirve para hacer referencia a un ID de resumen cuando se trabaja con AWS Support. AWS Support no tiene acceso a tu resumen ni al texto IDs de consulta reales.
## Acceso al texto de consulta de la declaración
De forma predeterminada, cada fila de la tabla **Consultas principales** muestra 500 bytes de texto para cada instrucción. Cuando una instrucción de consulta supera los 500 bytes, puede ver más texto abriendo la instrucción en el panel de Información sobre rendimiento. En este caso, la longitud máxima de la consulta que se muestra es de 1 KB. Si ve una instrucción SQL secundaria, también puede elegir **Descargar**.
## Visualización y descarga del texto de consulta de la declaración
Puede ver o descargar texto de consulta en el panel de Información sobre rendimiento.
**Visualización de más texto de consulta en el panel de Información sobre rendimiento**
1. 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 **Información sobre rendimiento**.
1. Elija una instancia de base de datos. Se abre el panel de Información sobre rendimiento para esa instancia de base de datos.
Las instrucciones de consulta con texto superior a 500 bytes son similares a las que se indican en la siguiente imagen.
![\[La tabla Consultas principales con una consulta secundaria seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/top-queries-statement.png)
1. Examine la sección de información de consulta para consultar más texto de consulta.
![\[La sección Información de consulta, en la que se muestra el texto completo de la consulta seleccionada.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/top-queries-query-text.png)
El panel de Información sobre rendimiento puede mostrar hasta 1 KB por cada instrucción de consulta completa.
**nota**
Para copiar o descargar la instrucción de consulta, deshabilite los bloqueadores de pantallas emergentes.
# Ampliación del gráfico de carga de base de datos
Hay otras características de la interfaz de usuario de Información sobre rendimiento que ayudan a analizar los datos de desempeño.
**Click-and-Drag Ampliar**
En la interfaz de Performance Insights, se puede seleccionar una pequeña parte del gráfico de carga y ampliarlo para ver los detalles.
![\[Gráfico de barras en el que se muestra la carga de la base de datos, con una parte resaltada para ampliarla.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/pi-zoom-1.png)
Para ampliar una parte del gráfico de carga, elija la hora de inicio y arrastre el ratón hasta el final del período que desee. Al hacer esto, el área seleccionada queda resaltada. Cuando suelte el ratón, el gráfico de carga amplía el área seleccionada y se vuelve a calcular la tabla de **Elementos *principales***.
![\[Gráfico de barras de carga de la base de datos en el que se muestra la parte ampliada, con la tabla Esperas principales correspondiente a continuación.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/pi-zoom-2.png)
# Recuperación de métricas con la API de Información sobre rendimiento
Cuando se habilita Información sobre rendimiento, la API proporciona visibilidad sobre el rendimiento de la instancia. Amazon CloudWatch Logs proporciona la fuente autorizada de las métricas de monitoreo de los servicios de Vended. AWS
Con Performance Insights se ofrece una vista propia del dominio de la carga de la base de datos entendida como el promedio de sesiones activas (AAS). Esta métrica aparece para los consumidores de API como conjunto de datos de serie temporal bidimensional. La dimensión temporal de los datos ofrece datos de carga de base de datos para cada punto temporal del intervalo de tiempo consultado. Cada punto temporal descompone la carga global en relación con las dimensiones solicitadas, tales como `Query`, `Wait-state`, `Application` o `Host`, medidas en ese punto temporal.
Información sobre rendimiento de Amazon DocumentDB monitoriza la instancia de base de datos de Amazon DocumentDB para poder analizar y solucionar los problemas de desempeño de la base de datos. Una forma de ver los datos de Información sobre rendimiento es a través de la Consola de administración de AWS. Performance Insights además ofrece una API pública, para poder consultar en sus propios datos. Puede utilizar la API para hacer lo siguiente:
+ Descarga de datos en una base de datos
+ Agregación de datos de Performance Insights a los paneles de monitoreo existentes
+ Creación de herramientas de monitoreo
Para utilizar la API de Información sobre rendimiento, habilite Información sobre rendimiento en una de sus instancias de base de datos de Amazon DocumentDB. Para obtener información sobre la habilitación de Información sobre rendimiento, consulte [Activación y desactivación de Información sobre rendimiento](performance-insights-enabling.md). Para obtener información sobre la API de Información sobre rendimiento, consulte la [Referencia de la API de Información sobre rendimiento](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).
La API de Información sobre rendimiento proporciona las siguientes operaciones.
****
| Acción de Performance Insights | AWS CLI comando | Description (Descripción) |
| --- | --- | --- |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html](https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html) | Recupera las principales claves de dimensión N de una métrica para un periodo de tiempo específico. |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html) | Recupera los atributos del grupo de dimensiones especificado para una instancia de base de datos o un origen de datos. Por ejemplo, si especifica un ID de consulta y si los detalles de la dimensión están disponibles, `GetDimensionKeyDetails` recupera el texto completo de la dimensión `db.query.statement` asociada a este ID. Esta operación resulta útil porque `GetResourceMetrics` y `DescribeDimensionKeys` no admiten la recuperación de texto de instrucción de consulta grande. |
| [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html) | Recupere los metadatos de las distintas características. Por ejemplo, los metadatos podrían indicar que una característica está activada o desactivada en una instancia de base de datos específica. |
| [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html) | Recupera las métricas de Información sobre rendimiento de un conjunto de orígenes de datos, durante un periodo de tiempo. Puede proporcionar grupos de dimensiones y dimensiones específicas, y proporcionar criterios de agregación y filtrado para cada grupo. |
| [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html) | Recupere las dimensiones que se pueden consultar para cada tipo de métrica especificado en una instancia especificada. |
| [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html) | [https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html) | Recupere todas las métricas disponibles de los tipos de métricas especificados que se pueden consultar de una instancia de base de datos especificada. |
**Topics**
+ [AWS CLI para Performance Insights](#performance-insights-metrics-CLI)
+ [Recuperación de métricas de series temporales](#performance-insights-metrics-time-series)
+ [AWS CLI ejemplos de Performance Insights](#performance-insights-metrics-api-examples)
## AWS CLI para Performance Insights
Puede ver los datos de Performance Insights a través de la AWS CLI. Puede obtener ayuda sobre los comandos de la AWS CLI de Performance Insights escribiendo lo siguiente en la línea de comandos.
```
aws pi help
```
Si no la tiene AWS CLI instalada, consulte [Instalación de la interfaz de línea de AWS comandos](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) en la *Guía del AWS CLI usuario* para obtener información sobre cómo instalarla.
## Recuperación de métricas de series temporales
La operación `GetResourceMetrics` recupera una o más métricas de series temporales a partir de los datos de Performance Insights. `GetResourceMetrics` requiere una métrica y un periodo de tiempo y devuelve una respuesta con una lista de puntos de datos.
Por ejemplo, se Consola de administración de AWS utiliza `GetResourceMetrics` para rellenar el gráfico de **métricas del contador** y el gráfico de **carga de la base** de datos, como se ve en la siguiente imagen.
![\[Gráficos Counter Metrics y Database Load\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-charts.png)
Todas las métricas que devuelve `GetResourceMetrics` son métricas de series temporales estándar con la excepción de `db.load`. Esta métrica se muestra en el gráfico **Database Load (Carga de base de datos)**. La métrica `db.load` es distinta de las demás métricas de series temporales porque puede desglosarla en subcomponentes llamados *dimensiones*. En la imagen anterior, `db.load` está desglosado y agrupado por los estados de espera que forman el `db.load`.
**nota**
`GetResourceMetrics` también puede devolver la métrica `db.sampleload`, pero la métrica `db.load` es apropiada en la mayoría de los casos.
Para obtener información sobre las métricas de contador devueltas por `GetResourceMetrics`, consulte [Métricas de contador para Información sobre rendimiento](performance-insights-counter-metrics.md).
Para las métricas se admiten los siguientes cálculos:
+ Media: el valor medio de la métrica durante un período de tiempo. Añada `.avg` al nombre de la métrica.
+ Mínimo: el valor mínimo de la métrica durante un período de tiempo. Añada `.min` al nombre de la métrica.
+ Máximo: el valor máximo de la métrica durante un período de tiempo. Añada `.max` al nombre de la métrica.
+ Suma: la suma de los valores de la métrica durante un periodo de tiempo. Añada `.sum` al nombre de la métrica.
+ Número de muestras: El número de veces que se recopiló la métrica durante un período de tiempo. Añada `.sample_count` al nombre de la métrica.
Supongamos, por ejemplo, que una métrica se recopila durante 300 segundos (5 minutos) y que la métrica se recopila una vez cada minuto. Los valores para cada minuto son 1, 2, 3, 4 y 5. En este caso, se devuelven los siguientes cálculos:
+ Media: 3
+ Mínimo: 1
+ Máximo: 5
+ Suma: 15
+ Número de muestras: 5
Para obtener información sobre el uso del `get-resource-metrics` AWS CLI comando, consulte [https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html).
Para la opción `--metric-queries`, especifique una o más consultas para las que desea obtener resultados. Cada consulta consta de un parámetro `Metric` obligatorio y de parámetros opcionales `GroupBy` y `Filter`. A continuación, se muestra un ejemplo de una especificación de opción `--metric-queries`.
```
{
"Metric": "string",
"GroupBy": {
"Group": "string",
"Dimensions": ["string", ...],
"Limit": integer
},
"Filter": {"string": "string"
...}
```
## AWS CLI ejemplos de Performance Insights
Los siguientes ejemplos muestran cómo utilizarla AWS CLI para Performance Insights.
**Topics**
+ [Recuperación de métricas de contador](#performance-insights-metrics-api-examples.CounterMetrics)
+ [Recuperación del promedio de carga de base de datos para los eventos de espera principales](#performance-insights-metrics-api-examples.DBLoadAverage)
+ [Recuperación del promedio de carga de base de datos para las instrucciones de consulta principales](#performance-insights-metrics-api-examples.topquery)
+ [Recuperación del promedio de carga de base de datos filtrado por consulta](#performance-insights-metrics-api-examples.DBLoadAverageByQuery)
### Recuperación de métricas de contador
La siguiente captura de pantalla muestra dos gráficos de métricas de contador en la Consola de administración de AWS.
![\[Gráficos Counter Metrics (Métricas de contador).\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/performance-insights/perf-insights-api-counters-charts.png)
El siguiente ejemplo muestra cómo recopilar los mismos datos que utiliza la Consola de administración de AWS para generar los dos gráficos de métricas de contador.
Para Linux, macOS o Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries '[{"Metric": "os.cpuUtilization.user.avg" },
{"Metric": "os.cpuUtilization.idle.avg"}]'
```
Para Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries '[{"Metric": "os.cpuUtilization.user.avg" },
{"Metric": "os.cpuUtilization.idle.avg"}]'
```
También puede hacer que un comando sea más fácil de leer especificando un archivo para la opción `--metrics-query`. El siguiente ejemplo utiliza un archivo llamado query.json para la opción. El archivo tiene el siguiente contenido.
```
[
{
"Metric": "os.cpuUtilization.user.avg"
},
{
"Metric": "os.cpuUtilization.idle.avg"
}
]
```
Ejecute el siguiente comando para utilizar el archivo.
Para Linux, macOS o Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Para Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
El ejemplo anterior especifica los siguientes valores para las opciones:
+ `--service-type`: `DOCDB` para Amazon DocumentDB
+ `--identifier`: el ID de recurso para la instancia de base de datos
+ `--start-time` y:`--end-time` los valores ISO 8601 `DateTime` para el periodo de consulta, con varios formatos admitidos
Consulta durante un intervalo de una hora:
+ `--period-in-seconds`: `60` para una consulta por minuto
+ `--metric-queries`: una matriz de dos consultas, cada una para una métrica.
El nombre de la métrica utiliza puntos para clasificar la métrica en categorías útiles y el elemento final es una función. En el ejemplo, la función es `avg` para cada consulta. Al igual que en Amazon CloudWatch, las funciones compatibles son `min``max`,`total`, y`avg`.
La respuesta tiene un aspecto similar a la siguiente.
```
{
"AlignedStartTime": "2022-03-13T08:00:00+00:00",
"AlignedEndTime": "2022-03-13T09:00:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{
"Key": {
"Metric": "os.cpuUtilization.user.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00", //Minute1
"Value": 3.6
},
{
"Timestamp": "2022-03-13T08:02:00+00:00", //Minute2
"Value": 2.6
},
//.... 60 datapoints for the os.cpuUtilization.user.avg metric
{
"Key": {
"Metric": "os.cpuUtilization.idle.avg"
},
"DataPoints": [
{
"Timestamp": "2022-03-13T08:01:00+00:00",
"Value": 92.7
},
{
"Timestamp": "2022-03-13T08:02:00+00:00",
"Value": 93.7
},
//.... 60 datapoints for the os.cpuUtilization.user.avg metric
]
}
] //end of MetricList
} //end of response
```
La respuesta tiene `Identifier`, `AlignedStartTime` y `AlignedEndTime`. Como el valor `--period-in-seconds` era `60`, los tiempos de inicio y final se han alineado con el minuto. Si el `--period-in-seconds` fuera `3600`, los tiempos de inicio y final se habrían alineado con la hora.
La `MetricList` en la respuesta tiene una serie de entradas, cada una con una entrada `Key` y una entrada `DataPoints`. Cada `DataPoint` tiene un `Timestamp` y un `Value`. Cada lista de `Datapoints` tiene 60 puntos de datos porque las consultas son datos por minuto sobre una hora, con `Timestamp1/Minute1`, `Timestamp2/Minute2` y así sucesivamente, hasta `Timestamp60/Minute60`.
Como la consulta es para dos métricas de contador distintas, hay dos elementos en la respuesta `MetricList`.
### Recuperación del promedio de carga de base de datos para los eventos de espera principales
El siguiente ejemplo es la misma consulta que se Consola de administración de AWS utiliza para generar un gráfico de líneas de área apilada. Este ejemplo recupera el `db.load.avg` durante la última hora con la carga dividida según los siete eventos de espera principales. El comando es el mismo que el comando en [Recuperación de métricas de contador](#performance-insights-metrics-api-examples.CounterMetrics). Sin embargo, el archivo query.json tiene los elementos indicados a continuación.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 7 }
}
]
```
Ejecute el comando siguiente.
Para Linux, macOS o Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 60 \
--metric-queries file://query.json
```
Para Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 60 ^
--metric-queries file://query.json
```
El ejemplo especifica la métrica de `db.load.avg` y un `GroupBy` de los siete eventos de espera principales. Para obtener más información sobre los valores válidos para este ejemplo, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)la *Referencia de la API Performance Insights.*
La respuesta tiene un aspecto similar a la siguiente.
```
{
"AlignedStartTime": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{//A list of key/datapoints
"Key": {
//A Metric with no dimensions. This is the total db.load.avg
"Metric": "db.load.avg"
},
"DataPoints": [
//Each list of datapoints has the same timestamps and same number of items
{
"Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 60 datapoints for the total db.load.avg key
]
},
{
"Key": {
//Another key. This is db.load.avg broken down by CPU
"Metric": "db.load.avg",
"Dimensions": {
"db.wait_state.name": "CPU"
}
},
"DataPoints": [
{
"Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
"Value": 0.0
},
{
"Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
"Value": 0.0
},
//... 60 datapoints for the CPU key
]
},//... In total we have 3 key/datapoints entries, 1) total, 2-3) Top Wait States
] //end of MetricList
} //end of response
```
En esta respuesta, hay tres entradas en la `MetricList`. Hay una entrada para el `db.load.avg` total y tres entradas para el `db.load.avg` divididas según uno de los siete eventos de espera principales. A diferencia del primer ejemplo, como había una dimensión de agrupación, debe haber una clave para cada agrupación de la métrica. No puede haber solo una clave para cada métrica, como en el caso de uso de métrica de contador básica.
### Recuperación del promedio de carga de base de datos para las instrucciones de consulta principales
El siguiente ejemplo agrupa `db.wait_state` por las 10 instrucciones de consulta principales. Hay dos grupos distintos para instrucciones de consulta:
+ `db.query`: la instrucción de consulta completa, como `{"find":"customers","filter":{"FirstName":"Jesse"},"sort":{"key":{"$numberInt":"1"}}}`
+ `db.query_tokenized`: la instrucción de consulta tokenizada, como `{"find":"customers","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}`
Al analizar el desempeño de la base de datos, puede resultar útil tener en cuenta instrucciones de consulta que solo se diferencien en sus parámetros como un elemento de lógica. Así pues, puede utilizar `db.query_tokenized` al consultar. Sin embargo, sobre todo cuando está interesado en `explain()`, a veces es más útil examinar instrucciones de consulta completas con parámetros. Existe una relación principal-secundaria entre instrucciones de consulta tokenizadas y completas, con varias instrucciones de consulta completas (secundarias) agrupadas bajo la misma instrucción de consulta tokenizada (principal).
El comando en este ejemplo es similar al comando en [Recuperación del promedio de carga de base de datos para los eventos de espera principales](#performance-insights-metrics-api-examples.DBLoadAverage). Sin embargo, el archivo query.json tiene los elementos indicados a continuación.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.query_tokenized", "Limit": 10 }
}
]
```
El siguiente ejemplo utiliza `db.query_tokenized`.
Para Linux, macOS o Unix:
```
aws pi get-resource-metrics \
--service-type DOCDB \
--identifier db-ID \
--start-time 2022-03-13T8:00:00Z \
--end-time 2022-03-13T9:00:00Z \
--period-in-seconds 3600 \
--metric-queries file://query.json
```
Para Windows:
```
aws pi get-resource-metrics ^
--service-type DOCDB ^
--identifier db-ID ^
--start-time 2022-03-13T8:00:00Z ^
--end-time 2022-03-13T9:00:00Z ^
--period-in-seconds 3600 ^
--metric-queries file://query.json
```
En este ejemplo, las consultas duran más de 1 hora y 1 minuto period-in-seconds.
El ejemplo especifica la métrica de `db.load.avg` y un `GroupBy` de los siete eventos de espera principales. Para obtener más información sobre los valores válidos para este ejemplo, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html)la *Referencia de la API Performance Insights.*
La respuesta tiene un aspecto similar a la siguiente.
```
{
"AlignedStartTime": "2022-04-04T06:00:00+00:00",
"AlignedEndTime": "2022-04-04T06:15:00+00:00",
"Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
"MetricList": [
{//A list of key/datapoints
"Key": {
"Metric": "db.load.avg"
},
"DataPoints": [
//... 60 datapoints for the total db.load.avg key
]
},
{
"Key": {//Next key are the top tokenized queries
"Metric": "db.load.avg",
"Dimensions": {
"db.query_tokenized.db_id": "pi-1064184600",
"db.query_tokenized.id": "77DE8364594EXAMPLE",
"db.query_tokenized.statement": "{\"find\":\"customers\",\"filter\":{\"FirstName\":\"?\"},\"sort\":{\"key\":{\"$numberInt\":\"?\"}},\"limit\"
:{\"$numberInt\":\"?\"},\"$db\":\"myDB\",\"$readPreference\":{\"mode\":\"primary\"}}"
}
},
"DataPoints": [
//... 60 datapoints
]
},
// In total 11 entries, 10 Keys of top tokenized queries, 1 total key
] //End of MetricList
} //End of response
```
Esta respuesta tiene 11 entradas en la `MetricList` (1 total, 10 consultas tokenizadas principales) y cada entrada tiene 24 `DataPoints` por hora.
Para consultas tokenizadas, hay tres entradas en cada lista de dimensiones:
+ `db.query_tokenized.statement`: la instrucción de consulta tokenizada.
+ `db.query_tokenized.db_id `: el ID sintético que Información sobre rendimiento genera para usted. Este ejemplo devuelve el ID sintético de `pi-1064184600`.
+ `db.query_tokenized.id`: el ID de la consulta dentro del panel Performance Insights.
En el Consola de administración de AWS, este ID se denomina Support ID. Se denomina así porque el identificador son datos que AWS Support puede examinar para ayudarle a solucionar un problema con la base de datos. AWS se toma muy en serio la seguridad y la privacidad de sus datos, y casi todos los datos se almacenan cifrados junto con el suyo AWS KMS key. Por lo tanto, nadie en su interior AWS puede ver estos datos. En el ejemplo anterior, tanto `tokenized.statement` como `tokenized.db_id` se almacenan cifrados. Si tiene algún problema con su base de datos, AWS Support puede ayudarlo consultando el ID de soporte.
Al realizar consultas, puede ser conveniente especificar un `Group` en `GroupBy`. Sin embargo, para un control de más precisión sobre los datos que se devuelven, especifique la lista de dimensiones. Por ejemplo, si todo lo que se necesita es `db.query_tokenized.statement`, entonces se puede añadir un atributo `Dimensions` al archivo query.json.
```
[
{
"Metric": "db.load.avg",
"GroupBy": {
"Group": "db.query_tokenized",
"Dimensions":["db.query_tokenized.statement"],
"Limit": 10
}
}
]
```
### Recuperación del promedio de carga de base de datos filtrado por consulta
La consulta de API correspondiente en este ejemplo es similar al comando en [Recuperación del promedio de carga de base de datos para las instrucciones de consulta principales](#performance-insights-metrics-api-examples.topquery). Sin embargo, el archivo query.json tiene los elementos indicados a continuación.
```
[
{
"Metric": "db.load.avg",
"GroupBy": { "Group": "db.wait_state", "Limit": 5 },
"Filter": { "db.query_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
}
]
```
En esta respuesta, todos los valores se filtran según la contribución de la consulta tokenizada EXAMPLE especificada en el AKIAIOSFODNN7 archivo query.json. Las claves también podrían seguir un orden distinto de una consulta sin un filtro, porque la consulta filtrada afectaba a los cinco eventos de espera principales.
# CloudWatch Métricas de Amazon para Performance Insights
Performance Insights publica automáticamente las métricas en Amazon CloudWatch. Se pueden consultar los mismos datos desde Performance Insights, pero tener las métricas integradas CloudWatch facilita la adición de CloudWatch alarmas. También resulta fácil añadir las métricas a paneles de CloudWatch existentes.
| Métrica | Description (Descripción) |
| --- | --- |
| DBLoad | El número de sesiones activas de Amazon DocumentDB. Normalmente, necesita los datos del número promedio de sesiones activas. En Performance Insights, estos datos se consultan como `db.load.avg`. |
| DBLoad¿CPU | El número de sesiones activas cuyo tipo de evento de espera es CPU. En Información sobre rendimiento, estos datos se consultan como `db.load.avg`, filtrados por el tipo de evento de espera `CPU`. |
| DBLoadSin CPU | El número de sesiones activas cuyo tipo de evento de espera no es CPU. |
**nota**
Estas métricas se publican CloudWatch solo si hay carga en la instancia de base de datos.
Puede examinar estas métricas mediante la CloudWatch consola AWS CLI, la o la CloudWatch API.
Por ejemplo, puede obtener las estadísticas de la `DBLoad` métrica ejecutando el [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)comando.
```
aws cloudwatch get-metric-statistics \
--region ap-south-1 \
--namespace AWS/DocDB \
--metric-name DBLoad \
--period 360 \
--statistics Average \
--start-time 2022-03-14T8:00:00Z \
--end-time 2022-03-14T9:00:00Z \
--dimensions Name=DBInstanceIdentifier,Value=documentdbinstance
```
Este ejemplo genera un resultado similar al siguiente.
```
{
"Datapoints": [
{
"Timestamp": "2022-03-14T08:42:00Z",
"Average": 1.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:24:00Z",
"Average": 2.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:54:00Z",
"Average": 6.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:36:00Z",
"Average": 5.7,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:06:00Z",
"Average": 4.0,
"Unit": "None"
},
{
"Timestamp": "2022-03-14T08:00:00Z",
"Average": 5.2,
"Unit": "None"
}
],
"Label": "DBLoad"
}
```
Puede utilizar la función matemática de `DB_PERF_INSIGHTS` métricas de la CloudWatch consola para consultar las métricas de los contadores de Amazon DocumentDB Performance Insights. La función `DB_PERF_INSIGHTS` también incluye la métrica `DBLoad` intervalos de menos de un minuto. Puede configurar CloudWatch alarmas en estas métricas. Para obtener más información sobre cómo crear una alarma, consulte [Crear una alarma en las métricas del contador de Performance Insights a partir de una AWS base de datos](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html).
Para obtener más información CloudWatch, consulta [¿Qué es Amazon CloudWatch?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) en la *Guía del CloudWatch usuario de Amazon*.
# Métricas de contador para Información sobre rendimiento
Las métricas de contador son métricas de rendimiento de sistemas operativos en el panel de control de Información sobre rendimiento. Para ayudar a identificar y analizar los problemas de rendimiento, puede correlacionar las métricas de contador con la carga de base de datos.
## Contadores de sistemas operativos de Información de rendimiento
Los siguientes contadores de sistemas operativos están disponibles para Información sobre rendimiento para Amazon DocumentDB.
| Contador | Tipo | Métrica |
| --- | --- | --- |
| active (activa) | memory | os.memory.active |
| buffers | memory | os.memory.buffers |
| cached | memory | os.memory.cached |
| dirty | memory | os.memory.dirty |
| free | memory | os.memory.free |
| inactive | memory | os.memory.inactive |
| mapped | memory | os.memory.mapped |
| pageTables | memory | os.memory.pageTables |
| slab | memory | os.memory.slab |
| total | memory | os.memory.total |
| writeback | memory | os.memory.writeback |
| idle | cpuUtilization | os.cpuUtilization.idle |
| system | cpuUtilization | os.cpuUtilization.system |
| total | cpuUtilization | os.cpuUtilization.total |
| user | cpuUtilization | os.cpuUtilization.user |
| wait | cpuUtilization | os.cpuUtilization.wait |
| one | loadAverageMinute | Jos. loadAverageMinute.one |
| fifteen | loadAverageMinute | Jos. loadAverageMinute.quince |
| cinco | loadAverageMinute | así que. loadAverageMinute.cinco |
| cached | swap | os.swap.cached |
| free | swap | os.swap.free |
| in | swap | os.swap.in |
| out | swap | os.swap.out |
| total | swap | os.swap.total |
| rx | network | os.network.rx |
| tx | network | os.network.tx |
| num VCPUs | general | os.general.num VCPUs |