Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Reglas de monitoreo de consultas de WLM
<a name="cm-c-wlm-query-monitoring-rules"></a>

En la administración de cargas de trabajo (WLM) de Amazon Redshift, las reglas de monitoreo de consultas definen los límites de rendimiento basados en métricas para las colas de WLM y especifican la acción que se debe realizar cuando una consulta supere esos límites. Por ejemplo, para una cola dedicada a consultas de ejecución corta, puede crear una regla que cancele las consultas que se ejecuten durante más de 60 segundos. Para hacer un seguimiento de las consultas mal diseñadas, puede disponer de otra regla que registre las consultas que contienen bucles anidados. 

Puede definir las reglas de monitorización de consultas como parte de la configuración de la administración de cargas de trabajo (WLM). Puede definir hasta 25 reglas para cada cola, con un límite de 25 reglas para todas las colas. Cada regla incluye hasta tres condiciones, o predicados, y una acción. Un *predicado* se compone de una métrica, una condición de comparación (=, < o >) y un valor. Si se cumplen todos los predicados para cualquier regla, se desencadena la acción de esa regla. Las acciones de reglas posibles son log, hop y abort, como se explica a continuación. 

Las reglas de una cola determinada aplican únicamente a las consultas que se ejecuten en esa cola. Una regla es independiente de otras reglas. 

WLM evalúa las métricas cada 10 segundos. Amazon Redshift aplica reglas de monitorización de consultas en la consulta secundaria cuando las consultas se reescriben automáticamente. Si se activa más de una regla durante el mismo periodo, WLM elige la regla con la acción más grave. Si la acción de dos reglas tiene la misma gravedad, WLM ejecuta las reglas en orden alfabético, según el nombre de la regla. Si la acción es hop o abort, se registra la acción y la consulta se desaloja de la cola. Si la acción es log, la consulta continúa ejecutándose en la cola. WLM inicia solo una acción log por consulta, por regla. Si la cola contiene otras reglas, estas permanecerán en vigor. Si la acción es hop y la consulta se dirige a otra cola, las reglas aplican para la nueva cola. Para obtener más información sobre el monitoreo de consultas y el seguimiento de las acciones realizadas en consultas específicas, consulte la recopilación de ejemplos en [Aceleración de consultas cortas](wlm-short-query-acceleration.md).

Cuando se cumplen todos los predicados de una regla, WLM escribe una fila a la tabla de sistema [STL\$1WLM\$1RULE\$1ACTION](r_STL_WLM_RULE_ACTION.md). Además, Amazon Redshift registra en las métricas de las consultas que están en ejecución actualmente [STV\$1QUERY\$1METRICS](r_STV_QUERY_METRICS.md). Las métricas de consultas completadas se almacenan en [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md). 

**nota**  
Para Amazon Redshift sin servidor, puede configurar colas de consultas y reglas de supervisión mediante el parámetro `wlm_json_configuration`. Esto le permite crear varias colas con diferentes roles de usuario, grupos de consultas y reglas de supervisión. Para obtener más información sobre la configuración de colas de consultas sin servidor, consulte [Configuración de colas de consultas](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-workgroup-query-queues.html) en la *Guía de administración de Amazon Redshift*.

## Definición de una regla de monitoreo de consultas
<a name="cm-c-wlm-defining-query-monitoring-rules"></a>

Las reglas de monitoreo de consultas se crean durante la configuración de WLM, que se establece durante la definición del grupo de parámetros del clúster.

Puede crear reglas con la Consola de administración de AWS o mediante programación con JSON. 

**nota**  
Si decide crear reglas mediante programación, recomendamos encarecidamente utilizar la consola para generar el JSON que incluirá en la definición del grupo de parámetros. Para obtener más información, consulte [Creación de una regla de supervisión de consultas](https://docs.aws.amazon.com/redshift/latest/mgmt/parameter-group-modify-qmr-console.html) y [Configuración de los valores de parámetros mediante la AWS CLI](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-parameter-groups.html#configure-parameters-using-the-cli) en la *Guía de administración de Amazon Redshift*. 

Para definir una regla de monitorización de consultas, especifique los elementos siguientes:
+ Un nombre de regla: los nombres de reglas deben ser únicos dentro de la configuración de la WLM. Los nombres de reglas pueden tener un máximo de 32 caracteres alfanuméricos o guiones bajos y no pueden contener espacios ni comillas. Puede tener hasta 25 reglas por cola y el límite total para todas las colas es 25 reglas.
+ Uno o más predicados: puede tener hasta tres predicados por regla. Si se cumplen todos los predicados para cualquier regla, se desencadena la acción asociada. Un predicado se define mediante un nombre de métrica, un operador (=, <, o >) y un valor. Un ejemplo es `query_cpu_time > 100000`. Para obtener una lista de métricas y ejemplos de valores para diferentes métricas, consulte [Métricas de supervisión de consultas para Amazon Redshift aprovisionado](#cm-c-wlm-query-monitoring-metrics) más adelante en esta sección. 
+ Una acción: si se desencadena más de una regla, la WLM selecciona la regla con la acción más severa. Las acciones posibles, en orden ascendente de gravedad, son:
  + Registro: registra la información acerca de la consulta en la tabla de sistema STL\$1WLM\$1RULE\$1ACTION. Utilice la acción Log cuando solo desee escribir un registro. WLM crea como máximo un registro por consulta, por regla. Después de llevar a cabo una acción log, las otras reglas permanecen vigentes y WLM continúa monitorizando la consulta. 
  + Salto (disponible solo con la WLM manual): registra la acción y transfiere la consulta a la siguiente cola coincidente. Si no existe otra cola coincidente, la consulta se cancela. QMR solo salta instrucciones [CREATE TABLE AS](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_TABLE_AS.html) (CTAS) y consultas de solo lectura, como instrucciones SELECT. Para obtener más información, consulte [Salto de cola de consultas de WLM](wlm-queue-hopping.md). 
  + Anulación: registra la acción y cancela la consulta. QMR no detiene las instrucciones COPY ni las operaciones de mantenimiento, como ALTER, ANALYZE y VACUUM. 
  + Modificación de prioridad (disponible solo con la WLM automática): cambia la prioridad de una consulta. 

Para limitar el tiempo de ejecución de consultas, le recomendamos que cree una regla de monitorización de consultas en lugar de usar el tiempo de espera de WLM. Por ejemplo, puede establecer `max_execution_time` en 50.000 milisegundos como se muestra en el siguiente fragmento JSON.

```
"max_execution_time": 50000
```

Sin embargo, le recomendamos que defina una regla de supervisión de consultas equivalente. En el ejemplo siguiente se muestra una regla de supervisión de consultas que establece `query_execution_time` en 50 segundos:

```
"rules": 
[
    {
        "rule_name": "rule_query_execution",
        "predicate": [
            {
                "metric_name": "query_execution_time",
                "operator": ">",
                "value": 50
            }
        ],
        "action": "abort"
    }            
]
```

Si desea conocer los pasos necesarios para crear o modificar una regla de supervisión de consultas, consulte [Creación de una regla de supervisión de consultas](https://docs.aws.amazon.com/redshift/latest/mgmt/parameter-group-modify-qmr-console.html) y [Propiedades del parámetro wlm\$1json\$1configuration](https://docs.aws.amazon.com/redshift/latest/mgmt/workload-mgmt-config.html#wlm-json-config-properties) en la *Guía de administración de Amazon Redshift*.

Puede encontrar más información acerca de las reglas de monitorización de consultas en los temas siguientes: 
+  [Métricas de supervisión de consultas para Amazon Redshift aprovisionado](#cm-c-wlm-query-monitoring-metrics) 
+  [Plantillas de reglas de monitoreo de consultas](#cm-c-wlm-query-monitoring-templates) 
+  [Creación de una regla de supervisión de consultas](https://docs.aws.amazon.com/redshift/latest/mgmt/parameter-group-modify-qmr-console.html) 
+  [Configuración de la administración de cargas de trabajo](https://docs.aws.amazon.com/redshift/latest/mgmt/workload-mgmt-config.html) 
+  [Tablas y vistas de sistema para reglas de monitoreo de consultas](#cm-c-wlm-qmr-tables-and-views) 

## Métricas de supervisión de consultas para Amazon Redshift aprovisionado
<a name="cm-c-wlm-query-monitoring-metrics"></a>

En la siguiente tabla se describen las métricas utilizadas en las reglas de monitorización de consultas. (Estas métricas son distintas de las métricas almacenadas en las tablas del sistema [STV\$1QUERY\$1METRICS](r_STV_QUERY_METRICS.md) y [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md)). 

Para una métrica determinada, se hace un seguimiento del umbral de rendimiento al nivel de la consulta o del segmento. Para obtener más información acerca de los segmentos y pasos, consulte [Flujo de trabajo de planificación y ejecución de consultas](c-query-planning.md).

**nota**  
El parámetro [Tiempo de espera de WLM](cm-c-defining-query-queues.md#wlm-timeout) es distinto de las reglas de monitorización de consultas.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html)

**nota**  
La acción de salto no se admite con el predicado `query_queue_time`. Es decir, se omiten las reglas de salto definidas cuando se cumplen los requisitos del predicado `query_queue_time`. 
Los tiempos de ejecución de segmentos cortos pueden ocasionar errores de muestreo con otras métricas, como `io_skew` y `query_cpu_usage_percent`. Para evitar o reducir errores de muestreo, incluya el tiempo de ejecución de segmentos en las reglas. Un buen punto de partida es `segment_execution_time > 10`.

La vista [SVL\$1QUERY\$1METRICS](r_SVL_QUERY_METRICS.md) muestra las métricas de consultas completadas. La vista [SVL\$1QUERY\$1METRICS\$1SUMMARY](r_SVL_QUERY_METRICS_SUMMARY.md) muestra los valores máximos de métricas de consultas completadas. Utilice los valores de estas vistas como ayuda para determinar los valores de umbral para definir las reglas de monitorización de consultas.

## Métricas de supervisión de consultas para Amazon Redshift sin servidor
<a name="cm-c-wlm-query-monitoring-metrics-serverless"></a>

En la siguiente tabla se describen las métricas utilizadas en las reglas de supervisión de consultas para Amazon Redshift sin servidor. 

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html)

**nota**  
La acción de salto no se admite con el predicado `max_query_queue_time`. Es decir, se omiten las reglas de salto definidas cuando se cumplen los requisitos del predicado `max_query_queue_time`. 
Los tiempos de ejecución de segmentos cortos pueden ocasionar errores de muestreo con otras métricas, como `max_io_skew` y `max_query_cpu_usage_percent`.

Para Amazon Redshift sin servidor, puede configurar colas de consultas y reglas de supervisión mediante el parámetro `wlm_json_configuration`. Esto le permite crear varias colas con diferentes roles de usuario, grupos de consultas y reglas de supervisión usando las métricas enumeradas anteriormente. Para obtener más información sobre la configuración de colas de consultas sin servidor, consulte [Estructura de configuración de WLM JSON](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-workgroup-query-queues.html#serverless-wlm-json-configuration) en la *Guía de administración de Amazon Redshift*.

## Plantillas de reglas de monitoreo de consultas
<a name="cm-c-wlm-query-monitoring-templates"></a>

Cuando agrega una regla utilizando la consola de Amazon Redshift, puede elegir crear una regla a partir de una plantilla predefinida. Amazon Redshift crea una nueva regla con un conjunto de predicados y completa los predicados con valores predeterminados. La acción predeterminada es log. Puede modificar los predicados y las acciones para que cumplan con el caso de uso. 

En la tabla siguiente se muestran las plantillas disponibles. 

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/redshift/latest/dg/cm-c-wlm-query-monitoring-rules.html)

## Tablas y vistas de sistema para reglas de monitoreo de consultas
<a name="cm-c-wlm-qmr-tables-and-views"></a>

Cuando se cumplen todos los predicados de una regla, WLM escribe una fila a la tabla de sistema [STL\$1WLM\$1RULE\$1ACTION](r_STL_WLM_RULE_ACTION.md). Esta fila contiene detalles para la consulta que activaron la regla y la acción resultante. 

Además, Amazon Redshift registra métricas de consultas para las siguientes tablas de sistema y vistas.
+ La tabla[STV\$1QUERY\$1METRICS](r_STV_QUERY_METRICS.md) muestra las métricas de consultas en ejecución.
+ La tabla [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md) registra las métricas de consultas completadas. 
+ La vista [SVL\$1QUERY\$1METRICS](r_SVL_QUERY_METRICS.md) muestra las métricas de consultas completadas. 
+ La vista [SVL\$1QUERY\$1METRICS\$1SUMMARY](r_SVL_QUERY_METRICS_SUMMARY.md) muestra los valores máximos de métricas de consultas completadas.