Mejora el rendimiento de las consultas con las funciones avanzadas de estadísticas de consultas de AlloyDB

En esta página, se describe cómo usar las funciones avanzadas de estadísticas de consultas de AlloyDB para detectar y analizar problemas de rendimiento de las consultas en tiempo casi real para las instancias principales y del grupo de lectura. Para obtener una descripción general de las funciones avanzadas de estadísticas de consultas de AlloyDB, consulta Descripción general de las funciones avanzadas de estadísticas de consultas de AlloyDB.

Para obtener información sobre cómo usar las estadísticas de consultas estándares, consulta Usa las estadísticas de consultas para mejorar el rendimiento de las consultas.

Puedes usar la asistencia de Gemini in Databases para supervisar y solucionar problemas de tus recursos de AlloyDB. Para obtener más información, consulta Supervisa y soluciona problemas con la asistencia de Gemini.

Antes de comenzar

Para acceder al panel de estadísticas de consultas, habilita el acceso a AlloyDB para PostgreSQL en tu proyecto de Google Cloud.

Roles obligatorios

Para usar las funciones avanzadas de estadísticas de consultas de AlloyDB, necesitas permisos para lo siguiente:

  • Para acceder a las funciones avanzadas de estadísticas de consultas de AlloyDB, necesitas permisos para acceder al panel de estadísticas de consultas de AlloyDB.
  • Para editar la configuración de las funciones avanzadas de estadísticas de consultas de AlloyDB, necesitas permisos para actualizar las instancias de AlloyDB.

Para obtener estos permisos, pídele a tu administrador que te otorgue uno de los siguientes roles:

  • Visor básico (roles/viewer)
  • Visualizador de estadísticas de bases de datos (roles/databaseinsights.viewer)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Habilita las funciones avanzadas de estadísticas de consultas para AlloyDB

Para habilitar la configuración avanzada de estadísticas de consultas para una instancia de AlloyDB, sigue estos pasos:

Console

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. Haz clic en Habilitar o Editar configuración.

  6. En la pestaña Editar configuración de estadísticas de consultas, selecciona la casilla de verificación Habilitar funciones avanzadas de estadísticas de consultas para AlloyDB.

    Esto implica los siguientes cambios de configuración de forma predeterminada:

    • Activa las casillas de verificación Análisis de eventos de espera y Análisis de consultas activas.
    • Aumenta la longitud de la consulta de 4,500 B a 100,000 B.
    • Aumenta la tasa de muestreo máxima de 20 a 200 muestras de planes de consultas por minuto.

  7. Guarda los cambios. Esto reiniciará tu instancia de AlloyDB para PostgreSQL.

gcloud

gcloud alpha alloydb instances update INSTANCE \
--cluster=CLUSTER \
--project=PROJECT \
--region=REGION \
--observability-config-enabled

Reemplaza lo siguiente:

  • INSTANCE: Es el ID de la instancia que se actualizará.
  • CLUSTER: Es el ID del clúster de la instancia.
  • PROJECT: Es el ID del proyecto del clúster.
  • REGION: Es la región del clúster, por ejemplo, us-central1.

La marca --observability-config-enabled permite recopilar y analizar datos en una instancia de AlloyDB para supervisar su rendimiento y estado. Si quieres inhabilitar las estadísticas de consultas avanzadas, usa --no-observability-config-enabled.

Terraform

Para usar Terraform y habilitar estadísticas de consultas avanzadas en tu instancia de AlloyDB, establece el campo enabled en true en el bloque observability_config.

Por ejemplo:

  observability_config {
    enabled = true
  ...
  }

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

REST v1

En este ejemplo, se habilitan las estadísticas de consultas avanzadas en tu instancia de AlloyDB. Para ver una lista completa de los parámetros de esta llamada, consulta Método: projects.locations.clusters.instances.patch. Para obtener información sobre la configuración de las estadísticas de consultas avanzadas, consulta Edita la configuración de las estadísticas de consultas avanzadas.

Antes de usar cualquiera de los datos de solicitud, realiza los siguientes reemplazos:

  • CLUSTER_ID: Es el ID del clúster que creaste. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
  • PROJECT_ID: Es el ID del proyecto en el que deseas que se coloque el clúster.
  • LOCATION_ID: Es el ID de la región del clúster.
  • INSTANCE_ID: Es el nombre de la instancia principal que deseas crear.

Para habilitar la configuración de tu instancia, usa la siguiente solicitud PATCH:

PATCH https://alloydb.googleapis.com/v1beta/{instance.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=observabilityConfig.enabled}

El parámetro de consulta updateMask=observabilityConfig.enabled le indica a la API que actualice el campo enabled dentro del bloque observabilityConfig.

El cuerpo JSON de la solicitud se ve de la siguiente manera:

{
 "observabilityConfig": {
   "enabled" : true,
 }
}

Una vez que se habiliten las estadísticas de consultas avanzadas, podrás editar su configuración.

Edita la configuración de las funciones avanzadas

Para editar la configuración de estadísticas de consultas avanzadas de una instancia de AlloyDB, sigue estos pasos:

Console

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Haz clic en Editar configuración y, luego, modifica cualquiera de los siguientes parámetros de configuración:

    • Análisis de eventos de espera El análisis de eventos de espera puede ayudarte a identificar y resolver problemas de rendimiento en tu base de datos. Un evento de espera es un componente que causa una demora en el procesamiento de una operación relacionada con la consulta.
    • Análisis de consultas activas: Realiza un seguimiento de las consultas que se ejecutan de forma activa.
    • Almacena los comentarios de las consultas Para conocer el contexto de la consulta, revisa los comentarios asociados con cualquier consulta que investigues, como parte de su longitud. No se necesita memoria adicional. Si tus comentarios contienen información sensible, ten en cuenta el acceso de los usuarios.
    • Habilita el asesor de índices Muestra recomendaciones para la creación de índices en la página de estadísticas de consultas de un clúster.
    • En el campo Seleccionar frecuencia de ejecución, puedes definir la frecuencia de actualización de las recomendaciones.
    • Almacenar las direcciones IP de cliente Habilita esta opción para hacer un seguimiento de las direcciones IP de los clientes y analizar esos datos.
    • Almacenar etiquetas de aplicación: Habilita esta opción para saber qué APIs y rutas de estructura modelo-vista-controlador realizan solicitudes y agrupa esos datos para ejecutar métricas en función de ellos.
    • Muestreo de planes de consulta Los planes de consulta visualizan las operaciones que se usan para completar una muestra de una consulta. La tasa de muestreo determina cuántas muestras de consultas se pueden capturar por minuto en las bases de datos. Las tasas más altas requieren más memoria.
    • En el campo Longitud de las consultas, puedes cambiar el límite predeterminado de la longitud de las consultas, de 256 bytes hasta 100 KB. Las consultas más largas requieren más memoria. Para cambiar la longitud de las consultas, debes reiniciar la instancia.

  5. Guarda los cambios.

gcloud

gcloud alpha alloydb instances update INSTANCE \
--cluster=CLUSTER \
--project=PROJECT \
--region=REGION \
--observability-config-preserve-comments \
--observability-config-track-wait-events \
--observability-config-max-query-string-length=QUERY_LENGTH \
--observability-config-record-application-tags \
--observability-config-query-plans-per-minute=QUERY_PLANS \
--observability-config-track-active-queries

Reemplaza lo siguiente:

  • INSTANCE: Es el ID de la instancia que se actualizará.
  • CLUSTER: Es el ID del clúster de la instancia.
  • PROJECT: Es el ID del proyecto del clúster.
  • REGION: Es la región del clúster, por ejemplo, us-central1.
  • QUERY_LENGTH: Es la longitud de la consulta que varía de 1,024 a 100,000 bytes. La longitud predeterminada de la consulta es de 10,240 bytes. Las consultas de mayor longitud son más útiles para las consultas analíticas, pero también requieren más memoria. Para cambiar la longitud de las consultas, debes reiniciar la instancia. Puedes seguir agregando etiquetas a las consultas que superen el límite de longitud.
  • QUERY_PLANS: Es la cantidad de planes de consulta que se deben configurar por minuto. De forma predeterminada, se captura un máximo de 20 muestras de planes de consultas ejecutadas por minuto en todas las bases de datos de la instancia. Cambia este valor a un número entre 1 y 20. Para inhabilitar el muestreo, ingresa 0. Es probable que aumentar la tasa de muestreo te proporcione más datos, pero tal vez afecte negativamente el rendimiento.

Usa las siguientes marcas de observabilidad opcionales si es necesario:

  • --observability-config-track-active-queries: Habilita el seguimiento de las consultas activas. Si quieres inhabilitar la función, usa --no-observability-config-track-active-queries.
  • --observability-config-record-application-tags: Almacena etiquetas de aplicación que te ayudan a determinar las APIs y las rutas de estructura modelo-vista-controlador (MVC) que realizan solicitudes y agrupan datos para ejecutar métricas en función de ellos. Esta opción requiere que comentes las consultas con un conjunto de etiquetas específico. Si no quieres almacenar etiquetas de aplicación, usa --no-observability-config-record-application-tags.
  • --observability-config-preserve-comments: Mantiene las anotaciones agregadas al código SQL para proporcionar información sobre el código sin afectar su ejecución. Si no quieres conservar las anotaciones, usa --no-observability-config-preserve-comments.
  • --observability-config-track-wait-events: Habilita la espera de eventos de cada tipo de evento de espera. Si no quieres hacer un seguimiento de los eventos de espera, usa --no-observability-config-track-wait-events.

Terraform

Para usar Terraform y configurar estadísticas de consultas avanzadas en tu instancia de AlloyDB, usa el recurso google_alloydb_instance.

A continuación, se muestra un ejemplo:

  observability_config {
    enabled = ENABLED_VALUE
    preserve_comments = PRESERVE_COMMENTS_VALUE
    track_wait_events = TRACK_WAIT_EVENTS_VALUE
    max_query_string_length = MAX_QUERY_STRING_LENGTH_VALUE
    record_application_tags = RECORD_APPLICATION_TAGS_VALUE
    query_plans_per_minute = QUERY_PLANS_PER_MINUTE_VALUE
    track_active_queries = TRACK_ACTIVE_QUERIES_VALUE
  }

Reemplaza lo siguiente:

  • ENABLED_VALUE: Es el estado de la función de observabilidad de una instancia. Establece en true cuando edites la configuración y especifica otras marcas según sea necesario.
  • PRESERVE_COMMENTS_VALUE: Conserva los comentarios en la cadena de consulta. El valor predeterminado es false.
  • TRACK_WAIT_EVENTS_VALUE: Registra eventos de espera durante la ejecución de una consulta para una instancia. El valor predeterminado es true.
  • MAX_QUERY_STRING_LENGTH_VALUE: Es la longitud de la cadena de consulta. El valor predeterminado es 10240. Cualquier número entero entre 1024 y 100,000 es válido.
  • RECORD_APPLICATION_TAGS_VALUE: Registra etiquetas de aplicación para una instancia. El valor predeterminado es true.
  • QUERY_PLANS_PER_MINUTE_VALUE: Es la cantidad de planes de ejecución de consultas capturados por las estadísticas por minuto para todas las consultas combinadas. El valor predeterminado es 20. Cualquier número entero entre 0 y 20 es válido.

  • TRACK_ACTIVE_QUERIES_VALUE: Hacer un seguimiento de las consultas que se ejecutan de forma activa El valor predeterminado es false.

    Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

REST v1

En este ejemplo, se configuran las estadísticas de consultas avanzadas en tu instancia de AlloyDB. Para ver una lista completa de los parámetros de esta llamada, consulta Método: projects.locations.clusters.instances.patch.

Para configurar la configuración avanzada de estadísticas de búsquedas, establece el campo enabled en true y modifica otros campos opcionales según sea necesario. Para obtener una lista completa de los campos de esta llamada, consulta ObservabilityInstanceConfig.

Antes de usar cualquiera de los datos de solicitud, realiza los siguientes reemplazos:

  • CLUSTER_ID: Es el ID del clúster que creaste. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
  • PROJECT_ID: Es el ID del proyecto en el que deseas que se coloque el clúster.
  • LOCATION_ID: Es el ID de la región del clúster.
  • INSTANCE_ID: Es el nombre de la instancia principal que deseas crear.

Para modificar la configuración de tu instancia, usa la siguiente solicitud PATCH:

PATCH https://alloydb.googleapis.com/v1beta/{instance.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=observabilityConfig.enabled,observabilityConfig.preserveComments,observabilityConfig.trackWaitEvents,observabilityConfig.maxQueryStringLength,observabilityConfig.recordApplicationTags,observabilityConfig.queryPlansPerMinute,observabilityConfig.trackActiveQueries,observabilityConfig.trackClientAddress}

El cuerpo JSON de la solicitud que configura todos los campos de estadísticas de consultas avanzadas se ve de la siguiente manera:

{
 "observabilityConfig": {
   "enabled" : true,
   "preserveComments": true,
   "trackWaitEvents": true,
   "maxQueryStringLength": 5000,
   "recordApplicationTags": true,
   "queryPlansPerMinute": 100,
   "trackActiveQueries": true,
 }
}

Detecta y diagnostica problemas de rendimiento de las consultas

Puedes usar estadísticas de consultas avanzadas para detectar y diagnosticar problemas de rendimiento. En el panel de estadísticas de consultas, se muestra la carga de la base de datos, que es una medida del trabajo (en segundos de CPU) que ejecutaron las consultas en la base de datos seleccionada a lo largo del tiempo. Cada consulta en ejecución utiliza o espera recursos. La carga de la base de datos es la proporción de la cantidad de tiempo que tomaron todas las consultas completadas en un período determinado, en tiempo real transcurrido.

Cómo ver la medición del trabajo realizado por las consultas ejecutadas

El gráfico de carga de la base de datos proporciona la medición del trabajo realizado (en segundos de CPU) por todas las consultas ejecutadas en tu base de datos, segmentadas por la dimensión seleccionada. La carga de la base de datos se divide en los datos de distribución que seleccionas en el menú desplegable del gráfico.

Puedes desglosar la carga de la base de datos por cualquiera de las siguientes dimensiones:

  • Consulta
  • Tipo de evento de espera
  • Evento de espera
  • Base de datos
  • Usuario

Para ver el trabajo completado por las consultas ejecutadas en tu base de datos, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. Elige el tiempo de ejecución total para el que deseas mostrar datos, por ejemplo, 1 o 6 horas, o un tiempo personalizado.

  6. En el menú desplegable Carga de la base de datos por tiempo de ejecución, elige la dimensión que deseas investigar. Según la dimensión que elijas, el gráfico mostrará cómo esta contribuye a la carga general de la base de datos. Por ejemplo, si seleccionas la dimensión Eventos de espera en el menú desplegable del gráfico de carga de la base de datos, se mostrará en el gráfico el desglose de todos los eventos de espera que se produjeron durante el período seleccionado para la base de datos y el usuario seleccionados.

    El gráfico de carga de la base de datos muestra datos de los nueve tipos de eventos de espera y los eventos de espera compatibles con PostgreSQL. Según la cantidad de eventos y tipos de espera, se muestran los diez eventos y tipos de espera más importantes. Si hay más de diez eventos de espera, se muestran los nueve principales, y el resto se agrupa en la categoría Otros. Este enfoque también se aplica a otras dimensiones, como Búsquedas, Bases de datos y Usuarios.

Consulta los principales contribuyentes a la carga de la base de datos

Con la tabla Dimensiones principales por carga de base de datos, puedes ver los principales contribuyentes a la carga de la base de datos para el intervalo de tiempo y la dimensión seleccionados en el gráfico Carga de base de datos. Según la dimensión que elijas en la tabla Dimensiones principales por carga de base de datos, puedes encontrar los valores principales del período seleccionado.

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. Elige el tiempo de ejecución total para el que deseas mostrar datos, por ejemplo, 1 o 6 horas, o un tiempo personalizado.

  6. En la tabla Dimensiones principales por carga de base de datos, puedes hacer clic en cualquiera de los siguientes elementos:

    Dimensión Descripción
    Consultas La tabla muestra las principales consultas normalizadas por tiempo de ejecución total. Para cada consulta, los datos que se muestran en las columnas se enumeran de la siguiente manera:
    • Tiempo de ejecución promedio (ms) Es el tiempo promedio en el que se ejecutará la consulta.
    • Tiempo total de ejecución (ms) Es el tiempo total de ejecución que tarda la consulta específica.
    • Filas mostradas. Es la cantidad promedio de filas recuperadas para la consulta.
    • Cantidad de llamadas. La cantidad de veces que la aplicación llamó a la consulta.
    • %de carga por dimensión del gráfico. El gráfico de píldoras muestra cómo se distribuye la dimensión del gráfico para la consulta específica.
    Tipos de eventos de espera La tabla muestra la lista de los principales tipos de eventos de espera que se produjeron durante el período seleccionado.
    • Tiempo promedio de espera (ms) Es el tiempo promedio que las consultas permanecieron en el tipo de evento de espera específico.
    • Tiempo total de espera (ms). Es el tiempo de ejecución total que las consultas dedicaron al tipo de evento de espera específico.
    • Recuento de tipos de eventos de espera. Es la cantidad de veces que se produjo un tipo de evento de espera específico en el intervalo de tiempo elegido.
    • %de carga por dimensión del gráfico. El gráfico de píldoras muestra cómo se distribuye la dimensión del gráfico seleccionada en el menú desplegable del gráfico de carga de la base de datos en el tipo de evento de espera específico.
    Eventos de espera La tabla muestra la lista de los eventos de espera principales que se produjeron durante el período seleccionado.
    • Tiempo promedio de espera (ms) Es el tiempo promedio que las consultas permanecieron en el evento de espera específico.
    • Tiempo total de espera (ms). Es el tiempo de ejecución total que las consultas dedicaron al evento de espera específico.
    • Recuento de eventos de espera. Es la cantidad de veces que ocurrió un evento de espera específico en el intervalo de tiempo elegido.
    • %de carga por dimensión del gráfico. El gráfico de píldoras muestra cómo se distribuye la dimensión del gráfico seleccionada en el menú desplegable del gráfico de carga de la base de datos en el evento de espera específico.
    Base de datos En la tabla, se muestra la lista de las bases de datos principales que contribuyeron a la carga durante el período elegido en todas las consultas ejecutadas.
    • Tiempo promedio en la base de datos (ms) Es el tiempo promedio que las consultas pasaron en la base de datos específica.
    • Tiempo total que se usó la base de datos (ms). Es el tiempo de ejecución total que las consultas dedicaron a la base de datos específica.
    • %de carga por dimensión del gráfico. El gráfico de píldoras muestra cómo se distribuye la dimensión del gráfico seleccionada en el menú desplegable del gráfico de carga de la base de datos en la base de datos específica.
    Usuario En la tabla, se muestra la lista de los usuarios principales del período elegido en todas las consultas ejecutadas.
    • Tiempo promedio en el usuario (ms) Es el tiempo promedio que las consultas permanecieron en el usuario específico.
    • Tiempo total que se usó el usuario (ms). Es el tiempo de ejecución total que las consultas dedicaron al usuario específico.
    • %de carga por dimensión del gráfico. El gráfico de píldoras muestra cómo se distribuye la dimensión del gráfico seleccionada en el menú desplegable del gráfico de carga de la base de datos en el usuario específico.

Cómo ver el tiempo de ejecución de la consulta

Las funciones avanzadas de estadísticas de consultas para AlloyDB muestran las diez consultas principales que contribuyen a la carga de la base de datos en la tabla Dimensiones principales por carga de base de datos. La consulta principal es la que más contribuyó a la carga de la base de datos para el intervalo de tiempo seleccionado. Las consultas posteriores son un porcentaje del tiempo de ejecución más largo.

Para obtener información sobre cómo el tiempo de ejecución de un parámetro en la tabla Dimensiones principales por carga de base de datos se ve afectado por los diferentes valores de la dimensión del gráfico seleccionada (consultas, tipos de eventos de espera, eventos de espera, bases de datos y usuarios), sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. Consulta el % de carga por dimensión del gráfico en la tabla Dimensiones principales por carga de base de datos para saber cómo un parámetro de la tabla se ve afectado por los parámetros del gráfico Carga de la base de datos.

    Por ejemplo, cuando seleccionas Todas las consultas en el gráfico Carga de la base de datos y haces clic en la pestaña Consultas en la tabla Dimensiones principales por carga de base de datos, % de carga por consultas muestra una lista de las consultas que contribuyeron con la mayor carga de la base de datos en la base de datos seleccionada durante el período determinado.

Consulta los detalles del tiempo de ejecución de la consulta

Puedes ver detalles sobre el tiempo de ejecución de la consulta en Más detalles, incluidas las dimensiones que seleccionaste en el gráfico y la tabla de carga de la base de datos, la definición de cada evento de espera y los datos que se encapsulan en la categoría Otros.

Más detalles también muestra detalles de información compleja que no se muestra en ningún otro lugar de la pantalla de detalles de la consulta. Esta información incluye la definición de cada evento de espera.

Para ver los detalles sobre el tiempo de ejecución de la consulta, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. En la tabla Dimensiones principales por carga de base de datos, haz clic en Más detalles para ver una consulta.

Las funciones avanzadas de estadísticas de consultas para AlloyDB muestran consultas normalizadas ($1, $2, etcétera) para reemplazar los valores constantes literales. Por ejemplo:

UPDATE
  "demo_customer"
SET
  "customer_id" = $1::uuid,
  "name" = $2,
  "address" = $3,
  "rating" = $4,
  "balance" = $5,
  "current_city" = $6,
  "current_location" = $7
WHERE
  "demo_customer"."id" = $8

El valor constante se ignora para que las estadísticas de consulta avanzadas puedan agregar consultas similares y quitar cualquier información de identificación personal (PII) que la constante pueda mostrar.

Determina la carga de la base de datos para las consultas normalizadas

Para mostrar una medición del tiempo y el uso de recursos por ejecución de consulta (en segundos de CPU) que la consulta normalizada que seleccionaste realizó en la base de datos seleccionada a lo largo del tiempo, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. Haz clic en Consultas en el gráfico Carga de la base de datos. Para calcular la carga de la base de datos, el gráfico Carga de la base de datos usa la cantidad de tiempo que tardan las consultas normalizadas que se completan en el límite de minutos en comparación con el tiempo real transcurrido.

En la parte superior del gráfico Carga de la base de datos, se muestran los primeros 10 KB de caracteres de la consulta normalizada, donde se quitan los literales por motivos de agregación y de información de identificación personal (PII).

Para ayudar a determinar la distribución del tiempo transcurrido en cada uno de estos estados, las funciones avanzadas de estadísticas de consultas de AlloyDB se distribuyen por cargas de consultas normalizadas en eventos de espera y tipos de eventos de espera.

Puedes estudiar la latencia de las consultas con los gráficos de Latencia. La latencia es el tiempo que la búsqueda normalizada tarda en completarse en tiempo real transcurrido. La latencia de las consultas paralelas se mide en tiempo real transcurrido, aunque la carga de la base de datos puede ser mayor para la consulta debido a que se usan varios núcleos para ejecutar parte de ella.

Puedes filtrar por percentil para ver los percentiles 50, 95 o 99 y detectar las consultas que no cumplen con el tiempo de ejecución esperado. Para analizar la latencia histórica de la consulta normalizada, cambia el período.

Analiza las consultas normalizadas

Los planes de consultas te ayudan a comprender y analizar las consultas normalizadas, ya que proporcionan un desglose de las diferentes operaciones en una muestra de tu consulta.

El plan de consulta de muestra proporciona una vista EXPLAIN ANALYZE para los ejemplos de plan de consulta que están relacionados con la consulta normalizada. Estos son planes de consultas ejecutados que proporcionan un desglose del tiempo activo que realizó cada operación en el plan de consultas.

Para ver un plan de consulta de muestra, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. Elige el tiempo de ejecución total para el que deseas mostrar datos, por ejemplo, 1 o 6 horas, o un tiempo personalizado.

  6. En la tabla Dimensiones principales por carga de base de datos, haz clic en una consulta.

  7. En Muestras de planes de consultas, haz clic en cualquiera de los puntos del gráfico para ver un plan de consultas de esa consulta.

Supervisa y soluciona problemas de rendimiento de las aplicaciones con etiquetas

Las estadísticas de consultas avanzadas proporcionan supervisión centrada en la aplicación y simplifican el diagnóstico del rendimiento de las aplicaciones compiladas con asignaciones relacionales de objetos (ORM). El etiquetado de consultas te ayuda a encontrar problemas en construcciones de nivel superior, como el uso de la lógica empresarial, un microservicio o alguna otra construcción. Puedes usar etiquetas en tu aplicación para hacer lo siguiente:

  • Supervisa el rendimiento de la base de datos.
  • Usa Sqlcommenter para identificar problemas de rendimiento causados por el código de la aplicación.
  • Analiza la carga de la base de datos.
  • Consulta la carga por etiqueta.

Para obtener información sobre cómo usar etiquetas en las estadísticas de consultas, consulta Usa las estadísticas de consultas para mejorar el rendimiento de las consultas.

Soluciona problemas de aplicaciones en la capa de base de datos

Las estadísticas de consultas avanzadas proporcionan una vista de seguimiento de contexto y de extremo a extremo para ayudarte a comprender los problemas con la aplicación en la capa de la base de datos para una solicitud específica. Los seguimientos de aplicaciones de extremo a extremo en contexto te ayudan a determinar la fuente de la consulta problemática, por ejemplo, por modelo, vista, controladores y ruta.

Cuando habilitas OpenTelemetry, la información del intervalo se envía a la base de datos junto con la información de la etiqueta dentro de los comentarios de SQL. Los seguimientos de la aplicación a Cloud Logging se vinculan con los seguimientos del plan de consulta de la base de datos para identificar el origen del problema.

Para ver un seguimiento en contexto, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Clústeres.

    Ir a los clústeres

  2. En la lista de clústeres e instancias, haz clic en una instancia.

  3. Haz clic en Estadísticas de consultas.

  4. Elige la base de datos y el usuario.

  5. Haz clic en cualquier entrada de la tabla Dimensiones principales por carga de base de datos.

  6. En la página Detalles de las estadísticas de consultas, haz clic en DE ARRIBA ABAJO.

También puedes usar Cloud Trace para ver el seguimiento de extremo a extremo de cada paso en el plan de consulta. Para acceder a Cloud Trace, selecciona Operaciones > Seguimiento.

Preguntas frecuentes

En esta sección, se proporcionan respuestas a las preguntas frecuentes sobre las funciones de estadísticas de consultas avanzadas.

¿Por qué se trunca la cadena de consulta?

De forma predeterminada, las estadísticas de consultas avanzadas muestran 10 KB en cadenas de consulta. Puedes aumentar la visualización a 100 KB.

¿Por qué la carga de la CPU está por encima de la línea de núcleos máximos en el gráfico Carga de la base de datos?

La carga de la CPU representa el tiempo de ejecución y el tiempo de espera para que el programador de Linux programe el proceso del servidor en ejecución, por lo que, como resultado, la carga de la CPU puede superar la línea de núcleos máximos.

¿Puedo usar las métricas de estadísticas de consultas estándar?

Sí. Las estadísticas de consultas estándar generan contadores a los que se puede acceder a través de Stackdriver. Estas métricas están disponibles con la API de Cloud Monitoring y las estadísticas de consultas avanzadas. Para obtener más información, consulta Métricas deGoogle Cloud .

¿Cuál es la longitud máxima de la cadena de consulta?

En el caso del complemento de estadísticas de búsqueda estándar, la longitud máxima de la cadena de búsqueda se limita a 4.5 KB de caracteres. En el caso de las estadísticas de consultas avanzadas, la longitud de la cadena predeterminada es de 10 KB y la longitud máxima se limita a 100 KB.

¿Puedo usar las funciones avanzadas de estadísticas de consultas para AlloyDB en la replicación entre regiones?

No puedes habilitar las funciones de estadísticas de consultas avanzadas para AlloyDB en clústeres con instancias secundarias. Antes de crear una instancia secundaria en un clúster, debes inhabilitar las funciones de estadísticas de consultas avanzadas de AlloyDB en todas las instancias del clúster si ya están habilitadas.

¿Qué sigue?