Analiza las estadísticas de rendimiento de las consultas

En esta página, se describe cómo usar el panel de Estadísticas de consultas para detectar y analizar el rendimiento de las consultas.

Descripción general de las estadísticas de consultas

Usa el panel de Estadísticas de consultas para supervisar las preguntas relacionadas con las métricas. Según las métricas, puedes identificar las consultas que se usan con mayor frecuencia y las que tienen latencias altas que podrían requerir optimización. Usa el panel de Estadísticas de consultas para obtener ayuda con lo siguiente:

  • Optimización del rendimiento de las consultas: Identifica las consultas con latencias altas y que podrían necesitar optimización.
  • Administración de costos de las consultas: Descubre las consultas de alto costo y optimízalas para reducir los costos.
  • Supervisión de estadísticas de consultas: Realiza un seguimiento de las estadísticas de consultas a lo largo del tiempo.
  • Recomendaciones de índices: Identifica los índices compuestos faltantes o subóptimos y crea índices recomendados directamente desde el panel (edición Enterprise).

Datos de las estadísticas de consultas

Las Estadísticas de consultas incluyen datos de los siguientes métodos de la API:

Puedes ver datos sobre las consultas que usan estos métodos para un proyecto, una base de datos y un período determinados que van de 1 minuto a 30 días. Los datos de las búsquedas con estructuras equivalentes se capturan en una sola búsqueda normalizada.

Estadísticas de consultas devuelve la siguiente información sobre una consulta:

Texto de la búsqueda normalizado Es la estructura de la búsqueda representada en texto.
Cantidad de ejecuciones Cantidad de ejecuciones en el período seleccionado.
Cantidad de errores Cantidad de errores en el período seleccionado.
Duración promedio de la ejecución (ms) Es el tiempo promedio en milisegundos que tardó la base de datos en procesar la consulta.
Cantidad promedio de resultados devueltos Es la cantidad de resultados que devuelve la búsqueda. Los resultados incluyen documentos, IDs de colección y buckets agregados.
Cantidad promedio de documentos analizados Es la cantidad de documentos analizados en una búsqueda.
Cantidad promedio de entradas de índice analizadas Es la cantidad de entradas de índice examinadas para ejecutar la consulta.
Carga por tiempo promedio Son los datos que ayudan a filtrar las principales búsquedas según la latencia promedio.
Carga por operaciones de lectura totales (facturables) Son los datos que ayudan a filtrar las principales búsquedas según las operaciones de lectura facturables totales.
Recomendaciones de índice Índices compuestos recomendados, índices usados y el impacto estimado de la carga de trabajo para las consultas en las bases de datos de Enterprise Edition.

Nivel de detalle y retención de datos

El nivel de detalle de los datos depende de la duración especificada:

  • Nivel de detalle de 1 minuto para intervalos de hasta 6 horas atrás
  • Nivel de detalle de 10 minutos para intervalos de hasta 4 días atrás
  • Detalle de 1 hora para intervalos de hasta 30 días atrás

La retención de datos máxima para las Estadísticas de consultas es de 30 días. Los datos de 1 minuto se almacenan durante 6 horas, los datos de 10 minutos se almacenan durante 4 días y los datos por hora se almacenan durante 30 días.

Ver las estadísticas de consultas

Para ver las estadísticas de consultas de una base de datos de Firestore, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Bases de datos.

    Ir a Bases de datos

  2. En la lista de bases de datos, selecciona una.

  3. En el menú de navegación, haz clic en Estadísticas de consultas.

En la página Estadísticas de consultas, se muestra un gráfico de series temporales de tus consultas principales junto con una tabla de estadísticas de consultas normalizadas. Para analizar el rendimiento de las consultas, sigue estos pasos:

  • Selecciona un intervalo de tiempo para ver las tendencias históricas o las métricas casi en tiempo real en intervalos de 1 minuto.
  • Usa la lista Tipo de carga para clasificar las principales consultas por latencia promedio o por operaciones de lectura totales.
  • Selecciona consultas individuales en la tabla para trazar y comparar sus recuentos de ejecución, latencia, documentos analizados, entradas de índice analizadas y recuentos de errores en el gráfico.

Recomendaciones de índice

Las recomendaciones de índices para Estadísticas de consultas identifican automáticamente las configuraciones de índices compuestos faltantes o deficientes para las formas de consulta que se ejecutan con frecuencia en las bases de datos de Firestore Enterprise.

En la edición Enterprise de Firestore, las consultas se pueden ejecutar incluso sin índices compuestos coincidentes, lo que puede generar análisis lentos de colecciones completas o operaciones de ordenamiento en memoria. En el panel de Estadísticas de consultas, se analizan las estadísticas históricas de ejecución de consultas y se sugieren índices compuestos específicos para optimizar la latencia de las consultas y reducir los documentos analizados facturables.

Cómo funcionan las recomendaciones de índices

Una canalización por lotes sin conexión evalúa periódicamente las consultas principales históricas:

  • Análisis de la estructura de consultas: Extrae predicados de igualdad, ordenación y rango de las consultas que se ejecutan con frecuencia.
  • Generación de índices candidatos: Genera definiciones de índices compuestos potenciales con heurísticas de ordenamiento de índices (Igualdad > Ordenar > Rango).
  • Evaluación del optimizador: Inserta índices candidatos en el modelo de costos del motor de consultas para comparar los costos de ejecución de consultas de referencia con los planes de ejecución indexados hipotéticos.
  • Clasificación del impacto en la carga de trabajo: Clasifica los índices recomendados en niveles de impacto según el ahorro total estimado en el costo de la carga de trabajo:
    • ALTO: Convierte los análisis de colecciones completas en búsquedas de índices selectivas, lo que reduce significativamente las lecturas de documentos y la latencia de ejecución.
    • MEDIUM: Elimina las operaciones costosas, como la ordenación en memoria, ya que proporciona resultados de índice ordenados previamente.
    • BAJO: Ofrece mejoras menores en la búsqueda.
Para ver las recomendaciones de índices y crear los índices sugeridos desde la consola deGoogle Cloud , haz lo siguiente:

  1. En la consola de Google Cloud , navega a la página Bases de datos.

    Ir a Bases de datos

  2. En la lista de bases de datos, selecciona una base de datos de Enterprise edition.

  3. En el menú de navegación, haz clic en Estadísticas de consultas.

  4. En la tabla de consultas, selecciona una forma de consulta para ver su tarjeta de Recomendaciones. En la tarjeta, se muestra lo siguiente:

    • La definición del índice compuesto recomendado (colección, campos, órdenes de clasificación o propiedades array-contains)
    • Es el nivel de impacto estimado de la carga de trabajo (HIGH, MEDIUM o LOW).
    • Los índices que se usaron o una indicación de que se realiza un análisis completo de la colección.
  5. Haz clic en Crear índice en la tarjeta de recomendación. Se abrirá un diálogo con la colección, el alcance de la consulta y los campos prepropagados.

  6. Haz clic en Crear para comenzar a compilar el índice. Puedes supervisar el progreso de la compilación del índice en la página Índices de la consola de Google Cloud .

Ediciones y modos compatibles

Las recomendaciones de índices son compatibles con las bases de datos de la edición Enterprise de Firestore, incluidas las siguientes:

  • Firestore en modo nativo
  • Firestore compatible con MongoDB

Las bases de datos de la edición Standard no son compatibles con las recomendaciones de índices.

Limitaciones

  • Los objetos de escucha en tiempo real no se incluyen en las estadísticas de Estadísticas de consultas.
  • Los datos de Estadísticas de consultas están disponibles minutos después de la ejecución de la consulta.
  • Las recomendaciones de índices se generan de forma periódica en función de los datos históricos de las consultas, no en tiempo real.
  • Las recomendaciones de índices sugieren índices compuestos nuevos, pero no sugieren modificar ni borrar los índices existentes.
  • No se admite la creación automática de índices; los índices recomendados se deben crear de forma manual.
  • La normalización de consultas reemplaza los valores literales por marcadores de posición. Las recomendaciones de índices se basan en plantillas de consultas normalizadas, en lugar de valores de entorno de ejecución específicos.
  • La evaluación de costos usa heurística en lugar de muestreo de datos en vivo. Es posible que los índices recomendados no mejoren el rendimiento en todas las situaciones, y la creación de un índice agrega sobrecarga de escritura y almacenamiento.

Precios

No hay costo adicional por las estadísticas de consultas ni las recomendaciones de índices.

Roles obligatorios

Para obtener los permisos que necesitas para ver el panel de Estadísticas de consultas y crear índices recomendados, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para ver el panel de Estadísticas de consultas y crear índices recomendados. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver el panel de Estadísticas de consultas y crear índices recomendados:

  • Consulta las Estadísticas de consultas: datastore.insights.get
  • Crea índices recomendados:
    • datastore.indexes.create
    • datastore.indexes.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

¿Qué sigue?