Puedes supervisar las métricas de ejecución de queries a nivel de operación para las formas del query con queries lentos usando Query Shape Perspectivas. La página Query Shape Insights muestra gráficas y una tabla que describen las métricas de rendimiento para las formas del query con mayor tiempo total de ejecución en tu Proyecto. Puedes filtrar los datos mostrados por host, partición y rango de tiempo, y seleccionar hasta cinco formas del query para visualizar en las gráficas de métricas correspondientes.
Atlas solo es compatible con forma del query perspectivas en clústeres dedicados (M10 y superiores) que ejecutan MongoDB versión 8.0 o superiores.
Cómo Atlas recopila estadísticas de forma del query
Query Shape Insights muestra datos de un subconjunto de las operaciones que se ejecutan en su clúster. El método de colección depende de la versión de MongoDB de su clúster:
En los clústeres que ejecutan MongoDB 8.x, Atlas registra hasta 100 queries de lectura por segundo en cada host. Atlas no recopila operaciones de guardar.
En los clústeres que ejecutan MongoDB 9.0 o posterior, Atlas muestrea aleatoriamente el 1% de las operaciones de lectura y escritura por defecto. Los valores de las métricas mostradas reflejan solo las operaciones de muestra, aproximadamente el 1% del total de operaciones. Las formas del query que se ejecutan con poca frecuencia pueden no aparecer en los resultados. Este método también recopila operaciones de escritura (
insert,updateydelete), que aparecen en Perspectivas de forma del query junto con las operaciones de lectura.
Nota
Después de actualizar un clúster de MongoDB 8.x a 9.0, los totales de métricas en la perspectiva de forma del query pueden parecer significativamente diferentes que antes de la actualización. Esta diferencia refleja el cambio en el método de muestreo, no un cambio en la carga de trabajo de su clúster.
Acceso requerido
Para ver métricas con forma del query perspectivas, debe tener acceso a Project Observability Viewer, Project Data Access Read Only, Project Data Access Read/Write, Project Data Access Admin o Project Owner en el proyecto.
Importante
Las formas de consulta que exponen nombres de campos pero ocultan valores pueden contener ISI del usuario. Para ver formas del query truncadas o completas en Query Shape Perspectivas, debe tener uno de los roles de proyecto mencionados anteriormente, que le permiten acceder a ver PII. Para los usuarios sin estos permisos, Query Shape Insights identifica la forma del query por su hash de forma de consulta.
Acceso a perspectivas de la forma del query
Para acceder a forma del query perspectivas:
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Filtro Query Perspectivas
Puedes filtrar la página Query Insights por nodo, estado del nodo (principal o secundario) y partición. También puedes filtrar por un rango de fechas personalizado dentro de los últimos siete días o seleccionar uno de los siguientes rangos de tiempo preestablecidos:
7 días
5 días
2 días
24 horas (por defecto)
12 horas
8 horas
1 hora
Cuando aplicas un filtro, Atlas vuelve a obtener los datos para las gráficas y la tabla en la pantalla actual.
Nota
Los nodos de análisis se incluyen cuando filtras por estado de nodo secundario.
Ver métricas en tablas y Charts
Query Shape Perspectivas muestra gráficas y una tabla que describen métricas para las formas del query en tu Proyecto con queries de ejecución lenta.
La tabla de Perspectivas de forma del query contiene una fila para cada una de las principales formas del query en tu Proyecto, donde las formas del query principales se determinan por el mayor tiempo total de ejecución. Cada fila contiene la forma del query o su hash de forma del query, el namespace de la forma del query, el comando de query y cualquier métricas que elija mostrar. Puedes usar el botón Edit Columns para elegir cuáles de las siguientes métricas incluir como columnas de la tabla:
Métrica | Descripción |
|---|---|
Tiempo total de ejecución | |
Tiempo medio de ejecución | |
Recuento de ejecuciones | Número total de veces que se han ejecutado queries con la forma del query dada. |
Claves examinadas | Número total de claves de índice dentro y fuera de los límites examinadas por queries con la forma del query dada. |
Claves examinadas:devueltas | Proporción entre las claves índice dentro y fuera de los límites examinadas y los índices que contienen documentos devueltos por queries con la forma del query dada. |
Docs examinados | Número total de documentos examinados por queries con la forma del query dada. |
Docs devueltos | Número total de documentos devueltos por queries con la forma del query dada. |
Docs examinados: devueltos | Proporción de documentos examinados respecto a documentos devueltos por consultas con la forma del query dada. |
Docs coincidentes | Número total de documentos coincidentes con las query con la forma del query dada. Disponible solo para comandos de guardar en clústeres que ejecutan MongoDB 9.0 o versiones posteriores. |
Docs modificados | Número total de documentos modificados por queries con la forma del query dada. Disponible solo para comandos de guardar en clústeres que ejecutan MongoDB 9.0 o versiones posteriores. |
Docs insertados o actualizados | Número total de documentos upserted por queries con la forma del query dada. Disponible solo para comandos de guardar en clústeres que ejecutan MongoDB 9.0 o versiones posteriores. |
Docs Insertados | Número total de documentos insertados por queries con la forma del query dada. Disponible solo para comandos de guardar en clústeres que ejecutan MongoDB 9.0 o versiones posteriores. |
Docs borrados | Número total de documentos borrados por queries con la forma del query dada. Disponible solo para comandos de guardar en clústeres que ejecutan MongoDB 9.0 o versiones posteriores. |
Claves insertadas | Número total de claves de índice insertadas por queries con la forma del query dada. Disponible solo para comandos de guardar en clústeres que ejecutan MongoDB 9.0 o versiones posteriores. |
Claves borradas | Número total de claves de índice borradas por query con la forma del query dada. Disponible solo para comandos de guardar en clústeres que ejecutan MongoDB 9.0 o versiones posteriores. |
Tiempo total de respuesta | Tiempo en microsegundos transcurrido desde el comienzo del procesamiento de la query hasta la primera respuesta del servidor. |
Última hora de ejecución | Tiempo de ejecución en microsegundos para el query más reciente con la forma del query dada. |
Tiempo de ejecución de P50 | 50percentil en el histograma de tiempo de ejecución. |
Tiempo de ejecución de P90 | 90percentil en el histograma de tiempo de ejecución. |
Tiempo de ejecución de P99 | 99percentil en el histograma de tiempo de ejecución. |
También puedes mostrar gráficos para una o más de las métricas anteriores seleccionando cada métrica que desees gráficas desde el menú desplegable en el encabezado del componente Query Shape Statistics.
Atlas puede graficar cada métrica para hasta cinco formas (shapes) de consulta a la vez. Por defecto, Atlas Charts cada métrica para las cinco formas de consulta con el Total Execution Time más alto. Puedes optar por graficar diferentes formas de consulta seleccionando o deseleccionando la casilla de verificación en la fila de las formas de consulta que desees. Puedes gestionar qué formas de consulta graficar desde la tabla, seleccionando o desmarcando la casilla de verificación en la fila de las formas de consulta que desees.
Para ver más detalles sobre la forma del query, haz clic en la fila correspondiente para abrir la vista Query Shape Details. Esta vista contiene la forma completa del query y el hash de la forma del query, el registro de cada métrica de tabla mencionada anteriormente, y las siguientes métricas adicionales:
Sello de tiempo de última visualización
Primera marca de tiempo vista
Última aplicación vista
Nombre y versión del controlador vistos por última vez
Primera vez que se ve la Aplicación
Nombre y versión del controlador vistos por primera vez
Informes de forma del query
Atlas puede enviarle un correo electrónico de informe de forma del query que resume las formas del query ineficientes para un clúster en su Proyecto. Para ayudarle a identificar e investigar query lentos, el informe enlaza directamente con la página Query Shape Insights.
Elegibilidad
Atlas suscribe automáticamente un Proyecto a los informes de forma del query cuando el Proyecto cumple los siguientes criterios:
El Proyecto recibe una
Query Targeting: Scanned Objects / Returnedalerta.La alerta se origina en un clúster dedicado (M10 o superior) que ejecuta la versión 8.0 de MongoDB o superior.
Los usuarios deProject Owner también pueden suscribirse o cancelar su suscripción manualmente a los informes de Query Shape, independientemente de si el proyecto ha recibido una alerta de segmentación de consultas. Para obtener más información, consulte Administrar suscripciones a informes.
Denunciar comportamiento
Atlas envía informes de forma del query según el siguiente cronograma:
Cuando un Proyecto cumple los requisitos, Atlas envía el primer informe aproximadamente una hora después de la alerta
Query Targeting: Scanned Objects / Returned.Atlas envía informes adicionales aproximadamente una vez por semana hasta que el Proyecto se dé de baja.
Atlas envía cada informe a todos los usuarios con el rol de Project Owner.
Si no existen formas de query calificadas para un período de reporte determinado, Atlas omite ese reporte y reanuda con el siguiente reporte programado.
Contenido del informe
Cada correo electrónico del informe de forma del query contiene la siguiente información:
Enlaces a la organización, el Proyecto y el clúster en la Interfaz de Usuario de Atlas.
Un enlace a la página Query Shape Insights del clúster.
Una tabla de hasta cinco formas del query, clasificadas por el tiempo total de ejecución. Cada forma del query debe tener al menos 10 ejecuciones en el período del reporte para aparecer.
Un enlace a los detalles de cada forma del query en la página Query Shape Insights.
Un enlace a la configuración de suscripción de informes en Project Settings. Para aprender más, consulta Gestionar la configuración del proyecto.
La tabla de formas del query incluye las siguientes métricas para cada forma del query durante los últimos tres días:
columna | Descripción |
|---|---|
Nombre de colección | Nombre de la colección a la que apunta la forma del query. |
Tiempo promedio de ejecución | Tiempo promedio dedicado a ejecutar query con la forma del query dada. |
Recuento de ejecuciones | Número total de veces que se ejecutaron query con la forma del query dada. |
Docs examinados:Relación devuelta | Proporción de documentos examinados respecto a documentos devueltos por consultas con la forma del query dada. |
Gestionar suscripciones de informes
Puede suscribirse o anular la suscripción a los informes de forma del query en la configuración de su Proyecto. Esta configuración controla los informes para todos los usuarios del Proyecto. Solo los usuarios con el rol Project Owner pueden cambiar la suscripción, y solo los usuarios Project Owner reciben los informes.
Para gestionar informes de forma del query:
En Atlas, diríjase a la página Project Settings.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en el icono junto a Project Overview.
- La página Configuración del Proyecto
- se muestra.
Activa el ajuste Query Shape Reports.
Activa el interruptor para suscribirte o desactívalo para cancelar la suscripción. Cuando te suscribas por primera vez, selecciona el clúster o los clústeres que quieres que cubra el informe. El cambio se aplica a todos los Project Owner usuarios del Proyecto.
También puede darse de baja haciendo clic en el enlace para darse de baja en cualquier correo electrónico del informe de forma del query. El enlace le dirige a Project Settings, donde Atlas da de baja el Proyecto. El enlace para darse de baja funciona sin necesidad de que inicie sesión.
Limitaciones
Los informes de forma del query tienen las siguientes limitaciones:
La configuración de suscripción se aplica a todo el proyecto. No puede suscribir o anular la suscripción de usuarios individuales.
Los informes de forma del query no están disponibles a través de la Atlas Administration API.
Seleccione formas del query para la gráfica
Por defecto, Query Shape Insights muestra gráficos de métricas para las cinco principales forma del query con el mayor Total Execution Time. Puede seleccionar hasta cinco forma del query para graficar en la tabla Query Shape Insights.
Buscar y seleccionar forma del query en la tabla Query Shape Insights:
(Opcional) Filtrar entradas de la tabla.
Puede filtrar la tabla Query Shape Insights por las siguientes categorías:
Forma del query: En el cuadro de búsqueda Search by Query Shape, introduce la forma del query o su hash de query asociado.
Espacio de nombres: En el menú desplegable Select Namespaces, selecciona uno o más espacios de nombres por los que filtrar.
Comando: En el menú desplegable Select Commands, seleccione uno o más comandos por los que filtrar.
(Opcional) Cambia el orden de clasificación.
Puedes ordenar la tabla Query Shape Insights por una o más columnas de métricas para ayudar a identificar qué formas del query graficar.
Para ordenar por una métrica en orden descendente o ascendente, haz clic en el icono sort junto al nombre de la columna asociada una o dos veces, respectivamente. Para ordenar por varias columnas, presione Shift y haga clic en los iconos sort en el orden en el que desea ordenar múltiplemente la tabla.