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