

# Monitoreo de la carga de base de datos con Performance Insights en Amazon RDS
<a name="USER_PerfInsights"></a>

**importante**  
 AWS ha anunciado la fecha de fin de la vida útil de información de rendimiento: 30 de junio de 2026. Después de esta fecha, Amazon RDS dejará de admitir la experiencia de la consola de Información de rendimiento, los periodos de retención flexibles (de 1 a 24 meses) y los precios asociados. La API de Información de rendimiento seguirá existiendo sin cambios en los precios. Los costos de la API de Información de rendimiento aparecerán en la factura de AWS junto con el costo de información de la base de datos de CloudWatch.   
 Le recomendamos que actualice cualquier instancia de base de datos con el nivel de pago de información de rendimiento al modo avanzado de la información de la base de datos antes del 30 de junio de 2026. Para obtener información sobre la actualización al modo avanzado de Información de rendimiento, consulte [Activación del modo avanzado de Información sobre las bases de datos para Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Si no realiza ninguna acción, las instancias de base de datos que utilizan Información de rendimiento pasarán por defecto a utilizar el modo estándar de Información de rendimiento. Con el modo estándar de Información de base de datos, es posible que pierda el acceso al historial de datos de rendimiento de más de 7 días y que no pueda utilizar los planes de ejecución y las características de análisis bajo demanda en la consola de Amazon RDS. Después del 30 de junio de 2026, solo el modo avanzado de la información de base de datos admitirá los planes de ejecución y el análisis bajo demanda.   
 Con la información de la base de datos de CloudWatch, puede supervisar la carga de base de datos de la flota de bases de datos y analizar y solucionar problemas de rendimiento a escala. Para obtener más detalles acerca de Información de base de datos, consulte [Supervisión de las bases de datos de Amazon RDS con Información sobre las bases de datos de CloudWatch](USER_DatabaseInsights.md). Para obtener más información sobre precios, consulte [Precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). 

Performance Insights amplía las características de supervisión existentes de Amazon RDS para ilustrar y ayudarlo a analizar el rendimiento de la base de datos. En el panel de Performance Insights puede visualizar la carga de la base de datos en su carga de instancia de base de datos de Amazon RDS y filtrarla por esperas, instrucciones SQL, hosts o usuarios. Para obtener más información sobre el uso de Performance Insights con Amazon DocumentDB, consulte la *[Guía para desarrolladores de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html)*.

**Topics**
+ [Uso de Performance Insights en Amazon RDS](USER_PerfInsights.Overview.md)
+ [Activación y desactivación de Información de rendimiento de Amazon RDS](USER_PerfInsights.Enabling.md)
+ [Descripción general de Performance Schema para Información de rendimiento en Amazon RDS para MariaDB o MySQL](USER_PerfInsights.EnableMySQL.md)
+ [Configuración de directivas de acceso para información sobre rendimiento](USER_PerfInsights.access-control.md)
+ [Análisis de métricas mediante el panel de Información sobre rendimiento](USER_PerfInsights.UsingDashboard.md)
+ [Visualización de las recomendaciones proactivas de Información de rendimiento](USER_PerfInsights.InsightsRecommendationViewDetails.md)
+ [Recuperación de métricas con la API de Información sobre rendimiento para Amazon RDS](USER_PerfInsights.API.md)
+ [Registro de llamadas de Performance Insights mediante el uso de AWS CloudTrail](USER_PerfInsights.CloudTrail.md)
+ [API de Información de rendimiento y puntos de conexión de VPC de interfaz (AWS PrivateLink)](pi-vpc-interface-endpoints.md)

# Uso de Performance Insights en Amazon RDS
<a name="USER_PerfInsights.Overview"></a>

**importante**  
 AWS ha anunciado la fecha de fin de la vida útil de información de rendimiento: 30 de junio de 2026. Después de esta fecha, Amazon RDS dejará de admitir la experiencia de la consola de Información de rendimiento, los periodos de retención flexibles (de 1 a 24 meses) y los precios asociados. La API de Información de rendimiento seguirá existiendo sin cambios en los precios. Los costos de la API de Información de rendimiento aparecerán en la factura de AWS junto con el costo de información de la base de datos de CloudWatch.   
 Le recomendamos que actualice cualquier instancia de base de datos con el nivel de pago de información de rendimiento al modo avanzado de la información de la base de datos antes del 30 de junio de 2026. Para obtener información sobre la actualización al modo avanzado de Información de rendimiento, consulte [Activación del modo avanzado de Información sobre las bases de datos para Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Si no realiza ninguna acción, las instancias de base de datos que utilizan Información de rendimiento pasarán por defecto a utilizar el modo estándar de Información de rendimiento. Con el modo estándar de Información de base de datos, es posible que pierda el acceso al historial de datos de rendimiento de más de 7 días y que no pueda utilizar los planes de ejecución y las características de análisis bajo demanda en la consola de Amazon RDS. Después del 30 de junio de 2026, solo el modo avanzado de la información de base de datos admitirá los planes de ejecución y el análisis bajo demanda.   
 Con la información de la base de datos de CloudWatch, puede supervisar la carga de base de datos de la flota de bases de datos y analizar y solucionar problemas de rendimiento a escala. Para obtener más detalles acerca de Información de base de datos, consulte [Supervisión de las bases de datos de Amazon RDS con Información sobre las bases de datos de CloudWatch](USER_DatabaseInsights.md). Para obtener más información sobre precios, consulte [Precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). 

De forma predeterminada, RDS habilita Información sobre rendimiento en el asistente de creación de la consola para todos los motores de Amazon RDS. Si tiene más de una base de datos en una instancia de base de datos, Performance Insights agrega datos de rendimiento.

Encontrará información general sobre Performance Insights para Amazon RDS en el siguiente vídeo.

[![AWS Videos](http://img.youtube.com/vi/yOeWcPBT458/0.jpg)](http://www.youtube.com/watch?v=yOeWcPBT458)


**importante**  
Los siguientes temas describen cómo usar la característica de Performance Insights de Amazon RDS con motores de base de datos que no son de Aurora. Para obtener información sobre el uso de Performance Insights de Amazon RDS con Amazon Aurora, consulte [Uso de Performance Insights de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.html) en la *guía del usuario de Amazon Aurora*.

**Topics**
+ [Carga de base de datos](USER_PerfInsights.Overview.ActiveSessions.md)
+ [Máximo de la CPU](USER_PerfInsights.Overview.MaxCPU.md)
+ [El motor de base de datos de Amazon RDS , la región y la clase de instancia son compatibles con Información de rendimiento](USER_PerfInsights.Overview.Engines.md)
+ [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md)

# Carga de base de datos
<a name="USER_PerfInsights.Overview.ActiveSessions"></a>

La *carga de base de datos* mide el nivel de actividad de la sesión en la base de datos. `DBLoad` es la métrica clave de Información sobre rendimiento y Información sobre rendimiento recopila la carga de la base de datos cada segundo.

**Topics**
+ [Sesiones activas](#USER_PerfInsights.Overview.ActiveSessions.active-sessions)
+ [Sesiones activas promedio](#USER_PerfInsights.Overview.ActiveSessions.AAS)
+ [Ejecuciones activas promedio](#USER_PerfInsights.Overview.ActiveSessions.AAE)
+ [Dimensiones](#USER_PerfInsights.Overview.ActiveSessions.dimensions)

## Sesiones activas
<a name="USER_PerfInsights.Overview.ActiveSessions.active-sessions"></a>

Una *sesión de base de datos* representa el diálogo de una aplicación con una base de datos relacional. Una sesión activa es una conexión que ha enviado trabajo al motor de base de datos y está esperando una respuesta. 

Una sesión está activa cuando se ejecuta en la CPU o a la espera de que un recurso esté disponible para que pueda continuar. Por ejemplo, una sesión activa puede esperar a que se lea una página (o bloque) en la memoria y, a continuación, consumir CPU mientras lee los datos de la página. 

## Sesiones activas promedio
<a name="USER_PerfInsights.Overview.ActiveSessions.AAS"></a>

El *promedio de sesiones activas (AAS)* es la unidad para la métrica de `DBLoad` en Performance Insights. Mide cuántas sesiones están activas simultáneamente en la base de datos.

Cada segundo, Información de rendimiento muestra el número de sesiones que ejecutan una consulta simultáneamente. Para cada sesión activa, Información de rendimiento recopila los siguientes datos:
+ Instrucción SQL
+ Estado de la sesión (en ejecución en la CPU o en espera)
+ Host
+ Usuario que ejecuta el SQL

Información de rendimiento calcula el AAS que se obtiene dividiendo el número total de sesiones entre el número total de ejemplos de un periodo de tiempo específico. Por ejemplo, en la tabla siguiente se muestran 5 ejemplos consecutivos de una consulta en ejecución realizada a intervalos de 1 segundo.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

En el ejemplo anterior, la carga de base de datos para el intervalo de tiempo es de 2 AAS. Esta medición significa que, de media, 2 sesiones han estado activas a la vez durante el plazo en que se han tomado las 5 muestras.

## Ejecuciones activas promedio
<a name="USER_PerfInsights.Overview.ActiveSessions.AAE"></a>

Las ejecuciones activas promedio (AAE) por segundo están relacionadas con las sesiones activas promedio. Para calcular el AAE, Performance Insights divide el tiempo total de ejecución de una consulta por el intervalo de tiempo. En la tabla siguiente se muestra el cálculo de AAE para la misma consulta de la tabla anterior.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html)

En la mayoría de los casos, el AAS y el AAE de una consulta dan aproximadamente lo mismo. Sin embargo, dado que las entradas de los cálculos son diferentes orígenes de datos, los cálculos suelen variar ligeramente.

## Dimensiones
<a name="USER_PerfInsights.Overview.ActiveSessions.dimensions"></a>

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 “dividir por” de las diferentes características de la métrica `DBLoad`.

Cuando se diagnostican problemas de rendimiento, las siguientes dimensiones suelen ser las más útiles:

**Topics**
+ [Eventos de espera](#USER_PerfInsights.Overview.ActiveSessions.waits)
+ [SQL principal](#USER_PerfInsights.Overview.ActiveSessions.top-sql)
+ [Planes](#USER_PerfInsights.Overview.ActiveSessions.plans)

Para obtener una lista completa de las dimensiones de los motores de Amazon RDS, consulte [Carga de base de datos dividida por dimensiones](USER_PerfInsights.UsingDashboard.Components.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims).

### Eventos de espera
<a name="USER_PerfInsights.Overview.ActiveSessions.waits"></a>

Un *evento de espera* hace que una instrucción SQL espere a que ocurra un evento específico antes de que pueda continuar ejecutándose. Los eventos de espera son una dimensión o categoría importante de la carga de base de datos, porque indican dónde se ve obstaculizado el trabajo. 

Cada sesión activa se ejecuta en la CPU o en espera. Por ejemplo, las sesiones consumen CPU cuando buscan memoria para un búfer, llevan a cabo un cálculo o ejecutan código de procedimiento. Cuando las sesiones no consumen CPU, pueden estar en espera de que se libere un búfer de memoria, se lea un archivo de datos o se escriba un registro. Cuanto más tiempo espere una sesión por los recursos, menos tiempo se ejecutará en la CPU. 

Cuando ajusta una base de datos, a menudo intenta averiguar los recursos que esperan las sesiones. Por ejemplo, dos o tres eventos de espera podrían representar el 90 por ciento de la carga de base de datos. Esta medida significa que, en promedio, las sesiones activas pasan la mayor parte del tiempo en espera de un pequeño número de recursos. Si puede averiguar la causa de estas esperas, puede intentar una solución. 

Los eventos de espera varían en función del motor de base de datos: 
+ Para obtener más información sobre todos los eventos de espera de MariaDB y MySQL, consulte [Wait Event Summary Tables (Tablas de resumen de eventos de espera)](https://dev.mysql.com/doc/refman/8.0/en/performance-schema-wait-summary-tables.html) en la documentación de MySQL.
+ Para obtener más información sobre todos los eventos de espera de PostgreSQL, consulte [Ecentos de espera de PostgreSQL](https://www.postgresql.org/docs/current/monitoring-stats.html#WAIT-EVENT-TABLE) en la documentación de PostgreSQL.
+ Para obtener más información sobre todos los eventos de espera de Oracle, consulte [Descriptions of Wait Events (Descripciones de los eventos de espera)](https://docs.oracle.com/database/121/REFRN/GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2.htm#REFRN-GUID-2FDDFAA4-24D0-4B80-A157-A907AF5C68E2) en la documentación de Oracle.
+ Para obtener información sobre todos los eventos de espera de SQL Server, consulte [ Types of Waits (Tipos de espera)](https://docs.microsoft.com/en-us/sql/relational-databases/system-dynamic-management-views/sys-dm-os-wait-stats-transact-sql?view=sql-server-2017#WaitTypes) en la documentación de SQL Server.

**nota**  
Para Oracle, los procesos en segundo plano a veces funcionan sin una instrucción SQL asociada. En estos casos, Performance Insights informa del tipo de proceso en segundo plano concatenado con un punto y coma y la clase de espera asociada a ese proceso en segundo plano. Entre los tipos de procesos en segundo plano se incluyen `LGWR`, `ARC0`, `PMON`, etc.   
Por ejemplo, cuando el archivador está realizando E/S, el informe de Performance Insights correspondiente es similar a `ARC1:System I/O`. Ocasionalmente, también falta el tipo de proceso en segundo plano y Performance Insights solo informa sobre la clase de espera, por ejemplo, `:System I/O`.

### SQL principal
<a name="USER_PerfInsights.Overview.ActiveSessions.top-sql"></a>

Mientras que los eventos de espera muestran los cuellos de botella, la dimensión SQL principal indica qué consultas contribuyen más a la carga de 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 base de datos. En este caso, es posible que la carga alta indique un problema con la consulta.

De forma predeterminada, en la consola de Performance Insights se muestran las principales consultas SQL que contribuyen a la carga de la base de datos. En la consola se muestran también estadísticas importantes sobre cada instrucción. Para diagnosticar los problemas de rendimiento de una instrucción específica, puede examinar su plan de ejecución.

### Planes
<a name="USER_PerfInsights.Overview.ActiveSessions.plans"></a>

Un *plan de ejecución*, también llamado simplemente *plan*, es una secuencia de pasos que acceden a los datos. Por ejemplo, un plan para unir las tablas `t1` y `t2` podría recorrer en bucle todas las filas de `t1` y comparar cada fila con una fila de `t2`. En una base de datos relacional, un *optimizador* es un código integrado que determina el plan más eficiente para una consulta de SQL.

Para las instancias de base de datos, Información de rendimiento recopila planes de ejecución automáticamente. Para diagnosticar problemas de rendimiento de SQL, examine los planes capturados para consultas de SQL de altos recursos. Los planes muestran cómo la base de datos ha analizado y ha ejecutado consultas.

Para obtener información sobre cómo analizar la carga de la base de datos mediante planes, consulte:
+ Oracle: [Análisis de planes de ejecución de Oracle mediante el panel de Información de rendimiento para Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ SQL Server: [Análisis de planes de ejecución de SQL Server mediante el panel de Información de rendimiento para Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

#### Captura del plan
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.capture"></a>

Cada cinco minutos, Información de rendimiento identifica las consultas que requieren más recursos y captura sus planes. Por lo tanto, no es necesario recopilar ni administrar manualmente una gran cantidad de planes. En su lugar, puede usar la pestaña **Top SQL** (SQL principal) para centrarse en los planes de las consultas más problemáticas. 

**nota**  
Performance Insights no captura planes para consultas cuyo texto supere el límite máximo de texto de consulta recopilable. Para obtener más información, consulte [Acceso a más texto SQL en el panel de Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md).

El período de retención de los planes de ejecución es el mismo que el de todos los datos de Performance Insights. La configuración de retención en la capa gratuita es **Default (7 days) (Predeterminado [7 días])**. Para retener los datos de rendimiento durante más tiempo, especifique de 1 a 24 meses. Para obtener más información acerca de los periodos de retención, consulte [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md).

#### Consultas de resumen
<a name="USER_PerfInsights.Overview.ActiveSessions.plans.digest"></a>

La pestaña **Top SQL** (SQL principal) muestra las consultas de resumen de forma predeterminada. Una consulta de resumen no tiene por sí misma un plan, pero todas las consultas que utilizan valores literales sí tienen planes. Por ejemplo, una consulta de resumen podría incluir el texto `WHERE `email`=?`. El resumen podría contener dos consultas, una con el texto `WHERE email=user1@example.com` y otra con `WHERE email=user2@example.com`. Cada una de estas consultas literales podría incluir varios planes.

Al seleccionar una consulta de resumen, la consola muestra todos los planes para las instrucciones secundarias del resumen seleccionado. Por lo tanto, no es necesario revisar todas las instrucciones secundarias para encontrar el plan. Es posible que vea planes que no están en la lista mostrada de las 10 principales instrucciones secundarias. La consola muestra los planes de todas las consultas secundarias para las que se han recopilado planes, independientemente de si las consultas se encuentran entre las 10 principales.

# Máximo de la CPU
<a name="USER_PerfInsights.Overview.MaxCPU"></a>

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**. Información sobre rendimiento determina el valor **Máximo de la CPU virtual** mediante el número de núcleos de vCPU (CPU virtual) de la instancia de base de datos. 

Se puede ejecutar un proceso en una vCPU a la vez. Si el número de procesos supera el número de vCPU, los procesos comienzan a ponerse en cola. Cuando las colas aumentan, el rendimiento de la base de datos disminuye. 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 SQL 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**.

# El motor de base de datos de Amazon RDS , la región y la clase de instancia son compatibles con Información de rendimiento
<a name="USER_PerfInsights.Overview.Engines"></a>

**importante**  
 AWS ha anunciado la fecha de fin de la vida útil de información de rendimiento: 30 de junio de 2026. Después de esta fecha, Amazon RDS dejará de admitir la experiencia de la consola de Información de rendimiento, los periodos de retención flexibles (de 1 a 24 meses) y los precios asociados. La API de Información de rendimiento seguirá existiendo sin cambios en los precios. Los costos de la API de Información de rendimiento aparecerán en la factura de AWS junto con el costo de información de la base de datos de CloudWatch.   
 Le recomendamos que actualice cualquier instancia de base de datos con el nivel de pago de información de rendimiento al modo avanzado de la información de la base de datos antes del 30 de junio de 2026. Para obtener información sobre la actualización al modo avanzado de Información de rendimiento, consulte [Activación del modo avanzado de Información sobre las bases de datos para Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Si no realiza ninguna acción, las instancias de base de datos que utilizan Información de rendimiento pasarán por defecto a utilizar el modo estándar de Información de rendimiento. Con el modo estándar de Información de base de datos, es posible que pierda el acceso al historial de datos de rendimiento de más de 7 días y que no pueda utilizar los planes de ejecución y las características de análisis bajo demanda en la consola de Amazon RDS. Después del 30 de junio de 2026, solo el modo avanzado de la información de base de datos admitirá los planes de ejecución y el análisis bajo demanda.   
 Con la información de la base de datos de CloudWatch, puede supervisar la carga de base de datos de la flota de bases de datos y analizar y solucionar problemas de rendimiento a escala. Para obtener más detalles acerca de Información de base de datos, consulte [Supervisión de las bases de datos de Amazon RDS con Información sobre las bases de datos de CloudWatch](USER_DatabaseInsights.md). Para obtener más información sobre precios, consulte [Precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). 

Las siguiente tabla indica los motores de base de datos de Amazon RDS que admiten la Información de rendimiento.

**nota**  
Para Amazon Aurora, consulte [El motor de base de datos de Amazon Aurora admite Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.Engines.html)en *Guía del usuario de Amazon Aurora*.


|  Motor de base de datos de Amazon RDS  | Versiones de motor y regiones compatibles | Restricciones de clase de instancia | 
| --- | --- | --- | 
|  Amazon RDS para MariaDB  |  Para obtener más información sobre la disponibilidad en versiones y regiones de Performance Insights con RDS para MariaDB, consulte [Regiones y motores de base de datos admitidos para Información sobre rendimiento en Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  Performance Insights no es compatible con las siguientes clases de instancia: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  RDS for MySQL  |  Para obtener más información sobre la disponibilidad en versiones y regiones de Performance Insights con RDS para MySQL, consulte [Regiones y motores de base de datos admitidos para Información sobre rendimiento en Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  Performance Insights no es compatible con las siguientes clases de instancia: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  | 
|  Amazon RDS for Microsoft SQL Server  |  Para obtener más información sobre la disponibilidad en versiones y regiones de Performance Insights con RDS para SQL Server, consulte [Regiones y motores de base de datos admitidos para Información sobre rendimiento en Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/A  | 
|  Amazon RDS para PostgreSQL  |  Para obtener más información sobre la disponibilidad en versiones y regiones de Performance Insights con RDS para PostgreSQL, consulte [Regiones y motores de base de datos admitidos para Información sobre rendimiento en Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/A  | 
|  Amazon RDS para Oracle  |  Para obtener más información sobre la disponibilidad en versiones y regiones de Performance Insights con RDS para Oracle, consulte [Regiones y motores de base de datos admitidos para Información sobre rendimiento en Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md).  |  N/A  | 

## Compatibilidad del motor de la base de datos, la región y la clase de instancia de Amazon RDS  con características de Información de rendimiento
<a name="USER_PerfInsights.Overview.PIfeatureEngnRegSupport"></a>

Las siguiente tabla indica los motores de base de datos de Amazon RDS que admiten características de Información de rendimiento.


| Característica | [Niveles de precios](https://aws.amazon.com/rds/performance-insights/pricing/) |  [Regiones admitidas](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html#Concepts.RegionsAndAvailabilityZones.Regions)  |  [ Motores de bases de datos compatibles](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html#Welcome.Concepts.DBInstance)  |  [Clases de instancias admitidas](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html#Concepts.DBInstanceClass.Types)  | 
| --- | --- | --- | --- | --- | 
| [Estadísticas de SQL para Performance Insights](sql-statistics.md) | Todos | Todos |  Todos  | Todos | 
| [Análisis de planes de ejecución de Oracle mediante el panel de Información de rendimiento para Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md) | Todos | Todos |  RDS para Oracle  | Todos | 
| [Análisis del rendimiento de la base de datos durante un período de tiempo](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md) | Solo nivel de pago |  Todos  |  RDS para PostgreSQL  |  Todos  | 
|  [Visualización de las recomendaciones proactivas de Información de rendimiento](USER_PerfInsights.InsightsRecommendationViewDetails.md) | Solo nivel de pago | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.Engines.html)  |  Todos  | Todos  | 

# Precios y retención de datos de Performance Insights
<a name="USER_PerfInsights.Overview.cost"></a>

De forma predeterminada, Performance Insights ofrece una capa gratuita que incluye 7 días de historial de datos de rendimiento y 1 millón de solicitudes de API al mes. También puede comprar períodos de retención más largos. Para obtener información completa sobre los precios, consulte los [precios de Performance Insights](https://aws.amazon.com/rds/performance-insights/pricing/).

En la consola de RDS, puede elegir cualquiera de los siguientes períodos de retención de sus datos de Performance Insights:
+ **Predeterminado (7 días)**
+ ***n*meses**, donde***n***es un número del 1 al 24

![\[Elija un período de retención para los datos de Performance Insights.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-retention-periods.png)


Para obtener información para configurar un período de retención con AWS CLI, consulte .

# Activación y desactivación de Información de rendimiento de Amazon RDS
<a name="USER_PerfInsights.Enabling"></a>

**importante**  
 AWS ha anunciado la fecha de fin de la vida útil de información de rendimiento: 30 de junio de 2026. Después de esta fecha, Amazon RDS dejará de admitir la experiencia de la consola de Información de rendimiento, los periodos de retención flexibles (de 1 a 24 meses) y los precios asociados. La API de Información de rendimiento seguirá existiendo sin cambios en los precios. Los costos de la API de Información de rendimiento aparecerán en la factura de AWS junto con el costo de información de la base de datos de CloudWatch.   
 Le recomendamos que actualice cualquier instancia de base de datos con el nivel de pago de información de rendimiento al modo avanzado de la información de la base de datos antes del 30 de junio de 2026. Para obtener información sobre la actualización al modo avanzado de Información de rendimiento, consulte [Activación del modo avanzado de Información sobre las bases de datos para Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Si no realiza ninguna acción, las instancias de base de datos que utilizan Información de rendimiento pasarán por defecto a utilizar el modo estándar de Información de rendimiento. Con el modo estándar de Información de base de datos, es posible que pierda el acceso al historial de datos de rendimiento de más de 7 días y que no pueda utilizar los planes de ejecución y las características de análisis bajo demanda en la consola de Amazon RDS. Después del 30 de junio de 2026, solo el modo avanzado de la información de base de datos admitirá los planes de ejecución y el análisis bajo demanda.   
 Con la información de la base de datos de CloudWatch, puede supervisar la carga de base de datos de la flota de bases de datos y analizar y solucionar problemas de rendimiento a escala. Para obtener más detalles acerca de Información de base de datos, consulte [Supervisión de las bases de datos de Amazon RDS con Información sobre las bases de datos de CloudWatch](USER_DatabaseInsights.md). Para obtener más información sobre precios, consulte [Precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). 

Puede activar la información sobre rendimiento para el instancia o clúster de base de datos multi-AZ de base de datos durante su creación. Si es necesario, puede desactivarlo más adelante. Para ello, modifique el instancia de base de datos en la consola. La activación y desactivación de Información de rendimiento no provoca tiempo de inactividad, un reinicio ni una conmutación por error.

**nota**  
Performance Schema es una herramienta de rendimiento opcional utilizada por Amazon RDS para MariaDB o MySQL. Si activa o desactiva Esquema de rendimiento, debe reiniciar. Sin embargo, si activa o desactiva Performance Insights, no es necesario que se reinicie. Para obtener más información, consulte [Descripción general de Performance Schema para Información de rendimiento en Amazon RDS para MariaDB o MySQL](USER_PerfInsights.EnableMySQL.md).

El agente Performance Insights 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.

------
#### [ Console ]

En la consola, puede activar o desactivar Información sobre rendimiento al crear o modificar una instancia de base de datos o un clúster de bases de datos multi-AZ.

**Activación o desactivación de Performance Insights al crear una instancia de base de datos o un clúster de bases de datos Multi-AZ**

Tras crear una nueva instancia de base de datos o un clúster de base de datos Multi-AZ, Amazon RDS habilita información sobre rendimiento de forma predeterminada. Para desactivar información sobre rendimiento, elija la opción **Información de base de datos: estándar** y desmarque la opción **Habilitar información sobre rendimiento**.

Para obtener más información, consulte los siguientes temas. 
+ Para crear una instancia de base de datos, siga las instrucciones del motor de base de datos específico que se indican en [Creación de una instancia de base de datos de Amazon RDS](USER_CreateDBInstance.md).
+ Para crear un clúster de bases de datos Multi-AZ, siga las instrucciones para su motor de base de datos en [Creación de un clúster de base de datos multi-AZ para Amazon RDS](create-multi-az-db-cluster.md).

La siguiente captura de pantalla muestra la sección **Información de rendimiento**.

![\[Active Información sobre rendimiento durante la creación de una instancia de base de datos o un clúster de bases de datos Multi-AZ con la consola\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_enabling.png)


Si elige **Activar Información de rendimiento**, dispondrá de las siguientes opciones:
+ **Retención** (solo para el modo estándar de información sobre rendimiento): la cantidad de tiempo durante el que se retienen los datos de información sobre rendimiento. La configuración de retención es **Predeterminada (7 días)**. Para retener los datos de rendimiento durante más tiempo, especifique de 1 a 24 meses. Para obtener más información acerca de los periodos de retención, consulte [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md).
+ **AWS KMS key** – especifique su AWS KMS key. Performance Insights cifra todos los datos potencialmente confidenciales con su propia clave de KMS. Las datos se cifran en reposo y en tránsito. Para obtener más información, consulte [Cambio de una política de AWS KMS para Información de rendimiento](USER_PerfInsights.access-control.cmk-policy.md).

**Activación o desactivación de información sobre rendimiento al modificar un instancia de base de datos o clúster de base de datos multi-AZ**

En la consola, puede modificar una instancia de base de datos o clúster de base de datos multi-AZ para administrar información sobre rendimiento. 

**Para administrar información sobre rendimiento para una instancia de base de datos o clúster de base de datos multi-AZ mediante la consola**

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

1. Seleccione **Bases de datos**.

1. Elija un instancia de base de datos o clúster de base de datos multi-AZ y elija **Modificar**.

1. Para activar la Información de rendimiento, seleccione **Habilitar Información sobre rendimiento**. Para desactivar información sobre rendimiento, elija la opción **Información de base de datos: estándar** y desmarque la opción **Habilitar información sobre rendimiento**.

   Si elige **Activar Información de rendimiento**, dispondrá de las siguientes opciones:
   + **Retención** (solo para el modo estándar de información sobre rendimiento): la cantidad de tiempo durante el que se retienen los datos de información sobre rendimiento. La configuración de retención es **Predeterminada (7 días)**. Para retener los datos de rendimiento durante más tiempo, especifique de 1 a 24 meses. Para obtener más información acerca de los periodos de retención, consulte [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md).
   + **AWS KMS key** – especifique su clave de KMS. Performance Insights cifra todos los datos potencialmente confidenciales con su propia clave de KMS. Las datos se cifran en reposo y en tránsito. Para obtener más información, consulte [Cifrado de recursos de Amazon RDS](Overview.Encryption.md).

1. Elija **Continuar**.

1. En **Scheduling of Modifications (Programación de modificaciones)** (Programación de modificaciones), elija Apply immediately (Aplicar inmediatamente). Si elige Apply during the next scheduled maintenance window (Aplicar durante la próxima ventana de mantenimiento programada), la instancia ignora esta configuración y activa de inmediato Performance Insights.

1. Elija **Modificar instancia**.

------
#### [ AWS CLI ]

Cuando utilice el comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) de la AWS CLI, active información sobre rendimiento especificando `--enable-performance-insights` y estableciendo `--database-insights-mode` en `advanced` o `standard`. Para desactivar información sobre rendimiento, especifique `--no-enable-performance-insights` y establezca `database-insights-mode` en `standard`.

Estos valores también pueden especificarse con los siguientes comandos de AWS CLI:
+  [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) 
+  [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) 
+  [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) 
+  [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) 
+  [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) 

Al activar Información de rendimiento en la CLI, puede especificar, si lo desea, el tiempo en días que se retienen los datos de Información de rendimiento mediante la opción `--performance-insights-retention-period`. Puede especificar`7`, *mes*\$1 31 (donde *mes* es un número comprendido entre 1 y 23), o `731`. Por ejemplo, si desea retener los datos de rendimiento durante 3 meses, especifique `93`, que es 3 \$1 31. El valor predeterminado es `7` días. Para obtener más información acerca de los periodos de retención, consulte [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md).

El ejemplo siguiente activa Información de rendimiento para `sample-db-cluster` y especifica que los datos de Información de rendimiento se retengan durante 93 días (3 meses).

Para Linux, macOS o Unix:

```
aws rds modify-db-cluster \
	--database-insights-mode standard \
    --db-cluster-identifier sample-db-instance \
    --enable-performance-insights \
    --performance-insights-retention-period 93
```

Para Windows:

```
aws rds modify-db-cluster ^
	--database-insights-mode standard ^
    --db-cluster-identifier sample-db-instance ^
    --enable-performance-insights ^
    --performance-insights-retention-period 93
```

Si especifica un período de retención, como 94 días, que no es un valor válido, RDS emitirá un error.

```
An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: 
Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 
248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731]
```

**nota**  
Solo puede activar Información de rendimiento para una instancia de un clúster de base de datos en la que Información de rendimiento no se administre en el clúster.

------
#### [ RDS API ]

Si crea una nueva instancia de base de datos mediante la operación [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) de la operación de la API de Amazon RDS, active Información de rendimiento configurando `EnablePerformanceInsights` como `True`. Para desactivar información sobre rendimiento, establezca `EnablePerformanceInsights` en `False` y establezca `DatabaseInsightsMode` en `standard`.

También puede especificar el valor `EnablePerformanceInsights` utilizando las siguientes operaciones de la API:
+  [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) (Clúster de base de datos multi-AZ) 
+  [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) (Clúster de base de datos multi-AZ) 
+  [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 
+  [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) 
+  [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 

Cuando activa Información de rendimiento, puede especificar, si lo desea, la cantidad de tiempo en días que se retienen los datos de Información de rendimiento con el parámetro `PerformanceInsightsRetentionPeriod`. Puede especificar`7`, *mes*\$1 31 (donde *mes* es un número comprendido entre 1 y 23), o `731`. Por ejemplo, si desea retener los datos de rendimiento durante 3 meses, especifique `93`, que es 3 \$1 31. El valor predeterminado es `7` días. Para obtener más información acerca de los periodos de retención, consulte [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md).

------

# Descripción general de Performance Schema para Información de rendimiento en Amazon RDS para MariaDB o MySQL
<a name="USER_PerfInsights.EnableMySQL"></a>

Performance Schema es una característica opcional para supervisar el rendimiento de tiempo de ejecución de Amazon RDS para MariaDB o MySQL con un nivel bajo de detalle. Performance Schema está diseñado para tener un impacto mínimo en el rendimiento de la base de datos. Performance Insights es una característica distinta que puede utilizar con o sin Performance Schema.

**Topics**
+ [Información general de Performance Schema](#USER_PerfInsights.EnableMySQL.overview)
+ [Performance Insights y Performance Schema](#USER_PerfInsights.effect-of-pfs)
+ [Administración automática de Performance Schema mediante Performance Insights](#USER_PerfInsights.EnableMySQL.options)
+ [Qué ocurre al activar Performance Schema](#USER_PerfInsights.EnableMySQL.reboot)
+ [Determinación de si Performance Insights está administrando Performance Schema](USER_PerfInsights.EnableMySQL.determining-status.md)
+ [Activación de Performance Schema para Amazon RDS para MariaDB o MySQL](USER_PerfInsights.EnableMySQL.RDS.md)

## Información general de Performance Schema
<a name="USER_PerfInsights.EnableMySQL.overview"></a>

Performance Schema supervisa los eventos en las bases de datos MariaDB y MySQL. Un *evento* es una acción de servidor de base de datos que consume tiempo y se ha instrumentado para que se pueda recopilar información de tiempo. A continuación, se muestran ejemplos de eventos:
+ Llamadas a funciones
+ Esperas del sistema operativo
+ Etapas de la ejecución de SQL
+ Grupos de instrucciones SQL

El motor de almacenamiento `PERFORMANCE_SCHEMA` es un mecanismo para implementar la característica Performance Schema. El motor recopila datos de eventos mediante la instrumentación en el código fuente de la base de datos. El motor almacena eventos en tablas solo en la memoria en la base de datos de `performance_schema`. Puede consultar `performance_schema` al igual que puede consultar cualquier otra tabla. Para obtener más información, consulte [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) en el *Manual de referencia de MySQL*.

## Performance Insights y Performance Schema
<a name="USER_PerfInsights.effect-of-pfs"></a>

Performance Insights y Performance Schema son características independientes, pero están conectadas. El comportamiento de Performance Insights para Amazon RDS para MariaDB o MySQL depende de si Performance Schema está activado y, de ser así, de si Performance Insights administra el Performance Schema automáticamente. La tabla siguiente describe el comportamiento.


| Performance Schema activado | Modo de administración de Performance Insights | Comportamiento de Performance Insights | 
| --- | --- | --- | 
|  Sí  |  Automático  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  Sí  |  Manual  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 
|  No  |  N/A  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/USER_PerfInsights.EnableMySQL.html)  | 

## Administración automática de Performance Schema mediante Performance Insights
<a name="USER_PerfInsights.EnableMySQL.options"></a>

Al crear una instancia de base de datos de Amazon RDS para MariaDB o MySQL con Performance Insights activado, también se activa Performance Schema. En este caso, la Performance Insights administra automáticamente sus parámetros de Esquema de rendimiento. Esta es la configuración recomendada.

Si es así, Información de rendimiento administra automáticamente el Esquema de rendimiento, el **Origen** de `performance_schema` es `System default`.

**nota**  
La clase de instancia t4g.medium no admite la administración automática del esquema de rendimiento.

Si cambia el valor del parámetro `performance_schema` manualmente y, más tarde, desea volver a la gestión automática, consulte [Activación de Performance Schema para Amazon RDS para MariaDB o MySQL](USER_PerfInsights.EnableMySQL.RDS.md).

**importante**  
Cuando Performance Insights activa Performance Schema, no cambia los valores del grupo de parámetros. Sin embargo, los valores se cambian en las instancias de base de datos que se están ejecutando. La única forma de ver los valores modificados es ejecutar elcomando `SHOW GLOBAL VARIABLES`.

## Qué ocurre al activar Performance Schema
<a name="USER_PerfInsights.EnableMySQL.reboot"></a>

Performance Insights y Performance Schema tienen requisitos distintos para los reinicios de instancias de base de datos:

**Performance Schema**  
Para activar o desactivar esta característica, debe reiniciar la instancia de base de datos.

**Información de rendimiento**  
Para activar o desactivar esta característica, no es necesario reiniciar la instancia de base de datos.

Si Performance Schema no está activado actualmente y activa Performance Insights sin reiniciar la instancia de base de datos, Performance Schema no se activará.

# Determinación de si Performance Insights está administrando Performance Schema
<a name="USER_PerfInsights.EnableMySQL.determining-status"></a>

Para saber si Información de rendimiento está administrando actualmente Performance Schema en todas las versiones principales del motor, consulte la siguiente tabla.


| Configuración del parámetro performance\$1schema | Configuración de la columna Source (Origen) | ¿Performance Insights está administrando Performance Schema? | 
| --- | --- | --- | 
| 0 | System default | Sí | 
| 0 o 1 | Modified | No | 

En el siguiente procedimiento, determinará si Información de rendimiento está administrando Performance Schema de forma automática.

**Para determinar si Performance Insights está administrando Performance Schema automáticamente**

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

1. Elija **Parameter groups (Grupos de parámetros)**.

1. Seleccione el grupo de parámetros para la instancia de base de datos.

1. Escriba **performance\$1schema** en la barra de búsqueda.

1. Compruebe si **Origen** es el valor predeterminado del sistema y si **Valor** es **0**. Si es así, la Performance Insights administra automáticamente Performance Schema.

   En este ejemplo, Información de rendimiento no está administrando Performance Schema de forma automática.  
![\[Muestra que la configuración del parámetro performance_schema se ha modificado.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_schema_user.png)

# Activación de Performance Schema para Amazon RDS para MariaDB o MySQL
<a name="USER_PerfInsights.EnableMySQL.RDS"></a>

Supongamos que Performance Insights está activado para su instancia de base de datos o clúster de base de datos Multi-AZ pero no está administrando actualmente Performance Schema. Si desea permitir que Performance Insights administre Performance Schema automáticamente, complete los siguientes pasos.

**Para configurar Performance Schema para la administración automática**

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

1. Elija **Grupos de parámetros**.

1. Seleccione el nombre del grupo de parámetros para la instancia de base de datos o el clúster de bases de datos Multi-AZ.

1. Seleccione **Editar**.

1. Escriba **performance\$1schema** en la barra de búsqueda.

1. Seleccione el parámetro `performance_schema`.

1. Seleccione **Establecer en el valor predeterminado**.

1. Para confirmar, seleccione **Establecer los valores en su forma predeterminada**.

1. Elija **Guardar cambios**.

1. Reinicie la instancia de base de datos o el clúster de bases de datos multi-AZ.
**importante**  
Al activar o desactivar Performance Schema, deberá reiniciar la instancia de base de datos o el clúster de bases de datos Multi-AZ.

Para obtener información sobre cómo modificar los parámetros de la instancia de base de datos, consulte [Modificación de los parámetros de un grupo de parámetros de base de datos en Amazon RDS](USER_WorkingWithParamGroups.Modifying.md). Para obtener más información acerca del panel, consulte [Análisis de métricas mediante el panel de Información sobre rendimiento](USER_PerfInsights.UsingDashboard.md). Para obtener más información sobre el esquema de rendimiento de MySQL, consulte [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.0/en/performance-schema.html) (para 8.0) y [MySQL Performance Schema](https://dev.mysql.com/doc/refman/8.4/en/performance-schema.html) (para 8.4) en la documentación de MySQL.

# Configuración de directivas de acceso para información sobre rendimiento
<a name="USER_PerfInsights.access-control"></a>

Para acceder a Performance Insights, la entidad principal deberá tener los permisos adecuados de AWS Identity and Access Management (IAM).

**nota**  
Para usar información de rendimiento con una clave administrada por el cliente, conceda a los usuarios los permisos `kms:Decrypt` y `kms:GenerateDataKey` para la clave de AWS AWS KMS.

Acceda a información de rendimiento mediante estos métodos:
+ [Asociación de la política administrada `AmazonRDSPerformanceInsightsReadOnly` para el acceso de solo lectura](USER_PerfInsights.access-control.managed-policy.md)
+ [Asociación de la política administrada `AmazonRDSPerformanceInsightsFullAccess` para el acceso a todas las operaciones de la API de información de rendimiento](USER_PerfInsights.access-control.FullAccess-managed-policy.md)
+ [Creación de una política de IAM personalizada con permisos específicos](USER_PerfInsights.access-control.custom-policy.md)
+ [Configuración de permisos de AWS KMS para datos cifrados de información de rendimiento](USER_PerfInsights.access-control.cmk-policy.md)
+ [Configuración de un acceso detallado mediante permisos por recursos](USER_PerfInsights.access-control.dimensionAccess-policy.md)
+ [Uso del control de acceso basado en etiquetas para administrar los permisos mediante etiquetas de recursos](USER_PerfInsights.access-control.tag-based-policy.md)

# Asociación de la política AmazonRDSPerformanceInsightsReadOnly a una entidad principal de IAM
<a name="USER_PerfInsights.access-control.managed-policy"></a>

`AmazonRDSPerformanceInsightsReadOnly` es una política administrada de AWS que concede acceso a todas las operaciones de solo lectura de la API de Información sobre rendimiento de Amazon RDS. 

Si adjunta `AmazonRDSPerformanceInsightsReadOnly` a un rol o conjunto de permisos, también debe asociar los siguientes permisos de CloudWatch:
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

Con estos permisos, el destinatario puede utilizar la información de rendimiento con las demás características de la consola.

 Para obtener más información sobre los permisos de CloudWatch, consulte la [referencia de permisos de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html).

Para obtener más información acerca de `AmazonRDSPerformanceInsightsReadOnly`, consulte [Política administrada por:AWS AmazonRDSPerformanceInsightsReadOnly](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsReadOnly).

# Asociación de la política AmazonRDSPerformanceInsightsFullAccess a una entidad principal de IAM
<a name="USER_PerfInsights.access-control.FullAccess-managed-policy"></a>

`AmazonRDSPerformanceInsightsFullAccess` es una política administrada de AWS que concede acceso a todas las operaciones de la API de Información sobre rendimiento de Amazon RDS.

Si adjunta `AmazonRDSPerformanceInsightsFullAccess` a un rol o conjunto de permisos, también debe asociar los siguientes permisos de CloudWatch:
+ `GetMetricStatistics`
+ `ListMetrics`
+ `GetMetricData`

Con estos permisos, el destinatario puede utilizar la información de rendimiento con las demás características de la consola.

 Para obtener más información sobre los permisos de CloudWatch, consulte la [referencia de permisos de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html).

Para obtener más información acerca de `AmazonRDSPerformanceInsightsFullAccess`, consulte [Política administrada por AWS: AmazonRDSPerformanceInsightsFullAccess](rds-security-iam-awsmanpol.md#rds-security-iam-awsmanpol-AmazonRDSPerformanceInsightsFullAccess).

# Creación de una política de IAM personalizada para la información sobre rendimiento
<a name="USER_PerfInsights.access-control.custom-policy"></a>

En el caso de usuarios que no tengan la política `AmazonRDSPerformanceInsightsReadOnly` o `AmazonRDSPerformanceInsightsFullAccess`, puede conceder acceso a Información sobre rendimiento a través de la creación o modificación de 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 **Crear política**.

1. En la página **Crear política**, elija la opción **JSON**.

1. Copie y pegue el texto proporcionado en la sección *Documento de política de JSON* en la *Guía de referencia de las políticas administradas de AWS* para la política [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsReadOnly.html) o [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonRDSPerformanceInsightsFullAccess.html).

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 Performance Insights, asegúrese de tener acceso a Amazon RDS además de la política personalizada. Por ejemplo, la política predefinida `AmazonRDSPerformanceInsightsReadOnly` ofrece acceso de solo lectura a Amazon RDS. Para obtener más información, consulte [Administración de acceso mediante políticas](UsingWithRDS.IAM.md#security_iam_access-manage).

1. En la página **Summary**, elija **Add permissions**.

1. Elija **Asociar políticas existentes directamente**. En **Buscar**, escriba los primeros caracteres del nombre de la política, como se muestra en la siguiente imagen.   
![\[Elección de una política\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_attach_iam_policy.png)

1. Elija la política y, a continuación, elija **Next: Review**.

1. Elija **Add permissions (Agregar permisos)**.

# Cambio de una política de AWS KMS para Información de rendimiento
<a name="USER_PerfInsights.access-control.cmk-policy"></a>

Performance Insights utiliza una AWS KMS key para cifrar información confidencial. Cuando active Performance Insights a través de la API o de la consola, podrá hacer una de las siguientes cosas:
+ Elegir la predeterminada Clave administrada de AWS.

  Amazon RDS utiliza la Clave administrada de AWS para su nueva instancia de base de datos. Amazon RDS crea una Clave administrada de AWS para su cuenta de Cuenta de AWS. Su cuenta de Cuenta de AWS tiene una Clave administrada de AWS diferente para Amazon RDS para cada Región de AWS.
+ 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 [Políticas de claves en AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) en la *Guía para desarrolladores de AWS Key Management Service*. 

**Example**  
En el siguiente ejemplo se muestra cómo agregar instrucciones a la política de claves de KMS. Estas instrucciones permiten el acceso a la información sobre rendimiento. Dependiendo de cómo utilice la clave KMS, es posible que desee cambiar algunas restricciones. Antes de agregar sentencias a la directiva, elimine todos los comentarios.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Id" : "your-policy",
    "Statement" : [ 
        {
            "Sid" : "AllowViewingRDSPerformanceInsights",
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::444455556666:role/Role1"
                ]
                },
             "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey"
                ],
            "Resource": "*",
            "Condition" : {
            "StringEquals" : {
                "kms:ViaService" : "rds.us-east-1.amazonaws.com"
                },
            "ForAnyValue:StringEquals": {
                "kms:EncryptionContext:aws:pi:service": "rds",
                "kms:EncryptionContext:service": "pi",
                "kms:EncryptionContext:aws:rds:db-id": "db-AAAAABBBBBCCCCDDDDDEEEEE"
                }
            }
        }
    ]
}
```

## Cómo Información de rendimiento utiliza la clave administrada por el cliente de AWS KMS
<a name="USER_PerfInsights.access-control.PI-using-KMS-cmk-policy"></a>

Información de rendimiento utiliza claves administradas por el cliente para cifrar datos confidenciales. Al activar Información de rendimiento, puede proporcionar una clave de AWS KMS a través de la API. Información de rendimiento crea permisos de AWS KMS en esta clave. Utiliza la clave y realiza las operaciones necesarias para procesar los datos confidenciales. Los datos confidenciales incluyen campos como el usuario, la base de datos, la aplicación y el texto de la consulta SQL. Información de rendimiento garantiza que los datos permanezcan cifrados tanto en reposo como en tránsito.

## Funcionamiento de la IAM de Información de rendimiento con AWS KMS
<a name="USER_PerfInsights.access-control.PI-work-with-kms"></a>

IAM otorga permisos a API específicas. Información de rendimiento tiene las siguientes API públicas, que puede restringir mediante políticas de IAM:
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetadata`
+ `GetResourceMetrics`
+ `ListAvailableResourceDimensions`
+ `ListAvailableResourceMetrics`

Puede utilizar las siguientes solicitudes de API para obtener datos confidenciales.
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`
+ `GetResourceMetrics`

Cuando utiliza la API para obtener datos confidenciales, Información de rendimiento utiliza las credenciales del intermediario. Esta comprobación garantiza que el acceso a los datos confidenciales esté limitado a quienes tengan acceso a la clave de KMS.

Al llamar a estas API, necesita permisos para llamar a la API a través de la política de IAM y permisos para invocar la acción `kms:decrypt` a través de la política de claves de AWS KMS.

La API `GetResourceMetrics` puede devolver datos confidenciales y no confidenciales. Los parámetros de la solicitud determinan si la respuesta debe incluir datos confidenciales. La API devuelve datos confidenciales cuando la solicitud incluye una dimensión confidencial en los parámetros del filtro o de grupo. 

Para obtener más información acerca de las dimensiones que puede utilizar con la API `GetResourceMetrics`, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html).

**Example Ejemplos**  
En el siguiente ejemplo se solicitan los datos confidenciales del grupo:`db.user`  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
  "ServiceType": "RDS",
  "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
  "MetricQueries": [
    {
      "Metric": "db.load.avg",
      "GroupBy": {
        "Group": "db.user",
        "Limit": 2
      }
    }
  ],
  "StartTime": 1693872000,
  "EndTime": 1694044800,
  "PeriodInSeconds": 86400
}
```

**Example**  
En el siguiente ejemplo se solicitan los datos no confidenciales de la métrica:`db.load.avg`  

```
POST / HTTP/1.1
Host: <Hostname>
Accept-Encoding: identity
X-Amz-Target: PerformanceInsightsv20180227.GetResourceMetrics
Content-Type: application/x-amz-json-1.1
User-Agent: <UserAgentString>
X-Amz-Date: <Date> 
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
Content-Length: <PayloadSizeBytes>
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "MetricQueries": [
        {
            "Metric": "db.load.avg"
        }
    ],
    "StartTime": 1693872000,
    "EndTime": 1694044800,
    "PeriodInSeconds": 86400
}
```

# Concesión de acceso preciso para Información sobre rendimiento
<a name="USER_PerfInsights.access-control.dimensionAccess-policy"></a>

El control de acceso preciso ofrece formas adicionales de controlar el acceso a Información sobre rendimiento. Este control de acceso puede permitir o denegar el acceso a dimensiones individuales para acciones de Información sobre rendimiento `GetResourceMetrics`, `DescribeDimensionKeys` y `GetDimensionKeyDetails`. Para utilizar el acceso preciso, especifique las dimensiones en la política de IAM mediante claves de condición. La evaluación del acceso sigue la lógica de evaluación de la política de IAM. Para obtener más información, consulte [Lógica de evaluación de políticas](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html) en la *Guía del usuario de IAM*. Si la instrucción de la política de IAM no especifica ninguna dimensión, entonces la instrucción controla el acceso a todas las dimensiones de la acción especificada. Para ver la lista de dimensiones disponibles, consulte [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html).

Para averiguar las dimensiones a las que están autorizadas a acceder sus credenciales, utilice el parámetro `AuthorizedActions` en `ListAvailableResourceDimensions` y especifique la acción. Los valores permitidos para `AuthorizedActions` son los siguientes:
+ `GetResourceMetrics`
+ `DescribeDimensionKeys`
+ `GetDimensionKeyDetails`

Por ejemplo, si especifica `GetResourceMetrics` para el parámetro `AuthorizedActions`, `ListAvailableResourceDimensions` devuelve la lista de dimensiones a las que la acción `GetResourceMetrics` está autorizada a acceder. Si especifica varias acciones en el parámetro `AuthorizedActions`, `ListAvailableResourceDimensions` devuelve una intersección de las dimensiones a las que esas acciones están autorizadas a acceder.

**Example**  
El siguiente ejemplo proporciona acceso a las dimensiones especificadas para las acciones `GetResourceMetrics` y `DescribeDimensionKeys`.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowToDiscoverDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:ListAvailableResourceDimensions"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
        },
        {
            "Sid": "SingleAllow",
            "Effect": "Allow",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAllValues:StringEquals": {
                    "pi:Dimensions": [
                        "db.sql_tokenized.id",
                        "db.sql_tokenized.statement"
                    ]
                }
            }
        }
        

    ]
}
```
A continuación se muestra la respuesta para la dimensión solicitada:  

```
	// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["DescribeDimensionKeys"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                  //  { "Identifier": "db.sql_tokenized.db_id" }, // not included because not allows in the IAM Policy
                    { "Identifier": "db.sql_tokenized.statement" }
                ] 
            }
            
        ] }
    ]
}
```
El siguiente ejemplo especifica un acceso permitido y dos denegados para las dimensiones.    
****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
          {
            "Sid": "AllowToDiscoverDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:ListAvailableResourceDimensions"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
          },

          {
            "Sid": "O01AllowAllWithoutSpecifyingDimensions",
            "Effect": "Allow",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ]
        },
        
        {
            "Sid": "O01DenyAppDimensionForAll",
            "Effect": "Deny",
            "Action": [
                "pi:GetResourceMetrics",
                "pi:DescribeDimensionKeys"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "pi:Dimensions": [
                        "db.application.name"
                    ]
                }
            }
        },
        
        {
            "Sid": "O01DenySQLForGetResourceMetrics",
            "Effect": "Deny",
            "Action": [
                "pi:GetResourceMetrics"
            ],
            "Resource": [
                "arn:aws:pi:us-east-1:123456789012:metrics/rds/db-ABC1DEFGHIJKL2MNOPQRSTUV3W"
            ],
            "Condition": {
                "ForAnyValue:StringEquals": {
                    "pi:Dimensions": [
                        "db.sql_tokenized.statement"
                    ]
                }
            }
        }
    ]
}
```
A continuación se muestran las respuestas para las dimensiones solicitadas:  

```
			// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["GetResourceMetrics"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.application",
                "Dimensions": [
                
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.application.name" }  
                ]
            },
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                    { "Identifier": "db.sql_tokenized.db_id" },
                    
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.sql_tokenized.statement" }
                ] 
            },
            ...
        ] }
    ]
}
```

```
// ListAvailableResourceDimensions API
// Request
{
    "ServiceType": "RDS",
    "Identifier": "db-ABC1DEFGHIJKL2MNOPQRSTUV3W",
    "Metrics": [ "db.load" ],
    "AuthorizedActions": ["DescribeDimensionKeys"]
}

// Response
{    
    "MetricDimensions": [ {
        "Metric": "db.load",
        "Groups": [
            {
                "Group": "db.application",
                "Dimensions": [
                  // removed from response because denied by the IAM Policy
                  //  { "Identifier": "db.application.name" }  
                ]
            },
            {
                "Group": "db.sql_tokenized",
                "Dimensions": [
                    { "Identifier": "db.sql_tokenized.id" },
                    { "Identifier": "db.sql_tokenized.db_id" },
                    
                  // allowed for DescribeDimensionKeys because our IAM Policy 
                  // denies it only for GetResourceMetrics
                    { "Identifier": "db.sql_tokenized.statement" }
                ] 
            },
            ...
        ] }
    ]
}
```

# Uso del control de acceso basado en etiquetas para información de rendimiento
<a name="USER_PerfInsights.access-control.tag-based-policy"></a>

Puede controlar el acceso a métricas de información de rendimiento mediante etiquetas heredadas de la instancia de base de datos principal. Para controlar el acceso a las operaciones de información de rendimiento, utilice políticas de IAM. Estas políticas pueden comprobar las etiquetas de la instancia de base de datos para determinar los permisos.

## Funcionamiento de las etiquetas con información de rendimiento
<a name="USER_PerfInsights.access-control.tag-inheritance"></a>

La información de rendimiento aplica automáticamente las etiquetas de la instancia de base de datos para autorizar las métricas de información de rendimiento. Al agregar etiquetas a la instancia de base de datos, puede utilizarlas inmediatamente para controlar el acceso a los datos de información de rendimiento.
+ Para agregar o actualizar etiquetas para las métricas de información de rendimiento, modifique las etiquetas de la instancia de base de datos.
+ Para ver las etiquetas de las métricas de información de rendimiento, llame a `ListTagsForResource` en el recurso de métricas de información de rendimiento. Devolverá las etiquetas de la instancia de base de datos asociada a la métrica.

**nota**  
Las operaciones `TagResource` y `UntagResource` devuelven un error si intenta usarlas directamente en las métricas de información de rendimiento.

## Creación de políticas de IAM basadas en etiquetas
<a name="USER_PerfInsights.access-control.tag-based-policies"></a>

Para controlar el acceso a las operaciones de información de rendimiento, utilice la clave de condición `aws:ResourceTag` en las políticas de IAM. Estas políticas comprueban las etiquetas de la instancia de base de datos.

**Example**  
Esta política impide el acceso a las métricas de información de rendimiento para las bases de datos de producción. La política rechaza la operación `pi:GetResourceMetrics` en información de rendimiento para cualquier recurso de base de datos etiquetado con `env:prod`.   

```
 {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "pi:GetResourceMetrics",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/env": "prod"
                }
            }
        }
    ]
}
```

# Análisis de métricas mediante el panel de Información sobre rendimiento
<a name="USER_PerfInsights.UsingDashboard"></a>

**importante**  
 AWS ha anunciado la fecha de fin de la vida útil de información de rendimiento: 30 de junio de 2026. Después de esta fecha, Amazon RDS dejará de admitir la experiencia de la consola de Información de rendimiento, los periodos de retención flexibles (de 1 a 24 meses) y los precios asociados. La API de Información de rendimiento seguirá existiendo sin cambios en los precios. Los costos de la API de Información de rendimiento aparecerán en la factura de AWS junto con el costo de información de la base de datos de CloudWatch.   
 Le recomendamos que actualice cualquier instancia de base de datos con el nivel de pago de información de rendimiento al modo avanzado de la información de la base de datos antes del 30 de junio de 2026. Para obtener información sobre la actualización al modo avanzado de Información de rendimiento, consulte [Activación del modo avanzado de Información sobre las bases de datos para Amazon RDS](USER_DatabaseInsights.TurningOnAdvanced.md).   
 Si no realiza ninguna acción, las instancias de base de datos que utilizan Información de rendimiento pasarán por defecto a utilizar el modo estándar de Información de rendimiento. Con el modo estándar de Información de base de datos, es posible que pierda el acceso al historial de datos de rendimiento de más de 7 días y que no pueda utilizar los planes de ejecución y las características de análisis bajo demanda en la consola de Amazon RDS. Después del 30 de junio de 2026, solo el modo avanzado de la información de base de datos admitirá los planes de ejecución y el análisis bajo demanda.   
 Con la información de la base de datos de CloudWatch, puede supervisar la carga de base de datos de la flota de bases de datos y analizar y solucionar problemas de rendimiento a escala. Para obtener más detalles acerca de Información de base de datos, consulte [Supervisión de las bases de datos de Amazon RDS con Información sobre las bases de datos de CloudWatch](USER_DatabaseInsights.md). Para obtener más información sobre precios, consulte [Precios de Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). 

El panel de Performance Insights 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. Puede “dividir” la carga de la base de datos por dimensiones, como eventos de espera o SQL.

**Topics**
+ [Información general del panel de Performance Insights](USER_PerfInsights.UsingDashboard.Components.md)
+ [Acceso al panel Información de rendimiento](USER_PerfInsights.UsingDashboard.Opening.md)
+ [Análisis de carga de base de datos mediante eventos de espera](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.md)
+ [Análisis del rendimiento de la base de datos durante un período de tiempo](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md)
+ [Análisis de consultas con la pestaña Top SQL en Información de rendimiento](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md)
+ [Análisis de la carga de PDB principal de Oracle](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB.md)
+ [Análisis de planes de ejecución mediante el panel de Información de rendimiento para Amazon RDS](USER_PerfInsights.UsingDashboard.AnalyzingPlans.md)

# Información general del panel de Performance Insights
<a name="USER_PerfInsights.UsingDashboard.Components"></a>

El panel es la forma más sencilla de interactuar con Performance Insights. En el siguiente ejemplo, se muestra el panel de una instancia de base de datos de PostgreSQL.

![\[Filtrar métricas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_0b.png)


**Topics**
+ [Filtro de intervalo de tiempo](#USER_PerfInsights.UsingDashboard.Components.time-range)
+ [Gráfico Counter metrics (Métricas de contador)](#USER_PerfInsights.UsingDashboard.Components.Countermetrics)
+ [Gráfico Database load (Carga de base de datos)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions)
+ [Tabla de dimensiones principales](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable)

## Filtro de intervalo de tiempo
<a name="USER_PerfInsights.UsingDashboard.Components.time-range"></a>

De forma predeterminada, el panel de Performance Insights muestra los datos de carga de la base de datos de la última hora. Puede ajustar este rango de modo que sea tan corto como 5 minutos o tan largo como 2 años. También puede seleccionar un rango relativo personalizado.

![\[Performance Insights en tiempo relativo\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-relative-time.png)


Puede seleccionar un rango absoluto con fecha y hora de inicio y fin. En el siguiente ejemplo, se muestra el intervalo de tiempo que comienza a medianoche del 25/09/24 y termina a las 23:59 del 28/09/24.

![\[Performance Insights en tiempo absoluto\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-absolute-time.png)


De forma predeterminada, la zona horaria para el panel de Información de rendimiento es el horario universal coordinado (UTC). También puede elegir la zona horaria local.

![\[Selección de la zona horaria local para el panel de Información de rendimiento\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-local-time-zone.png)


## Gráfico Counter metrics (Métricas de contador)
<a name="USER_PerfInsights.UsingDashboard.Components.Countermetrics"></a>

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. Las métricas predeterminadas dependen del motor de base de datos:
+ MySQL y MariaDB: – `db.SQL.Innodb_rows_read.avg`
+ Oracle – `db.User.user calls.avg`
+ Microsoft SQL Server – `db.Databases.Active Transactions(_Total).avg`
+ PostgreSQL – `db.Transactions.xact_commit.avg`

![\[Métricas de contador\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/oracle_perf_insights_counters.png)


Para cambiar los contadores de rendimiento, elija **Manage Metrics** (Administrar métricas). Puede seleccionar varias **métricas del sistema operativo** o **métricas de la base de datos**, 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.

![\[Filtrar métricas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_select_metrics.png)


Para obtener descripciones de las métricas de contador que puede agregar para cada motor de base de datos, consulte [Métricas de contador de Información de rendimiento](USER_PerfInsights_Counters.md).

## Gráfico Database load (Carga de base de datos)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions"></a>

El gráfico **Database load** (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. 

![\[Carga de base de datos\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_2.png)


### Carga de base de datos dividida por dimensiones
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.dims"></a>

Puede elegir ver la carga como sesiones activas agrupadas por cualquier dimensión admitida. En la tabla siguiente se muestran las dimensiones admitidas para los distintos motores.


| Dimensión | Oracle | SQL Server | PostgreSQL | MySQL | 
| --- | --- | --- | --- | --- | 
|  Host  |  Sí  |  Sí  |  Sí  |  Sí  | 
|  SQL  |  Sí  |  Sí  |  Sí  |  Sí  | 
|  Usuario  |  Sí  |  Sí  |  Sí  |  Sí  | 
|  Esperas  |  Sí  |  Sí  |  Sí  |  Sí  | 
|  Planes  |  Sí  |  No  |  No  |  No  | 
|  Aplicación  |  No  |  No  |  Sí  |  No  | 
|  Database  |  No  |  No  |  Sí  |  Sí  | 
|  Tipo de sesión  |  No  |  No  |  Sí  |  No  | 

En la imagen siguiente, se muestran las dimensiones de una instancia de base de datos de PostgreSQL.

![\[Filtrar métricas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_2b.png)


### Detalles de carga de base de datos de un elemento de dimensión
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.item-details"></a>

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

![\[Detalles del elemento de carga de base de datos\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_2c.png)


Para consultar los detalles de cualquier elemento para el periodo de tiempo seleccionado en la leyenda, coloque el cursor sobre ese elemento.

![\[Detalles del periodo de tiempo para la carga de la base de datos\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_3.png)


## Tabla de dimensiones principales
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable"></a>

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 SQL, **Top SQL (SQL principal)** muestra las instrucciones SQL que más contribuyen a la carga de bases de datos.

![\[Dimensiones N superiores\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_4c.png)


Elija cualquiera de las siguientes pestañas de dimensión.


| Tab | Descripción | Motores admitidos | 
| --- | --- | --- | 
|  SQL principal  |  Las instrucciones SQL que se están ejecutando  |  Todos  | 
|  Esperas principales  |  El evento por el que la base de datos de backend está esperando.  |  Todos  | 
|  Hosts principales  |  El nombre del host del cliente conectado.  |  Todos  | 
|  Usuarios principales  |  El usuario que ha iniciado sesión en la base de datos.  |  Todos  | 
|  Bases de datos principales  |  El nombre de la base de datos a la que está conectado el cliente.  |  PostgreSQL, MySQL, MariaDB y SQL Server solamente  | 
|  Aplicaciones principales  |  El nombre de la aplicación que está conectada a la base de datos.  |  PostgreSQL y SQL Server solamente  | 
|  Tipos de sesiones principales  |  El tipo de la sesión actual  | PostgreSQL únicamente | 

Para obtener más información sobre cómo analizar las consultas mediante la pestaña **Top SQL (SQL principal)**, consulte [Información general sobre la pestaña Top SQL (SQL principal)](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.md#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL).

# Acceso al panel Información de rendimiento
<a name="USER_PerfInsights.UsingDashboard.Opening"></a>

Amazon RDS ofrece una vista consolidada de las métricas de Información de rendimiento y CloudWatch en el panel Información de rendimiento.

Para acceder al panel Información de rendimiento, lleve a cabo el siguiente procedimiento.

**Para ver el panel de Performance Insights en la consola de administración de AWS**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación de la izquierda, seleccione **Performance Insights**.

1. Elija una instancia de base de datos.

   En instancias de base de datos con Información de rendimiento activado, también puede acceder al panel Información de rendimiento eligiendo el elemento **Sesiones** en la lista de instancias de bases 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 de base de datos está inactiva. Conforme aumenta la carga, la barra se va completando en azul. Cuando la carga supera el número de CPU virtuales (vCPU) en la clase de instancia de base de datos, la barra cambia a rojo, lo cual indica un posible cuello de botella.  
![\[Filtrar métricas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_0a.png)

1. (Opcional) Elija el intervalo de fecha o tiempo en la parte superior derecha y especifique un intervalo de tiempo relativo o absoluto diferente. Ahora puede especificar un período de tiempo y generar un informe de análisis del rendimiento de la base de datos. El informe proporciona información identificada y recomendaciones. Para obtener más información, consulte [Creación de un informe de análisis de rendimiento en Información de rendimiento](USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.md).  
![\[Filtrar métricas por intervalo de tiempo\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_0c.png)

   En la siguiente captura de pantalla, el intervalo de carga de la base de datos es de 5 horas.  
![\[Establecer el intervalo de tiempo en 5 horas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_1.png)

1. (Opcional) Para ampliar una parte del gráfico de carga de base de datos, elija la hora de inicio y arrástrela hasta el final del período que desee. 

   El área seleccionada se resalta en el gráfico de carga de base de datos.  
![\[Carga de base de datos para un intervalo de tiempo específico\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in.png)

   Cuando suelte el ratón, el gráfico de carga de base de datos ampliará la región de AWS seleccionada y se volverá a calcular la tabla de las **dimensiones *principales***.  
![\[Hacer zoom en la carga de base de datos seleccionada\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_zoom_in_b.png)

1. (Opcional) Para actualizar los datos automáticamente, habilite **Actualización automática**.  
![\[Establecer la actualización automática\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_1b.png)

   El panel de Información de rendimiento se actualiza automáticamente con nuevos datos. La frecuencia de actualización depende de la cantidad de datos mostrados: 
   + 5 minutos actualiza cada 10 segundos.
   + 1 hora actualiza cada 5 minutos.
   + 5 horas actualiza cada 5 minutos.
   + 24 horas actualiza cada 30 minutos.
   + 1 semana actualiza cada día.
   + 1 mes actualiza cada día.

# Análisis de carga de base de datos mediante eventos de espera
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad"></a>

Si el gráfico **Database load** (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 **Database load** (Carga de base de datos). Elija un elemento en particular, como una consulta SQL 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 de SQL es la vista predeterminada del panel de Performance Insights. Esta combinación normalmente ofrece la máxima información sobre problemas de desempeño. 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 **SQL** 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 **Database load** (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 **SQL** de la tabla de elementos de carga principales están contribuyendo más a esos estados de espera. Para identificarlas, utilice la columna **DB Load by Wait (Carga de base de datos por espera)**.

1. Elija una de estas consultas de resumen en la pestaña **SQL** para ampliarla y ver las consultas secundarias que contiene.

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. La espera de **todos los nodos de trabajo de LGWR** también es alta. El gráfico **Top SQL** (SQL principal) muestra lo que provoca las esperas de **sincronización de archivos de registro**: instrucciones `COMMIT` frecuentes. En este caso, confirmar con menos frecuencia reducirá la carga de la base de datos.

![\[errores de sincronización de archivos de registro\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_7.png)


# Análisis del rendimiento de la base de datos durante un período de tiempo
<a name="USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod"></a>

Analice el rendimiento de la base de datos con análisis bajo demanda mediante la creación de un informe de análisis de rendimiento durante un periodo de tiempo. Vea informes de análisis de rendimiento para detectar problemas de rendimiento, como cuellos de botella de recursos o cambios en una consulta en la instancia de base de datos. El panel de Información de rendimiento le permite seleccionar un período de tiempo específico y crear un informe de análisis de rendimiento. También puede añadir una o varias etiquetas al informe. 

Para utilizar esta característica, debe utilizar el período de retención del nivel de pago. Para obtener más información, consulte [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md)

Puede seleccionar y ver el informe en la pestaña **Informes de análisis de rendimiento: nuevo**. El informe contiene la información, las métricas relacionadas y las recomendaciones para resolver el problema de rendimiento. Puede ver el informe durante el período de retención de Información de rendimiento.

El informe se elimina si la hora de inicio del período de análisis del informe está fuera del período de retención. También puede eliminar el informe antes de que finalice el período de retención.

Para detectar los problemas de rendimiento y generar el informe de análisis para su instancia de base de datos, debe activar Información de rendimiento. Para obtener más información acerca de la activación de Información de rendimiento, consulte [Activación y desactivación de Información de rendimiento de Amazon RDS](USER_PerfInsights.Enabling.md). 

Para obtener información sobre la compatibilidad de esta característica por región, motor de base de datos y clase de instancia, consulte [Compatibilidad del motor de la base de datos, la región y la clase de instancia de Amazon RDS  con características de Información de rendimiento](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).

En las siguientes secciones, puede crear, ver y eliminar informes de análisis de rendimiento, así como añadir etiquetas.

**Topics**
+ [Creación de un informe de análisis de rendimiento en Información de rendimiento](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md)
+ [Visualización de un informe de análisis de rendimiento en Información de rendimiento](USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport.md)
+ [Cómo añadir etiquetas a un informe de análisis de rendimiento en Información de rendimiento](USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.md)
+ [Eliminación de un informe de análisis de rendimiento en Información de rendimiento](USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.md)

# Creación de un informe de análisis de rendimiento en Información de rendimiento
<a name="USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport"></a>

Puede crear un informe de análisis de rendimiento para un período específico en el panel de Información de rendimiento. Puede seleccionar un período de tiempo y añadir una o más etiquetas al informe de análisis.

El período de análisis puede oscilar entre 5 minutos y 6 días. Debe haber al menos 24 horas de datos de rendimiento antes de la hora de inicio del análisis.

Para obtener información sobre la compatibilidad de esta característica por región, motor de base de datos y clase de instancia, consulte [Compatibilidad del motor de la base de datos, la región y la clase de instancia de Amazon RDS  con características de Información de rendimiento](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).

**Para crear un informe de análisis de rendimiento para un período de tiempo**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación de la izquierda, seleccione **Performance Insights**.

1. Elija una instancia de base de datos. 

1. Elija **Analizar rendimiento** en la sección **Carga de base de datos** del panel de Información de rendimiento.

   Se muestran los campos para establecer el período de tiempo y añadir una o más etiquetas al informe de análisis de rendimiento.  
![\[Panel de Información de rendimiento que muestra los campos para crear un informe de análisis\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisReport.png)

1. Elija un período de tiempo. Si establece un período de tiempo en el **Intervalo relativo** o **Intervalo absoluto** en la esquina superior derecha, solo puede introducir o seleccionar la fecha y la hora del informe de análisis dentro de este período de tiempo. Si selecciona un período de análisis fuera de este período de tiempo, aparece un mensaje de error.

    Para establecer el período de tiempo, puede realizar una de las siguientes acciones:
   + Pulse y arrastre cualquiera de los controles deslizantes del gráfico de carga de la base de datos.

     El cuadro **Período de análisis de rendimiento** muestra el período de tiempo seleccionado y el gráfico de carga de la base de datos resalta el período de tiempo seleccionado.
   + Elija la **Fecha de inicio**, la **Hora de inicio**, la **Fecha de finalización** y la **Hora de finalización** en el cuadro **Período de análisis de rendimiento**.  
![\[Panel de Información de rendimiento con el período de análisis seleccionado\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_TimePeriod.png)

1. (Opcional) Introduzca la **Clave** y el **Valor-*opcional*** para añadir una etiqueta al informe.  
![\[Panel de Información de rendimiento con campos para añadir una nueva etiqueta\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_CreateAnalysisRep_AddTag.png)

1. Elija **Analizar rendimiento**.

   Un banner muestra un mensaje que indica si el informe se ha generado correctamente o no ha tenido éxito. El mensaje también proporciona el enlace para ver el informe.

   En el siguiente ejemplo, se muestra el banner con el mensaje de creación correcta del informe.  
![\[Banner de mensaje de creación correcta del informe de análisis\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_CreateAnaysisRep_SuccessMsg.png)

   Puede ver el informe en la pestaña **Informes de análisis de rendimiento: nuevo**. 

Puede crear un informe de análisis de rendimiento con la AWS CLI. Para ver un ejemplo sobre cómo crear un informe con la AWS CLI, consulte [Creación de un informe de análisis de rendimiento para un período de tiempo](USER_PerfInsights.API.Examples.md#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport).

# Visualización de un informe de análisis de rendimiento en Información de rendimiento
<a name="USER_PerfInsights.UsingDashboard.ViewPerfAnalysisReport"></a>

La pestaña **Informes de análisis de rendimiento: nuevo** muestra todos los informes que se crean para la instancia de base de datos. En cada informe, se muestra lo siguiente:
+ **ID**: identificador único del informe.
+ **Nombre**: clave de etiqueta añadida al informe.
+ **Tiempo de creación del informe**: hora en que creó el informe.
+ **Hora de inicio del análisis**: hora de inicio del análisis en el informe.
+ **Hora de finalización del análisis**: hora de finalización del análisis en el informe.

**Para ver un informe de análisis de rendimiento**

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

1. En el panel de navegación de la izquierda, seleccione **Performance Insights**.

1. Elija la instancia de base de datos para la que desee ver el informe de análisis. 

1. Desplácese hacia abajo y elija la pestaña **Informes de análisis de rendimiento: nuevo** en el panel de Información de rendimiento.

   Se muestran todos los informes de análisis de los diferentes períodos de tiempo.

1. Elija el **ID** del informe que desea ver.

   El gráfico de carga de la base de datos muestra todo el período de análisis de forma predeterminada si se identifica más de una información. Si el informe ha identificado una información, el gráfico de carga de la base de datos muestra la información de forma predeterminada. 

   El panel también muestra las etiquetas del informe en la sección **Etiquetas**.

   En el siguiente ejemplo se muestra todo el período de análisis del informe.  
![\[Gráfico de carga de base de datos que muestra todo el período del informe de análisis\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_EntireAnalysisRep.png)

1. Elija la información en la lista **Información de carga de la base de datos** que desee ver si se identifica más de una información en el informe.

   El panel muestra el mensaje de información, el gráfico de carga de la base de datos que destaca el período de tiempo de la información, los análisis, las recomendaciones y la lista de etiquetas del informe.

   En el siguiente ejemplo se muestra la información de carga de la base de datos en el informe.   
![\[Gráfico de carga de la base de datos que muestra información en el informe\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_chart.png)  
![\[Sección de recomendaciones y análisis de información del informe\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_AnalysisRepInsight_Recommendations.png)

# Cómo añadir etiquetas a un informe de análisis de rendimiento en Información de rendimiento
<a name="USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags"></a>

Puede añadir una etiqueta al crear o ver un informe. Puede añadir un máximo de 50 etiquetas a un informe.

Debe tener los permisos para añadir las etiquetas. Para obtener más información sobre las políticas de acceso para la Información de rendimiento, consulte [Configuración de directivas de acceso para información sobre rendimiento](USER_PerfInsights.access-control.md)

Para añadir una o más etiquetas al crear un informe, consulte el paso 6 del procedimiento [Creación de un informe de análisis de rendimiento en Información de rendimiento](USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.md).

**Para añadir una o más etiquetas al ver un informe**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación de la izquierda, seleccione **Performance Insights**.

1. Elija una instancia de base de datos. 

   Se muestra el panel de Información de rendimiento para la instancia de base de datos.

1. Desplácese hacia abajo y elija la pestaña **Informes de análisis de rendimiento: nuevo**.

1. Elija el informe al que desee añadir las etiquetas.

   El panel muestra el informe.

1. Desplácese hacia abajo hasta **Etiquetas** y elija **Administrar etiquetas**.

1. Elija **Añadir nueva etiqueta**.

1. Introduzca la **Clave** y el **Valor - *opcional***, y elija **Agregar nueva etiqueta**.

   En el ejemplo siguiente se ofrece la opción de añadir una etiqueta nueva en el informe seleccionado.  
![\[Ventana Administrar etiquetas para añadir nuevas etiquetas al informe\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_AddTag_ManageTags.png)

   Se crea una etiqueta nueva para el informe.

   La lista de etiquetas del informe se muestra en la sección **Etiquetas** del panel. Si desea eliminar una etiqueta del informe, elija **Eliminar** junto a la etiqueta.

# Eliminación de un informe de análisis de rendimiento en Información de rendimiento
<a name="USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport"></a>

Puede eliminar un informe de la lista de informes que se muestra en la pestaña **Informes de análisis de rendimiento** o mientras visualiza un informe. 

**Para eliminar un informe**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación de la izquierda, seleccione **Performance Insights**.

1. Elija una instancia de base de datos. 

   Se muestra el panel de Información de rendimiento para la instancia de base de datos.

1. Desplácese hacia abajo y elija la pestaña **Informes de análisis de rendimiento: nuevo**.

1. Seleccione el informe que quiera eliminar y elija **Eliminar** en la esquina superior derecha.  
![\[Panel de Información de rendimiento para eliminar con un informe seleccionado para su eliminación\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/PI_DeleteAnalysisRep.png)

   Aparece una ventana de confirmación. El informe se elimina después de que seleccione confirmar.

1. (Opcional) Elija el **ID** del informe que desea eliminar.

   En la página del informe, elija **Eliminar** en la esquina superior derecha.

   Aparece una ventana de confirmación. El informe se elimina después de que seleccione confirmar.

# Análisis de consultas con la pestaña Top SQL en Información de rendimiento
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics"></a>

En el panel de Performance Insights de Amazon RDS, puede encontrar información sobre las consultas recientes y en ejecución en la pestaña **Top SQL (SQL principal)** en la tabla **Top dimensions (Dimensiones principales)**. Puede utilizar esta información para ajustar sus consultas.

**Topics**
+ [Información general sobre la pestaña Top SQL (SQL principal)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL)
+ [Acceso a más texto SQL en el panel de Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md)
+ [Visualización de estadísticas de SQL en el panel de Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel.md)

## Información general sobre la pestaña Top SQL (SQL principal)
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL"></a>

De forma predeterminada, la pestaña **Top SQL** (SQL principal) muestra las 25 consultas que contribuyen a la carga de base de datos. Para ayudar a ajustar las consultas, puede analizar información como el texto de la consulta y las estadísticas de SQL. También puede elegir las estadísticas que quiere que aparezcan en la pestaña **Top SQL (SQL principal)**.

**Topics**
+ [Texto SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text)
+ [Estadísticas de SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics)
+ [Load by waits (AAS) (Carga por esperas [AAS])](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits)
+ [Ver información de SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information)
+ [Escoger preferencias de estadísticas](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences)

### Texto SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text"></a>

De forma predeterminada, cada fila de la tabla **Top SQL** (SQL principal) muestra 500 bytes de texto de ara cada instrucción. 

![\[Texto SQL\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/sql-text-oracle.png)


Para obtener información sobre cómo ver más de los 500 bytes predeterminados de texto SQL, consulte [Acceso a más texto SQL en el panel de Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md).

Un *resumen de SQL* 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 podría ser `SELECT * FROM emp WHERE lname= ?`. Este resumen podría incluir las siguientes consultas secundarias:

```
SELECT * FROM emp WHERE lname = 'Sanchez'
SELECT * FROM emp WHERE lname = 'Olagappan'
SELECT * FROM emp WHERE lname = 'Wu'
```

Para ver las instrucciones SQL literales de un resumen, seleccione la consulta y, a continuación, elija el símbolo más (\$1). En el siguiente ejemplo, la consulta seleccionada es un resumen.

![\[Resumen de SQL seleccionado\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_4b.png)


**nota**  
Un resumen de SQL agrupa instrucciones SQL similares, pero no redacta información confidencial.

Performance Insights puede mostrar el texto de Oracle SQL como **Unknown (Desconocido)**. El texto tiene este estado en las siguientes situaciones:
+ Un usuario de base de datos de Oracle distinto de `SYS` está activo pero no ejecuta SQL actualmente. Por ejemplo, cuando se completa una consulta paralela, el coordinador de consultas espera a que los procesos auxiliares envíen sus estadísticas de sesión. Durante la espera, el texto de la consulta muestra **Unknown (Desconocido)**.
+ Para una instancia de RDS para Oracle en Standard Edition 2, el Administrador de recursos de Oracle limita el número de subprocesos paralelos. El proceso en segundo plano que realiza este trabajo hace que el texto de la consulta se muestre como **Unknown (Desconocido)**.

### Estadísticas de SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics"></a>

Las *estadísticas de SQL* son métricas relacionadas con el rendimiento de las consultas SQL. Por ejemplo, Performance Insights podría mostrar ejecuciones por segundo o filas procesadas por segundo. Performance Insights recopila estadísticas solo para las consultas más comunes. Normalmente, coinciden con las consultas principales por carga mostradas en el panel de Performance Insights. 

Todas las líneas de la tabla **Top SQL (SQL principal)** muestra estadísticas relevantes de la instrucción o resumen de SQL, como se muestra en el ejemplo siguiente.

![\[SQL principal\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_4.png)


Performance Insights puede informar `0.00` y `-` (desconocido) para las estadísticas de SQL. Esta situación se produce en las siguientes condiciones:
+ Solo existe una muestra. Por ejemplo, Performance Insights calcula las tasas de cambio para las consultas de RDS PostgreSQL basadas en varios ejemplos de la vista `pg_stat_statements`. Cuando una carga de trabajo se ejecuta durante un breve período de tiempo, es posible que Performance Insights solo recopile una muestra, lo que significa que no puede calcular una tasa de cambio. El valor desconocido se representa con un guion (`-`).
+ Dos muestras tienen los mismos valores. Performance Insights no puede calcular una tasa de cambio porque no se ha producido ningún cambio, por lo que informa la tasa como `0.00`.
+ Una instrucción de RDS PostgreSQL carece de identificador válido. PostgreSQL crea un identificador para una instrucción solo después de analizar. Por lo tanto, puede existir una instrucción en las estructuras internas en memoria de PostgreSQL sin identificador. Dado que Performance Insights realiza muestras de estructuras internas en memoria una vez por segundo, pueden aparecer consultas de baja latencia para una sola muestra. Si el identificador de consulta no está disponible para esta muestra, Performance Insights no puede asociar esta instrucción a sus estadísticas. El valor desconocido se representa con un guion (`-`).

Para obtener una descripción de las estadísticas de SQL de los motores de Amazon RDS, consulte [Estadísticas de SQL para Performance Insights](sql-statistics.md).

### Load by waits (AAS) (Carga por esperas [AAS])
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits"></a>

En **Top SQL** (SQL principal), la columna **Load by waits (AAS)** (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**. Para obtener más información acerca de las sesiones activas de Average (AAS), consulte [Sesiones activas promedio](USER_PerfInsights.Overview.ActiveSessions.md#USER_PerfInsights.Overview.ActiveSessions.AAS).

Por ejemplo, es posible que pueda agrupar el gráfico **DB load** (Carga de base de datos) por estados de espera. Puede examinar consultas SQL en la tabla de elementos de carga principal. 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.

![\[Carga de base de datos por esperas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_6.png)


### Ver información de SQL
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information"></a>

En la tabla **Top SQL** (SQL principal), puede abrir una instrucción para consultar su información. La información aparece en el panel inferior.

![\[Tabla SQL principal con consulta literal seleccionada\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-open.png)


Los siguientes tipos de identificadores (ID) asociados con instrucciones SQL:
+ **Support SQL ID (Compatibilidad con ID SQL)**: un valor hash del ID de SQL. Este valor sirve solo para hacer referencia a un ID de SQL al trabajar con AWS Support. AWS Support no tiene acceso a sus ID de SQL y texto SQL reales.
+ **Support Digest ID (Compatibilidad con ID de resumen)**: un valor hash del ID de resumen. Este valor sirve solo para hacer referencia a un ID de resumen al trabajar con AWS Support. AWS Support no tiene acceso a sus ID de resumen y texto SQL reales.

### Escoger preferencias de estadísticas
<a name="USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences"></a>

Para controlar las estadísticas mostradas en la pestaña **Top SQL** (SQL principal), puede elegir el icono **Preferences (Preferencias)**.

![\[Preferencias de estadísticas\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences-icon.png)


Al seleccionar el icono **Preferences (Preferencias)**, se abrirá la ventana **Preferences (Preferencias)**. La siguiente captura de pantalla es un ejemplo de la ventana **Preferences** (Preferencias).

![\[Ventana Preferencias\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences.png)


Para habilitar las estadísticas que desea que estén visibles en la pestaña **Top SQL (SQL principal)**, utilice el ratón para desplazarse hasta la parte inferior de la ventana y, a continuación, elija **Continue (Continuar)**. 

Para obtener más información sobre las estadísticas por segundo o por llamada de los motores Amazon RDS, consulte la sección de estadísticas SQL específicas del motor en [Estadísticas de SQL para Performance Insights](sql-statistics.md).

# Acceso a más texto SQL en el panel de Performance Insights
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

De forma predeterminada, cada fila de la tabla **Top SQL (SQL principal)** muestra 500 bytes de texto SQL para cada instrucción SQL.

![\[500 bytes de SQL\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


Cuando una instrucción SQL supera los 500 bytes, puede ver más texto en la sección **SQL text (Texto SQL)**, bajo la tabla **Top SQL (SQL principal)**. En este caso, la longitud máxima del texto que se muestra **SQL text (Texto SQL)** es de 4 KB. Este límite lo introduce la consola y está sujeto a los límites establecidos por el motor de base de datos. Para guardar el texto que se muestra en **SQL text (Texto SQL)**, elija **Download (Descargar)**.

**Topics**
+ [Límites de tamaño del texto para los motores de Amazon RDS](#sql-text-engine-limits)
+ [Ajuste del limite de texto SQL para las instancias de base de datos de Amazon RDS for PostgreSQL](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [Ver y descargar texto SQL en el panel de Performance Insights](view-download-text.md)

## Límites de tamaño del texto para los motores de Amazon RDS
<a name="sql-text-engine-limits"></a>

Cuando se descarga un texto SQL, el motor de la base de datos determina su longitud máxima. Puede descargar texto SQL hasta los siguientes límites por motor:


| Motor de base de datos | Longitud máxima del texto descargado | 
| --- | --- | 
| Amazon RDS para MySQL y MariaDB | La longitud se fija en 4096 bytes cuando se habilita Performance Schema. Si Performance Schema no está habilitado, la longitud se fija en 65 535 bytes. | 
| Amazon RDS for Microsoft SQL Server | 4,096 caracteres | 
| Amazon RDS para Oracle | 1000 bytes | 

En la sección **SQL text (Texto SQL)** de la consola de Performance Insights, se muestra el máximo que devuelve el motor. Por ejemplo, si MySQL devuelve como máximo 1 kB a Performance Insights, solo puede recopilar y mostrar 1 kB, incluso si la consulta original es de mayor longitud. Así, cuando se visualiza la consulta en **SQL text (Texto SQL)** o se descarga, Performance Insights devuelve el mismo número de bytes.

Si utiliza la AWS CLI o la API, Información de rendimiento no tiene el límite de 4 KB aplicado por la consola. `DescribeDimensionKeys` y `GetResourceMetrics` devuelven como máximo 500 bytes. 

**nota**  
`GetDimensionKeyDetails` devuelve la consulta completa, pero el tamaño está sujeto al límite del motor.

# Ajuste del limite de texto SQL para las instancias de base de datos de Amazon RDS for PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.SQLTextLimit"></a>

Amazon RDS for PostgreSQL maneja el texto de manera diferente. Puede establecer el límite de tamaño del texto con el parámetro de instancia de base de datos `track_activity_query_size`. Este parámetro incluye las siguientes características:

Tamaño de texto predeterminado  
En la versión 9.6 de Amazon RDS for PostgreSQL, la configuración predeterminada del parámetro `track_activity_query_size` es de 1024 bytes. En la versión 10 o superior de Amazon RDS for PostgreSQL, la configuración predeterminada del parámetro es de 4096 bytes.

Tamaño máximo del texto  
El límite de `track_activity_query_size` para la versión 12 o inferior de Amazon RDS for PostgreSQL es de 102 400 bytes. El máximo es de 1 MB para la versión 13 y superior.   
Si el motor devuelve 1 MB a Performance Insights, la consola muestra solo los primeros 4 kB. Si descarga la consulta, obtendrá 1 MB completo. En este caso, la visualización y la descarga devuelven diferentes cantidades de bytes. Para obtener más información sobre el parámetro de instancia de base de datos `track_activity_query_size`, consulte [Run-time Statistics (Estadísticas de tiempo de ejecución)](https://www.postgresql.org/docs/current/runtime-config-statistics.html) en la documentación de PostgreSQL.

Para aumentar el tamaño del texto SQL, aumente el límite de `track_activity_query_size`. Para modificar el parámetro, cambie el ajuste en el grupo de parámetros asociado a la instancia de base de datos de Amazon RDS for PostgreSQL.

**Para cambiar la configuración cuando la instancia utiliza el grupo de parámetros predeterminado**

1. Cree un nuevo grupo de parámetros de instancia de base de datos para el motor de base de datos y la versión del motor de base de datos adecuados.

1. Establezca el parámetro en el nuevo grupo de parámetros.

1. Asocie el nuevo grupo de parámetros a la instancia de base de datos.

Para obtener más información sobre configurar un parámetro de instancia de base de datos, consulte [Modificación de los parámetros de un grupo de parámetros de base de datos en Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).

# Ver y descargar texto SQL en el panel de Performance Insights
<a name="view-download-text"></a>

Puede ver o descargar texto SQL en el panel de Performance Insights.

**Para ver más texto SQL en el panel de Performance Insights**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación, seleccione **Performance Insights**.

1. Elija una instancia de base de datos.

1. Baje hasta la pestaña **Top SQL** en el panel de Información de rendimiento.

1. Elija el signo más para expandir un resumen de SQL y elija una de las consultas secundarias del resumen.

   Las instrucciones SQL con texto superior a 500 bytes son similares a las que se indican en la siguiente imagen.  
![\[Instrucciones SQL con texto grande\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. Desplácese hasta la pestaña **SQL text** (Texto SQL).  
![\[La sección de información SQL muestra más texto SQL\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   El panel de Performance Insights puede mostrar hasta 4096 bytes por cada instrucción SQL.

1. (Opcional) Elija **Copiar** para copiar la instrucción SQL mostrada o elija **Descargar** para descargar la instrucción SQL para consultar el texto SQL hasta el límite del motor de base de datos.
**nota**  
Para copiar o descargar la instrucción SQL, deshabilite los bloqueadores de pantallas emergentes. 

# Visualización de estadísticas de SQL en el panel de Performance Insights
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel"></a>

En el panel de Performance Insights, las estadísticas de SQL están disponibles en la pestaña **Top SQL (SQL principal)** del gráfico **Database load (Carga de base de datos)**.

**Para ver las estadísticas de SQL**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación de la izquierda, seleccione **Performance Insights**.

1. En la parte superior de la página, elija la base de datos cuyas estadísticas de SQL desea ver.

1. Desplácese a la parte inferior de la página y seleccione **Top SQL (SQL principal)**.

1. Elija una instrucción individual o consulte el resumen.  
![\[Ver métricas de consultas en ejecución\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_sql.png)

1. Seleccione qué estadísticas mostrar seleccionando el icono de engranaje de la esquina superior derecha del gráfico. Para obtener descripciones de las estadísticas de SQL de los motores de Amazon RDS, consulte [Estadísticas de SQL para Performance Insights](sql-statistics.md).

   El siguiente ejemplo muestra las preferencias para las instancias de base de datos de Oracle.  
![\[Preferencias de métricas para las consultas en ejecución para las instancias de base de datos de Oracle.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_oracle.png)

   El siguiente ejemplo muestra las preferencias para las instancias de base de datos de MariaDB y MySQL.  
![\[Preferencias de métricas para consultas en ejecución para instancias de base de datos de MariaDB y MySQL.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_ams.png)

1. Elija Save (Guardar) para guardar las preferencias.

   Se actualiza la tabla **Top SQL (SQL principal)**.

   En el siguiente ejemplo se muestran las estadísticas de una consulta SQL de Oracle.  
![\[Estadísticas de una consulta SQL\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_stats_oracle.png)

# Análisis de la carga de PDB principal de Oracle
<a name="USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.TopPDB"></a>

Al analizar la carga en una base de datos de contenedor de Oracle (CDB), es posible que quiera identificar qué bases de datos conectables (PDB) contribuyen más a la carga de la base de datos. También puede comparar el rendimiento de PDB individuales que ejecutan consultas similares para ajustar el rendimiento. Para obtener más información acerca de las CDB de Oracle, consulte [Arquitectura de base de datos de RDS para Oracle](oracle-multi-architecture.md).

En el panel de Información sobre rendimiento de Amazon RDS, puede encontrar información sobre las bases de datos conectables (PDB) en la pestaña **PDB principal** en la pestaña **Dimensiones**.

Para obtener información sobre la compatibilidad de esta característica por región, motor de base de datos y clase de instancia, consulte [Compatibilidad del motor de la base de datos, la región y la clase de instancia de Amazon RDS  con características de Información de rendimiento](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport).

**Análisis de la carga de PDB principal en una CDB de Oracle**

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

1. En el panel de navegación de la izquierda, seleccione **Información sobre rendimiento**.

1. Elija una instancia CDB de Oracle.

   Se muestra el panel de Información de rendimiento para la instancia de base de datos.

1. En la sección **Carga de base de datos**, elija **Pluggable database (PDB)** junto a Segmentar por.

   El gráfico de sesiones activas promedio muestra la PDB con la carga más alta. Los identificadores de PDB aparecen a la derecha de los cuadrados codificados por colores. Cada identificador identifica de forma única una PDB.  
![\[Gráfico de sesiones activas promedio de carga de PDB\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_AAS.png)

1. Desplácese hasta la pestaña **SQL principal**.

   En el siguiente ejemplo, puede ver la misma consulta SQL y la carga que genera en varias PDB.  
![\[La misma carga de consultas SQL para varias PDB\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex1.png)

   En el siguiente ejemplo, una sola PDB gestiona una carga superior a otras PDB de la CDB.  
![\[Alta carga de consultas SQL para PDB\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf_insights_topPDB_ex2.png)

   Para obtener más información acerca de las CDB de Oracle, consulte [CDB y PDB](https://docs.oracle.com/en/database/oracle/oracle-database/21/cncpt/CDBs-and-PDBs.html#GUID-FC2EB562-ED31-49EF-8707-C766B6FE66B8).

# Análisis de planes de ejecución mediante el panel de Información de rendimiento para Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans"></a>

En el panel de Información de rendimiento de Amazon RDS, puede encontrar información sobre los planes de ejecución para las instancias de base de datos de Oracle y SQL Server. Puede utilizar esta información para saber qué planes contribuyen más a la carga de la base de datos.

Para analizar planes de ejecución de Oracle o SQL Server, consulte los siguientes temas.

**Análisis de planes de ejecución**
+ [Análisis de planes de ejecución de Oracle mediante el panel de Información de rendimiento para Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlans.md)
+ [Análisis de planes de ejecución de SQL Server mediante el panel de Información de rendimiento para Amazon RDS](USER_PerfInsights.UsingDashboard.AccessPlansSqlServer.md)

## Descripción general del análisis de los planes de ejecución para Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AnalyzingPlans.Overview"></a>

Puede utilizar el panel de Información de rendimiento de Amazon RDS para saber qué planes contribuyen más a la carga de bases de datos de las instancias de base de datos de Oracle y SQL Server. 

 Por ejemplo, las principales instrucciones SQL en un momento dado podrían estar utilizando los planes que se muestran en la siguiente tabla.


****  

| SQL principal | Plan | 
| --- | --- | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 10  |  Plan A  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 521  |  Plan B  | 
|  SELECT SUM(s\$1total) FROM sales WHERE region = 10  |  Plan A  | 
|  SELECT \$1 FROM emp WHERE emp\$1id = 1000  |  Plan C  | 
|  SELECT SUM(amount\$1sold) FROM sales WHERE prod\$1id = 72  |  Plan A  | 

Con la característica de planificación de Performance Insights, puede hacer lo siguiente:
+ Encuentre qué planes utilizan las principales consultas SQL. 

  Por ejemplo, podría hallar que la mayor parte de la carga de la base de datos se genera mediante consultas que utilizan el plan A y el plan B, y solo un pequeño porcentaje utiliza el plan C.
+ Compare distintos planes para la misma consulta. 

  En el ejemplo anterior, tres consultas son idénticas, excepto el ID del producto. Dos consultas utilizan el plan A, pero una consulta utiliza el plan B. Para ver la diferencia en los dos planes, puede utilizar Performance Insights.
+ Busque cuándo una consulta cambió a un nuevo plan. 

  Es posible que vea que una consulta utiliza el plan A y, luego, cambió al plan B en un momento determinado. ¿Hubo algún cambio en la base de datos en ese momento? Por ejemplo, si una tabla está vacía, el optimizador podría elegir un análisis de tabla completo. Si la tabla se carga con un millón de filas, el optimizador podría cambiar a un análisis de rango de índices.
+ Explore a fondo los pasos específicos de un plan con el mayor costo.

  Por ejemplo, para una consulta de larga duración podría mostrar una condición de unión que falta en una combinación de igualdad. Esta condición faltante fuerza una unión cartesiana, que une todas las filas de dos tablas.

Puede hacer las tareas anteriores mediante la característica Captura de planes de Performance Insights. Del mismo modo que puede dividir las consultas de mediante eventos de espera y SQL principal, puede dividirlas por la dimensión del plan.

# Análisis de planes de ejecución de Oracle mediante el panel de Información de rendimiento para Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlans"></a>

Al analizar la carga de base de datos en una base de datos de Oracle, es posible que quiera saber qué planes contribuyen más a la carga de la base de datos. Puede determinar qué planes contribuyen más a la carga de base de datos mediante la característica de captura de planes de Información de rendimiento. 

**Para analizar los planes de ejecución de Oracle mediante la consola**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación, seleccione **Información de rendimiento**.

1. Elija una instancia base de datos de Oracle. Se abre el panel de Información sobre rendimiento para esa instancia de base de datos.

1. En la sección **Database load (DB load)** (Carga de base de datos), elija **Plans** (Planes) junto a **Slice by** (Dividir por).

   El gráfico de sesiones activas promedio muestra los planes utilizados por las instrucciones SQL principales. Los valores hash del plan aparecen a la derecha de los cuadrados codificados por colores. Cada valor hash identifica de forma exclusiva un plan.  
![\[Divida por planes\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans.png)

1. Desplácese hasta la pestaña **Top SQL** (SQL principal).

   En el siguiente ejemplo, el resumen de SQL principal tiene dos planes. Puede notar que es un resumen según el signo de interrogación de la instrucción.   
![\[Elija un plan de resumen\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected.png)

1. Elija el resumen para expandirlo a sus instrucciones de componentes.

   En el siguiente ejemplo, la instrucción `SELECT` es una consulta de resumen. Las consultas de componentes del resumen utilizan dos plan diferentes. Los colores de los planes corresponden al gráfico de la carga de la base de datos. El número total de planes del resumen se muestra en la segunda columna.  
![\[Elija un plan de resumen\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-digest-plan.png)

1. Desplácese hacia abajo y elija dos **Planes** que comparar de la lista **Plans for digest query** (Planes para consulta de resumen).

   Puede ver uno o dos planes para una consulta a la vez. La siguiente captura de pantalla compara los dos planes del resumen, con el hash 2032253151 y el hash 1117438016. En el siguiente ejemplo, el 62 % de las sesiones activas promedio que ejecutan esta consulta de resumen utilizan el plan de la izquierda, mientras que el 38 % utiliza el plan de la derecha.  
![\[Compare los planes uno al lado del otro\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-compare-plan.png)

   En este ejemplo, los planes difieren de una manera importante. El paso 2 del plan 2032253151 utiliza un análisis de índice, mientras que el plan 1117438016 utiliza un análisis de tabla completo. Para una tabla con un gran número de filas, una consulta de una sola fila es casi siempre más rápida con un escaneo de índices.  
![\[Compare los planes uno al lado del otro\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-table-access.png)

1. (Opcional) Elija **Copy (Copia)** para copiar el plan en el portapapeles, o **Download (Descargar)** para guardar el plan en el disco duro. 

# Análisis de planes de ejecución de SQL Server mediante el panel de Información de rendimiento para Amazon RDS
<a name="USER_PerfInsights.UsingDashboard.AccessPlansSqlServer"></a>

Al analizar la carga de base de datos en una base de datos de SQL Server, es posible que quiera saber qué planes contribuyen más a la carga de la base de datos. Puede determinar qué planes contribuyen más a la carga de base de datos mediante la característica de captura de planes de Información de rendimiento. 

**Análisis de los planes de ejecución de SQL Server mediante la consola**

1. Abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación, seleccione **Información de rendimiento**.

1. Elija una instancia de base de datos SQL Server. Se abre el panel de Información sobre rendimiento para esa instancia de base de datos.

1. En la sección **Database load (DB load)** (Carga de base de datos), elija **Plans** (Planes) junto a **Slice by** (Dividir por).

   El gráfico de sesiones activas promedio muestra los planes utilizados por las instrucciones SQL principales. Los valores hash del plan aparecen a la derecha de los cuadrados codificados por colores. Cada valor hash identifica de forma exclusiva un plan.  
![\[Divida por planes\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-slice-by-plans-sqlserver.png)

1. Desplácese hasta la pestaña **Top SQL** (SQL principal).

   En el siguiente ejemplo, el resumen de SQL principal tiene tres planes. La presencia de un signo de interrogación en la instrucción de SQL indica que se trata de un resumen. Para ver la instrucción de SQL completa, elija un valor en la columna **Instrucciones de SQL**.  
![\[Elija un plan de resumen\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/top-sql-plans-unselected-sqlserver.png)

1. Elija el resumen para expandirlo a sus instrucciones de componentes.

   En el siguiente ejemplo, la instrucción `SELECT` es una consulta de resumen. Las consultas de componentes del resumen utilizan tres planes de ejecución diferentes. Los colores asignados a los planes corresponden al gráfico de la carga de la base de datos.  
![\[Elija un plan de resumen\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-digest-plan-sqlserver.png)

1. Desplácese hacia abajo y elija dos **Planes** que comparar de la lista **Plans for digest query** (Planes para consulta de resumen).

   Puede ver uno o dos planes para una consulta a la vez. La siguiente captura de pantalla compara los dos planes del resumen. En el siguiente ejemplo, el 40 % de las sesiones activas promedio que ejecutan esta consulta de resumen utilizan el plan de la izquierda, mientras que el 28 % utiliza el plan de la derecha.  
![\[Compare los planes uno al lado del otro\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-compare-plan-sqlserver.png)

   En el ejemplo anterior, los planes difieren de una manera importante. El paso 2 del plan de la izquierda usa un análisis de tablas, mientras que el plan de la derecha usa un análisis de índices agrupados. Para una tabla con un gran número de filas, una consulta que recupera una sola fila es casi siempre más rápida con un análisis de índices agrupados.

1. (Opcional) Seleccione el icono **Configuración** en la tabla de detalles del plan para personalizar la visibilidad y el orden de las columnas. La siguiente captura de pantalla muestra la tabla de detalles del plan con la columna **Lista de resultados** como segunda columna.  
![\[Personalice la visibilidad y el orden de las columnas en la tabla de detalles del plan\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/pi-plan-fields-sql-server.png)

1. (Opcional) Elija **Copy (Copia)** para copiar el plan en el portapapeles, o **Download (Descargar)** para guardar el plan en el disco duro. 

**nota**  
Información de rendimiento muestra los planes de ejecución estimados mediante una tabla de árbol jerárquico. La tabla incluye la información de ejecución parcial de cada instrucción. Para obtener más información sobre las columnas de la tabla de detalles del plan, consulte [SET SHOWPLAN\$1ALL](https://learn.microsoft.com/en-us/sql/t-sql/statements/set-showplan-all-transact-sql) en la documentación de SQL Server. Para ver la información de ejecución completa de un plan de ejecución estimado, seleccione **Descargar** para descargar el plan y, a continuación, cárguelo en SQL Server Management Studio. Para obtener más información sobre cómo mostrar un plan de ejecución estimado con SQL Server Management Studio, consulte [Display an Estimated Execution Plan](https://learn.microsoft.com/en-us/sql/relational-databases/performance/display-the-estimated-execution-plan) en la documentación de SQL Server. 

# Visualización de las recomendaciones proactivas de Información de rendimiento
<a name="USER_PerfInsights.InsightsRecommendationViewDetails"></a>

Información de rendimiento de Amazon RDS monitoriza automáticamente métricas específicas y crea umbrales. Para ello, analiza qué niveles podrían ser potencialmente problemáticos para un recurso específico. Cuando los nuevos valores de las métricas cruzan un umbral predefinido durante un período de tiempo determinado, Información de rendimiento genera una recomendación proactiva. Esta recomendación ayuda a evitar que el rendimiento de la base de datos se vea afectado en el futuro. Para recibir estas recomendaciones proactivas, debe activar Información de rendimiento con un período de retención de nivel de pago.

Para obtener más información acerca de la activación de Información de rendimiento, consulte [Activación y desactivación de Información de rendimiento de Amazon RDS](USER_PerfInsights.Enabling.md). Para obtener información sobre los precios y la retención de datos de Información de rendimiento, consulte [Precios y retención de datos de Performance Insights](USER_PerfInsights.Overview.cost.md).

Para obtener información sobre las regiones, los motores de bases de datos y las clases de instancias compatibles con las recomendaciones proactivas, consulte [Compatibilidad del motor de la base de datos, la región y la clase de instancia de Amazon RDS  con características de Información de rendimiento](USER_PerfInsights.Overview.Engines.md#USER_PerfInsights.Overview.PIfeatureEngnRegSupport). 

Puede ver el análisis detallado y las investigaciones recomendadas de las recomendaciones proactivas en la página de detalles de las recomendaciones.

Para obtener más información sobre recomendaciones, consulte [Recomendaciones para Amazon RDS](monitoring-recommendations.md).

**Para ver el análisis detallado de una recomendación proactiva**

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

1. En el panel de navegación, realice cualquiera de las siguientes acciones:
   + Elija **Recomendaciones**.

     En la página **Recomendaciones**, se muestra una lista de recomendaciones ordenadas por su gravedad para todos los recursos de su cuenta.
   + Elija **Bases de datos** y, a continuación, elija **Recomendaciones** para un recurso en la página de bases de datos.

     La pestaña **Recomendaciones** muestra las recomendaciones y sus detalles para el recurso seleccionado.

1. Busque una recomendación proactiva y elija **Ver detalles**.

   Aparece la página de detalles de la recomendación. En el título se proporciona el nombre del recurso afectado con el problema detectado y su gravedad.

   A continuación figuran los componentes de la página de detalles de la recomendación:
   + **Resumen de la recomendación**: el problema detectado, el estado de la recomendación y el problema, la hora de inicio y finalización del problema, la hora de modificación de la recomendación y el tipo de motor.  
![\[Página de detalles de la recomendación proactiva que muestra la sección de resumen de recomendaciones en la consola.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/RecommendationProactive-RecSummary.png)
   + **Métricas**: los gráficos del problema detectado. Cada gráfico muestra un umbral determinado por el comportamiento de referencia del recurso, así como los datos de la métrica informados desde el momento de inicio de la anomalía.  
![\[Página de detalles de la recomendación proactiva que muestra la sección de métricas en la consola.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/RecommedationProactive_Metrics.png)
   + **Análisis y recomendaciones**: la recomendación y el motivo de la recomendación sugerida.  
![\[Página de detalles de la recomendación proactiva que muestra la sección de análisis y recomendaciones en la consola.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/ProactiveRecommendation-AnalysisAndRec.png)

   Puede revisar la causa del problema y, a continuación, realizar las acciones recomendadas para solucionarlo o seleccionar **Descartar** en la esquina superior derecha para descartar la recomendación.

# Recuperación de métricas con la API de Información sobre rendimiento para Amazon RDS
<a name="USER_PerfInsights.API"></a>

Cuando se activa la Información de rendimiento, la API proporciona visibilidad sobre el rendimiento de la instancia. registros de Amazon Cloudwatch proporciona la fuente autorizada de las métricas de monitoreo vendidas para servicios de 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 `SQL`, `Wait-event`, `User` o `Host`, medidas en ese punto temporal.

La información sobre rendimiento de Amazon RDS monitorea el clúster de instancia de base de datos de Amazon RDS para poder analizar y solucionar los problemas de desempeño de la base de datos. Una forma de ver los datos de Performance Insights 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
+ Crear herramientas de monitoreo.

Para utilizar la API de Performance Insights, habilite Performance Insights en una de sus instancias de base de datos de Amazon RDS. Para obtener información sobre la habilitación de Performance Insights, consulte [Activación y desactivación de Información de rendimiento de Amazon RDS](USER_PerfInsights.Enabling.md). Para obtener información sobre la API de Performance Insights, consulte la [Referencia de la API de Performance Insights de Amazon RDS](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 command  |  Descripción  | 
| --- | --- | --- | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/CreatePerformanceAnalysisReport.html)  |  Crea un informe de análisis de rendimiento para un período de tiempo específico para la instancia de base de datos. El resultado es `AnalysisReportId` que es el identificador único del informe.  | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/DeletePerformanceAnalysisReport.html)  |  Elimina un informe de análisis de rendimiento.  | 
|  [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 SQL y si los detalles de la dimensión están disponibles, `GetDimensionKeyDetails` recupera el texto completo de la dimensión `db.sql.statement` asociada a este ID. Esta operación resulta útil porque `GetResourceMetrics` y `DescribeDimensionKeys` no admiten la recuperación de texto de instrucción SQL grande.   | 
|  [https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html)  |  [https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html](https://docs.aws.amazon.com/cli/latest/reference/pi/GetPerformanceAnalysisReport.html)  |  Recupera el informe, incluidos los datos del informe. El resultado incluye el estado del informe, el identificador del informe, los detalles del tiempo del informe, la información y las recomendaciones.  | 
| [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.  | 
|  `[ListPerformanceAnalysisReports](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReports.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-performance-analysis-reports.html)  | Recupera todos los informes de análisis disponibles para la instancia de base de datos. Los informes se enumeran en función de la hora de inicio de cada informe. | 
|  `[ListTagsForResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListTagsForResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/list-tags-for-resource.html)  |  Muestra todas las etiquetas de metadatos agregadas al recurso. La lista incluye el nombre y el valor de la etiqueta.  | 
|  `[TagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_TagResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/tag-resource.html)  |  Añade etiquetas de metadatos a un recurso de Amazon RDS. La etiqueta incluye un nombre y un valor.  | 
|  `[UntagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_UntagResource.html)` |  [https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/pi/untag-resource.html)  |  Elimina la etiqueta de metadatos del recurso.  | 

Para obtener más información sobre la recuperación de métricas de series temporales y ver ejemplos de la AWS CLI para Información de rendimiento, consulte los siguientes temas.

**Topics**
+ [Recuperación de métricas de series temporales para Información de rendimiento](USER_PerfInsights.API.TimeSeries.md)
+ [Ejemplos de la AWS CLI para Performance Insights](USER_PerfInsights.API.Examples.md)

# Recuperación de métricas de series temporales para Información de rendimiento
<a name="USER_PerfInsights.API.TimeSeries"></a>

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, la Consola de administración de AWS usa `GetResourceMetrics` para completar el gráfico **Counter Metrics (Métricas de contador)** y el gráfico **Database Load (Carga de la base de datos)**, como se muestra en la siguiente imagen.

![\[Gráficos Counter Metrics y Database Load\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/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 de Información de rendimiento](USER_PerfInsights_Counters.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 acerca del uso del comando `get-resource-metrics` de la AWS CLI, 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"
     ...}
```

# Ejemplos de la AWS CLI para Performance Insights
<a name="USER_PerfInsights.API.Examples"></a>

En las siguientes secciones, obtendrá más información sobre AWS Command Line Interface (AWS CLI) para Información de rendimiento, así como ejemplos de uso de la AWS CLI.

**Topics**
+ [Ayuda integrada en la AWS CLI para Información de rendimiento](#USER_PerfInsights.API.CLI)
+ [Recuperación de métricas de contador](#USER_PerfInsights.API.Examples.CounterMetrics)
+ [Recuperación del promedio de carga de base de datos para los eventos de espera principales](#USER_PerfInsights.API.Examples.DBLoadAverage)
+ [Recuperación del promedio de carga de base de datos para las instrucciones SQL principales](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL)
+ [Recuperación del promedio de carga de base de datos filtrado por SQL](#USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL)
+ [Recuperación del texto completo de una instrucción SQL](#USER_PerfInsights.API.Examples.GetDimensionKeyDetails)
+ [Creación de un informe de análisis de rendimiento para un período de tiempo](#USER_PerfInsights.API.Examples.CreatePerfAnalysisReport)
+ [Recuperación de un informe de análisis de rendimiento](#USER_PerfInsights.API.Examples.GetPerfAnalysisReport)
+ [Enumeración de todos los informes de análisis de rendimiento de la instancia de base de datos](#USER_PerfInsights.API.Examples.ListPerfAnalysisReports)
+ [Eliminación de un informe de análisis de rendimiento](#USER_PerfInsights.API.Examples.DeletePerfAnalysisReport)
+ [Adición de una etiqueta a un informe de análisis de rendimiento](#USER_PerfInsights.API.Examples.TagPerfAnalysisReport)
+ [Enumeración de todas las etiquetas de un informe de análisis de rendimiento](#USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport)
+ [Eliminación de etiquetas de un informe de análisis de rendimiento](#USER_PerfInsights.API.Examples.UntagPerfAnalysisReport)

## Ayuda integrada en la AWS CLI para Información de rendimiento
<a name="USER_PerfInsights.API.CLI"></a>

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 tiene instalada la AWS CLI, consulte [Instalación de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) en la *Guía del usuario de la AWS CLI* para obtener información sobre cómo instalarla.

## Recuperación de métricas de contador
<a name="USER_PerfInsights.API.Examples.CounterMetrics"></a>

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/AmazonRDS/latest/UserGuide/images/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 RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01: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 RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01: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 RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Para Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

El ejemplo anterior especifica los siguientes valores para las opciones:
+ `--service-type`: `RDS` para Amazon RDS
+ `--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 con Amazon CloudWatch, las funciones admitidas son `min`, `max`, `total` y `avg`.

La respuesta tiene un aspecto similar a la siguiente.

```
{
    "Identifier": "db-XXX",
    "AlignedStartTime": 1540857600.0,
    "AlignedEndTime": 1540861200.0,
    "MetricList": [
        { //A list of key/datapoints 
            "Key": {
                "Metric": "os.cpuUtilization.user.avg" //Metric1
            },
            "DataPoints": [
                //Each list of datapoints has the same timestamps and same number of items
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 4.0
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 4.0
                },
                {
                    "Timestamp": 1540857780.0, //Minute 3
                    "Value": 10.0
                }
                //... 60 datapoints for the os.cpuUtilization.user.avg metric
            ]
        },
        {
            "Key": {
                "Metric": "os.cpuUtilization.idle.avg" //Metric2
            },
            "DataPoints": [
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 12.0
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 13.5
                },
                //... 60 datapoints for the os.cpuUtilization.idle.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
<a name="USER_PerfInsights.API.Examples.DBLoadAverage"></a>

El siguiente ejemplo es la misma consulta que utiliza la Consola de administración de AWS para generar un gráfico de línea 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](#USER_PerfInsights.API.Examples.CounterMetrics). Sin embargo, el archivo query.json tiene los elementos indicados a continuación.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 7 }
    }
]
```

Ejecute el comando siguiente.

Para Linux, macOS o Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Para Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01: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 detalles acerca de los valores válidos para este ejemplo, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) en la *Referencia de la API de Performance Insights.*

La respuesta tiene un aspecto similar a la siguiente.

```
{
    "Identifier": "db-XXX",
    "AlignedStartTime": 1540857600.0,
    "AlignedEndTime": 1540861200.0,
    "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": 1540857660.0, //Minute1
                    "Value": 0.5166666666666667
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 0.38333333333333336
                },
                {
                    "Timestamp": 1540857780.0, //Minute 3
                    "Value": 0.26666666666666666
                }
                //... 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_event.name": "CPU",
                    "db.wait_event.type": "CPU"
                }
            },
            "DataPoints": [
                {
                    "Timestamp": 1540857660.0, //Minute1
                    "Value": 0.35
                },
                {
                    "Timestamp": 1540857720.0, //Minute2
                    "Value": 0.15
                },
                //... 60 datapoints for the CPU key
            ]
        },
        //... In total we have 8 key/datapoints entries, 1) total, 2-8) Top Wait Events
    ] //end of MetricList
} //end of response
```

En esta respuesta, hay ocho entradas en la `MetricList`. Hay una entrada para el `db.load.avg` total y siete 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 SQL principales
<a name="USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL"></a>

El siguiente ejemplo agrupa `db.wait_events` por las 10 instrucciones SQL principales. Hay dos grupos distintos para instrucciones SQL:
+ `db.sql` – la instrucción SQL completa, como `select * from customers where customer_id = 123`
+ `db.sql_tokenized` – la instrucción SQL tokenizada, como `select * from customers where customer_id = ?`

Al analizar el desempeño de la base de datos, puede resultar útil tener en cuenta instrucciones SQL que solo se diferencien en sus parámetros como un elemento de lógica. Así pues, puede utilizar `db.sql_tokenized` al consultar. Sin embargo, sobre todo cuando le interese explicar planes, a veces es más útil examinar instrucciones SQL completas con parámetros y consultar agrupando por `db.sql`. Existe una relación principal-secundaria entre instrucciones SQL tokenizadas y completas, con varias instrucciones SQL completas (secundarias) agrupadas bajo la misma instrucción SQL 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](#USER_PerfInsights.API.Examples.DBLoadAverage). Sin embargo, el archivo query.json tiene los elementos indicados a continuación.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.sql_tokenized", "Limit": 10 }
    }
]
```

El siguiente ejemplo utiliza `db.sql_tokenized`.

Para Linux, macOS o Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-29T00:00:00Z \
   --end-time   2018-10-30T00:00:00Z \
   --period-in-seconds 3600 \
   --metric-queries file://query.json
```

Para Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-29T00:00:00Z ^
   --end-time   2018-10-30T00:00:00Z  ^
   --period-in-seconds 3600 ^
   --metric-queries file://query.json
```

Este ejemplo consulta durante 24 horas, con un periodo de una hora en segundos.

El ejemplo especifica la métrica de `db.load.avg` y un `GroupBy` de los siete eventos de espera principales. Para obtener detalles acerca de los valores válidos para este ejemplo, consulte [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) en la *Referencia de la API de Performance Insights.*

La respuesta tiene un aspecto similar a la siguiente.

```
{
    "AlignedStartTime": 1540771200.0,
    "AlignedEndTime": 1540857600.0,
    "Identifier": "db-XXX",

    "MetricList": [ //11 entries in the MetricList
        {
            "Key": { //First key is total
                "Metric": "db.load.avg"
            }
            "DataPoints": [ //Each DataPoints list has 24 per-hour Timestamps and a value
                {
                    "Value": 1.6964980544747081,
                    "Timestamp": 1540774800.0
                },
                //... 24 datapoints
            ]
        },
        {
            "Key": { //Next key is the top tokenized SQL  
                "Dimensions": {
                    "db.sql_tokenized.statement": "INSERT INTO authors (id,name,email) VALUES\n( nextval(?)  ,?,?)",
                    "db.sql_tokenized.db_id": "pi-2372568224",
                    "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE"
                },
                "Metric": "db.load.avg"
            },
            "DataPoints": [ //... 24 datapoints 
            ]
        },
        // In total 11 entries, 10 Keys of top tokenized SQL, 1 total key 
    ] //End of MetricList
} //End of response
```

Esta respuesta tiene 11 entradas en la `MetricList` (1 total, 10 SQL tokenizadas principales) y cada entrada tiene 24 `DataPoints` por hora.

Para consultas SQL tokenizadas, hay tres entradas en cada lista de dimensiones:
+ `db.sql_tokenized.statement`: la instrucción SQL tokenizada.
+ `db.sql_tokenized.db_id `: el ID de base de datos nativo utilizado para hacer referencia a SQL, o un ID sintético que genera Performance Insights para usted si no se encuentra disponible el ID de base de datos nativo. Este ejemplo devuelve el ID sintético de `pi-2372568224`.
+ `db.sql_tokenized.id`: el ID de la consulta dentro del panel Performance Insights.

  En la Consola de administración de AWS, este ID se denomina ID de soporte. Se denomina así porque el ID es sobre 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 privacidad de sus datos, y casi todos los datos se almacenan encriptados con su clave AWS KMS. Por lo tanto, nadie dentro de AWS puede ver estos datos. En el ejemplo anterior, tanto `tokenized.statement` como `tokenized.db_id` se almacenan cifrados. Si tiene un problema con su base de datos, AWS Support puede ayudarle, ya que hace referencia al ID de Support.

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.sql_tokenized.statement`, entonces se puede añadir un atributo `Dimensions` al archivo query.json.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": {
            "Group": "db.sql_tokenized",
            "Dimensions":["db.sql_tokenized.statement"],
            "Limit": 10
        }
    }
]
```

## Recuperación del promedio de carga de base de datos filtrado por SQL
<a name="USER_PerfInsights.API.Examples.DBLoadAverageFilterBySQL"></a>

![\[Gráfico de filtro por SQL.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/perf-insights-api-filter-chart.png)


La imagen anterior muestra que se ha seleccionado una consulta concreta y el gráfico de línea de área apilada de principales sesiones activas promedio se limita a esa consulta. Aunque se siguen consultando los siete eventos de espera generales principales, se filtra el valor de la respuesta. El filtro hace que solo tenga en cuenta las sesiones que coinciden con el filtro concreto.

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 SQL principales](#USER_PerfInsights.API.Examples.DBLoadAverageTop10SQL). Sin embargo, el archivo query.json tiene los elementos indicados a continuación.

```
[
 {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_event", "Limit": 5  }, 
        "Filter": { "db.sql_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
    }
]
```

Para Linux, macOS o Unix:

```
aws pi get-resource-metrics \
   --service-type RDS \
   --identifier db-ID \
   --start-time 2018-10-30T00:00:00Z \
   --end-time   2018-10-30T01:00:00Z \
   --period-in-seconds 60 \
   --metric-queries file://query.json
```

Para Windows:

```
aws pi get-resource-metrics ^
   --service-type RDS ^
   --identifier db-ID ^
   --start-time 2018-10-30T00:00:00Z ^
   --end-time   2018-10-30T01:00:00Z ^
   --period-in-seconds 60 ^
   --metric-queries file://query.json
```

La respuesta tiene un aspecto similar a la siguiente.

```
{
    "Identifier": "db-XXX", 
    "AlignedStartTime": 1556215200.0, 
    "MetricList": [
        {
            "Key": {
                "Metric": "db.load.avg"
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 1.4878117913832196
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 1.192823803967328
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "io", 
                    "db.wait_event.name": "wait/io/aurora_redo_log_flush"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 1.1360544217687074
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 1.058051341890315
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "io", 
                    "db.wait_event.name": "wait/io/table/sql/handler"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.16241496598639457
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.05163360560093349
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "synch", 
                    "db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.11479591836734694
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.013127187864644107
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "CPU", 
                    "db.wait_event.name": "CPU"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.05215419501133787
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.05805134189031505
                }
            ]
        }, 
        {
            "Key": {
                "Metric": "db.load.avg", 
                "Dimensions": {
                    "db.wait_event.type": "synch", 
                    "db.wait_event.name": "wait/synch/mutex/innodb/lock_wait_mutex"
                }
            }, 
            "DataPoints": [
                {
                    "Timestamp": 1556218800.0, 
                    "Value": 0.017573696145124718
                }, 
                {
                    "Timestamp": 1556222400.0, 
                    "Value": 0.002333722287047841
                }
            ]
        }
    ], 
    "AlignedEndTime": 1556222400.0
} //end of response
```

En esta respuesta, todos los valores se filtran según la contribución del SQL tokenizado AKIAIOSFODNN7EXAMPLE especificado en el archivo query.json. Las claves también podrían seguir un orden distinto de una consulta sin un filtro, porque el SQL filtrado afectaba a los cinco eventos de espera principales.

## Recuperación del texto completo de una instrucción SQL
<a name="USER_PerfInsights.API.Examples.GetDimensionKeyDetails"></a>

En el siguiente ejemplo se recupera el texto completo de una instrucción SQL para una instancia de base de datos `db-10BCD2EFGHIJ3KL4M5NO6PQRS5`. El `--group` es `db.sql` y el `--group-identifier` es `db.sql.id`. En este ejemplo, *my-sql-id* representa un ID de SQL recuperado al invocar a `pi get-resource-metrics` o`pi describe-dimension-keys`.

Ejecute el siguiente comando.

Para Linux, macOS o Unix:

```
aws pi get-dimension-key-details \
   --service-type RDS \
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \
   --group db.sql \
   --group-identifier my-sql-id \
   --requested-dimensions statement
```

Para Windows:

```
aws pi get-dimension-key-details ^
   --service-type RDS ^
   --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 ^
   --group db.sql ^
   --group-identifier my-sql-id ^
   --requested-dimensions statement
```

En este ejemplo, los detalles de las dimensiones están disponibles. Por lo tanto, Performance Insights recupera el texto completo de la instrucción SQL, sin truncarlo.

```
{
    "Dimensions":[
    {
        "Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id",
        "Dimension": "db.sql.statement",
        "Status": "AVAILABLE"
    },
    ...
    ]
}
```

## Creación de un informe de análisis de rendimiento para un período de tiempo
<a name="USER_PerfInsights.API.Examples.CreatePerfAnalysisReport"></a>

En el siguiente ejemplo, se crea un informe de análisis de rendimiento con la hora de inicio `1682969503` y la hora de finalización `1682979503` para la base de datos `db-loadtest-0`.

```
aws pi create-performance-analysis-report \
        --service-type RDS \
        --identifier db-loadtest-0 \
        --start-time 1682969503 \
        --end-time 1682979503 \
        --region us-west-2
```

La respuesta es el identificador único `report-0234d3ed98e28fb17` para el informe.

```
{
   "AnalysisReportId": "report-0234d3ed98e28fb17"
}
```

## Recuperación de un informe de análisis de rendimiento
<a name="USER_PerfInsights.API.Examples.GetPerfAnalysisReport"></a>

En el siguiente ejemplo se recuperan los detalles del informe de análisis del informe `report-0d99cc91c4422ee61`.

```
aws pi get-performance-analysis-report \
--service-type RDS \
--identifier db-loadtest-0 \
--analysis-report-id report-0d99cc91c4422ee61 \
--region us-west-2
```

La respuesta proporciona el estado del informe, el identificador, los detalles del tiempo y la información.

```
        {
    "AnalysisReport": {
        "Status": "Succeeded", 
        "ServiceType": "RDS", 
        "Identifier": "db-loadtest-0", 
        "StartTime": 1680583486.584, 
        "AnalysisReportId": "report-0d99cc91c4422ee61", 
        "EndTime": 1680587086.584, 
        "CreateTime": 1680587087.139, 
        "Insights": [
           ... (Condensed for space)
        ]
    }
}
```

## Enumeración de todos los informes de análisis de rendimiento de la instancia de base de datos
<a name="USER_PerfInsights.API.Examples.ListPerfAnalysisReports"></a>

En el siguiente ejemplo se enumeran todos los informes de análisis de rendimiento disponibles para la base de datos `db-loadtest-0`.

```
aws pi list-performance-analysis-reports \
--service-type RDS \
--identifier db-loadtest-0 \
--region us-west-2
```

La respuesta enumera todos los informes con el ID del informe, el estado y los detalles del período de tiempo.

```
{
    "AnalysisReports": [
        {
            "Status": "Succeeded", 
            "EndTime": 1680587086.584, 
            "CreationTime": 1680587087.139, 
            "StartTime": 1680583486.584, 
            "AnalysisReportId": "report-0d99cc91c4422ee61"
        }, 
        {
            "Status": "Succeeded", 
            "EndTime": 1681491137.914, 
            "CreationTime": 1681491145.973, 
            "StartTime": 1681487537.914, 
            "AnalysisReportId": "report-002633115cc002233"
        }, 
        {
            "Status": "Succeeded", 
            "EndTime": 1681493499.849, 
            "CreationTime": 1681493507.762, 
            "StartTime": 1681489899.849, 
            "AnalysisReportId": "report-043b1e006b47246f9"
        }, 
        {
            "Status": "InProgress", 
            "EndTime": 1682979503.0, 
            "CreationTime": 1682979618.994, 
            "StartTime": 1682969503.0, 
            "AnalysisReportId": "report-01ad15f9b88bcbd56"
        }
    ]
}
```

## Eliminación de un informe de análisis de rendimiento
<a name="USER_PerfInsights.API.Examples.DeletePerfAnalysisReport"></a>

En el siguiente ejemplo, se elimina el informe de análisis de la base de datos `db-loadtest-0`.

```
aws pi delete-performance-analysis-report \
--service-type RDS \
--identifier db-loadtest-0 \
--analysis-report-id report-0d99cc91c4422ee61 \
--region us-west-2
```

## Adición de una etiqueta a un informe de análisis de rendimiento
<a name="USER_PerfInsights.API.Examples.TagPerfAnalysisReport"></a>

En el siguiente ejemplo, se agrega una etiqueta con una clave `name` y valor `test-tag` al informe `report-01ad15f9b88bcbd56`.

```
aws pi tag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--tags Key=name,Value=test-tag \
--region us-west-2
```

## Enumeración de todas las etiquetas de un informe de análisis de rendimiento
<a name="USER_PerfInsights.API.Examples.ListTagsPerfAnalysisReport"></a>

En el ejemplo siguiente se enumeran todas las etiquetas del informe `report-01ad15f9b88bcbd56`.

```
aws pi list-tags-for-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--region us-west-2
```

La respuesta enumera el valor y la clave de todas las etiquetas agregadas al informe:

```
{
    "Tags": [
        {
            "Value": "test-tag", 
            "Key": "name"
        }
    ]
}
```

## Eliminación de etiquetas de un informe de análisis de rendimiento
<a name="USER_PerfInsights.API.Examples.UntagPerfAnalysisReport"></a>

En el siguiente ejemplo se elimina la etiqueta `name` de un informe `report-01ad15f9b88bcbd56`.

```
aws pi untag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:356798100956:perf-reports/RDS/db-loadtest-0/report-01ad15f9b88bcbd56 \
--tag-keys name \
--region us-west-2
```

Después de eliminar la etiqueta, llamar a la API `list-tags-for-resource` no muestra esta etiqueta.

# Registro de llamadas de Performance Insights mediante el uso de AWS CloudTrail
<a name="USER_PerfInsights.CloudTrail"></a>

Performance Insights se ejecuta con AWS CloudTrail, un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o un servicio de AWS en Performance Insights. CloudTrail captura todas las llamadas a las API para Performance Insights como eventos. Esta captura incluye llamadas desde la consola de Amazon RDS y desde llamadas de código a las operaciones de la API de Performance Insights. 

Si crea un registro de seguimiento, puede habilitar la entrega continua de eventos de CloudTrail a un bucket de Amazon S3, incluidos eventos para Performance Insights. Si no configura un registro de seguimiento, puede ver los eventos más recientes en la consola de CloudTrail en el **Event history (Historial de eventos)**. Mediante la información recopilada por CloudTrail podrá determinar ciertos detalles. Esta información incluye la solicitud que se envió a Performance Insights, la dirección IP desde la que se realizó la solicitud, quién realizó la solicitud y cuándo se realizó. También incluye detalles adicionales. 

Para obtener más información sobre CloudTrail, consulte la [Guía del usuario de AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

## Trabajar con datos de Performance Insights en CloudTrail
<a name="USER_PerfInsights.CloudTrail.service-name-info"></a>

CloudTrail se habilita en su cuenta de AWS cuando la crea. Cuando se produce actividad en Performance Insights, esa actividad se registra en un evento de CloudTrail junto con otros eventos de servicios de AWS en la consola de CloudTrail en el **historial de eventos**. Puede ver, buscar y descargar los últimos eventos de la 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) en la *guía del usuario de AWS CloudTrail*.

Para mantener un registro continuo de los eventos de su cuenta de AWS, incluidos los eventos de Performance Insights, cree un registro de seguimiento. Un *registro de seguimiento* permite a CloudTrail enviar archivos de registro a un bucket de Amazon S3. De manera predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las regiones de AWS. El seguimiento registra los eventos de todas las regiones de AWS en 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)
+ [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/getting_notifications_top_level.html)
+ [Recepción de archivos de registro de CloudTrail de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [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)

CloudTrail registra todas las operaciones de Performance Insights que se documentan en la [Referencia de la API de Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html). Por ejemplo, las llamadas a las operaciones `DescribeDimensionKeys` y `GetResourceMetrics` generan entradas en los archivos de registro de CloudTrail. 

Cada entrada de registro o evento contiene información acerca de quién generó la solicitud. La información de identidad del usuario lo ayuda a determinar lo siguiente: 
+ Si la solicitud se realizó con las credenciales raíz o del usuario de IAM.
+ 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).

## Entradas del archivo de registro de Performance Insights
<a name="USER_PerfInsights.CloudTrail.service-name-entries"></a>

Un *seguimiento* es una configuración que permite la entrega de eventos como archivos de registro en un bucket de Amazon S3 que especifique. Los archivos de registro de CloudTrail contienen una o varias entradas de registro. Un *evento* representa una única solicitud desde cualquier origen. Cada evento incluye información acerca de la operación solicitada, la fecha y la hora de la operación, los parámetros de la solicitud, etc. Los archivos de registro de CloudTrail no rastrean el orden en la pila de las llamadas públicas a la API, por lo que estas no aparecen en ningún orden específico. 

En el ejemplo que sigue se muestra una entrada de registro de CloudTrail que ilustra la operación `GetResourceMetrics`.

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
         "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::123456789012:user/johndoe",
        "accountId": "123456789012",
        "accessKeyId": "AKIAI44QH8DHBEXAMPLE",
        "userName": "johndoe"
    },
    "eventTime": "2019-12-18T19:28:46Z",
    "eventSource": "pi.amazonaws.com",
    "eventName": "GetResourceMetrics",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "72.21.198.67",
    "userAgent": "aws-cli/1.16.240 Python/3.7.4 Darwin/18.7.0 botocore/1.12.230",
    "requestParameters": {
        "identifier": "db-YTDU5J5V66X7CXSCVDFD2V3SZM",
        "metricQueries": [
            {
                "metric": "os.cpuUtilization.user.avg"
            },
            {
                "metric": "os.cpuUtilization.idle.avg"
            }
        ],
        "startTime": "Dec 18, 2019 5:28:46 PM",
        "periodInSeconds": 60,
        "endTime": "Dec 18, 2019 7:28:46 PM",
        "serviceType": "RDS"
    },
    "responseElements": null,
    "requestID": "9ffbe15c-96b5-4fe6-bed9-9fccff1a0525",
    "eventID": "08908de0-2431-4e2e-ba7b-f5424f908433",
    "eventType": "AwsApiCall",
    "recipientAccountId": "123456789012"
}
```

# API de Información de rendimiento y puntos de conexión de VPC de interfaz (AWS PrivateLink)
<a name="pi-vpc-interface-endpoints"></a>

Puede usar AWS PrivateLink para crear una conexión privada entre la VPC e Información de rendimiento de Amazon RDS. Puede acceder a Información de rendimiento como si estuviera en su VPC, sin utilizar una puerta de enlace de Internet, un dispositivo NAT, una conexión VPN o una conexión Direct Connect. Las instancias de la VPC no necesitan direcciones IP públicas para acceder a Información de rendimiento.

Esta conexión privada se establece mediante la creación de un *punto de conexión de interfaz* alimentado por AWS PrivateLink. Creamos una interfaz de red de punto de conexión en cada subred habilitada para el punto de conexión de interfaz. Se trata de interfaces de red administradas por el solicitante que sirven como punto de entrada para el tráfico destinado a Información de rendimiento.

Para obtener más información, consulte [Acceso a los Servicios de AWS a través de AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-aws-services.html) en la *Guía de AWS PrivateLink*.

## Consideraciones sobre Información de rendimiento
<a name="vpc-endpoint-considerations"></a>

Antes de configurar un punto de conexión de interfaz para Información de rendimiento, consulte la sección [Considerations](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#considerations-interface-endpoints) en la *Guía de AWS PrivateLink*.

Información de rendimiento admite la realización de llamadas a todas las acciones de la API a través del punto de conexión de interfaz.

De forma predeterminada, el acceso completo a Información de rendimiento se permite a través del punto de conexión de interfaz. Para controlar el tráfico a Información de rendimiento a través del punto de conexión de interfaz, asocie un grupo de seguridad a las interfaces de red de los puntos de conexión.

## Disponibilidad
<a name="rds-and-vpc-interface-endpoints-availability"></a>

La API de Información de rendimiento actualmente admite puntos de conexión de VPC en Regiones de AWS que admiten Información de rendimiento. Para obtener más información acerca de la disponibilidad de Información de rendimiento, consulte [Regiones y motores de base de datos admitidos para Información sobre rendimiento en Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.PerformanceInsights.md) .

## Creación de un punto de conexión de interfaz para Información de rendimiento
<a name="vpc-endpoint-create"></a>

Puede crear un punto de conexión de interfaz para Información de rendimiento mediante la consola de Amazon VPC o la AWS Command Line Interface (AWS CLI). Para obtener más información, consulte [Creación de un punto de conexión de interfaz](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws) en la *Guía de AWS PrivateLink*.

Cree un punto de conexión para Información de rendimiento utilizando el siguiente nombre de servicio:

Si habilita el DNS privado para el punto de conexión de interfaz, puede realizar solicitudes a la API para Información de rendimiento usando su nombre de DNS predeterminado para la región. Por ejemplo, `pi.us-east-1.amazonaws.com`.

## Creación de una política de puntos de conexión de VPC para la API de Información de rendimiento
<a name="vpc-endpoint-policy"></a>

Una política de punto de conexión es un recurso de IAM que puede adjuntar a un punto de conexión de interfaz. La política de puntos de conexión predeterminada permite acceso completo a Información de rendimiento a través del punto de conexión de interfaz. Para controlar el acceso permitido a Información de rendimiento desde la VPC, adjunte una política de puntos de conexión personalizada al punto de conexión de interfaz.

Una política de punto de conexión especifica la siguiente información:
+ Las entidades principales que pueden llevar a cabo acciones (Cuentas de AWS, usuarios de IAM y roles de IAM).
+ Las acciones que se pueden realizar.
+ El recurso en el que se pueden realizar las acciones.

Para obtener más información, consulte [Control del acceso a los servicios con políticas de punto de conexión](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-access.html) en la *Guía del usuario de AWS PrivateLink*.

**Ejemplo: Política de punto de conexión de VPC para acciones de Información de rendimiento**  
El siguiente es un ejemplo de una política de un punto de conexión personalizado. Cuando se asocia con un punto de conexión, esta política concede acceso a las acciones de Información de rendimiento mostradas para todas las entidades principales en todos los recursos.

```
{
   "Statement":[
      {
         "Principal":"*",
         "Effect":"Allow",
         "Action":[
            "rds:CreatePerformanceAnalysisReport",
            "rds:DeletePerformanceAnalysisReport",
            "rds:GetPerformanceAnalysisReport"
         ],
         "Resource":"*"
      }
   ]
}
```

**Ejemplo: Política de punto de conexión de VPC que deniega todo el acceso desde una cuenta de AWS especificada**  
La siguiente política de punto de conexión de VPC deniega a la cuenta de AWS `123456789012` todo el acceso a los recursos mediante el punto de conexión. La política permite todas las acciones de otras cuentas.

```
{
  "Statement": [
    {
      "Action": "*",
      "Effect": "Allow",
      "Resource": "*",
      "Principal": "*"
    },
    {
      "Action": "*",
      "Effect": "Deny",
      "Resource": "*",
      "Principal": { "AWS": [ "123456789012" ] }
     }
   ]
}
```

## Direcciones IP de Información de rendimiento
<a name="pi-ip-addressing"></a>

Las direcciones IP permiten que los recursos de la VPC se comuniquen entre sí y con otros recursos a través de Internet. Información de rendimiento admite los protocolos de direcciones IPv4 e IPv6. De forma predeterminada, Información de rendimiento y Amazon VPC utilizan el protocolo de direccionamiento IPv4. No puedes desactivar este comportamiento. Al crear una VPC, debe especificar un bloque de CIDR IPv4 (un intervalo de direcciones IPv4 privadas). 

De manera opcional, puede asociar un bloque de CIDR IPv6 a su VPC y sus subredes y asignar direcciones IPv6 de dicho bloque a recursos de RDS de su subred. La compatibilidad con el protocolo IPv6 amplía el número de direcciones IP admitidas. Al utilizar el protocolo IPv6, se asegura de tener suficientes direcciones disponibles para el futuro crecimiento de Internet. Los recursos de RDS nuevos y existentes pueden utilizar direcciones IPv4 e IPv6 dentro de su VPC. Configurar, proteger y traducir el tráfico de red entre los dos protocolos utilizados en diferentes partes de una aplicación puede provocar sobrecarga operativa. Puede estandarizar el protocolo IPv6 para los recursos de Amazon RDS para simplificar la configuración de la red. Para obtener información sobre los puntos de conexión y las cuotas de servicios, consulte [Amazon Relational Database Service endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/rds-service.html).

Para obtener más información sobre el direccionamiento IP de Amazon RDS, consulte [Direccionamiento IP de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.IP_addressing).