Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
MongoDB Branding Shape
Click here >
Docs Menu

Supervisar estadísticas de las formas del query con Query Shape Perspectivas

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.

Nota

Para garantizar el rendimiento y la escalabilidad en clústeres con un alto volumen de queries, Query Shape Insights puede mostrar datos de un conjunto de muestras del total de queries ejecutadas en tu clúster.

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.

Para acceder a forma del query perspectivas:

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

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

2
  1. Haz clic en el nombre del clúster para abrir la barra lateral Cluster.

  2. Haz clic en Query Insights en la barra lateral de Cluster.

    La pestaña Query Shapes se muestra por defecto.

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.

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 total en microsegundos dedicado a ejecutar queries con la forma del query dada. Si la query resultó en getMore comandos, esta métrica incluye el tiempo dedicado al procesamiento de las solicitudes de getMore. Esta métrica no incluye el tiempo dedicado a esperar por el cliente.

Tiempo medio de ejecución

Tiempo promedio en microsegundos empleado en la ejecución de queries con la forma del query dada. Si la query resultó en getMore comandos, esta métrica incluye el tiempo dedicado a procesar las solicitudes getMore. Esta métrica no incluye el tiempo que se pasa esperando al cliente.

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.

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

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:

1

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.

2

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.

3

Has clic en la casilla de verificación en la fila de la forma del query deseada.

Puede seleccionar hasta cinco formas de consulta a la vez.