Seleccionar métricas para gráficos en paneles

En este documento, se describe cómo configurar un gráfico en un panel personalizado para mostrar los datos de series temporales que recopila tu proyecto. Los gráficos solo pueden mostrar datos de series temporales numéricas. Para obtener información sobre la configuración del estilo de un gráfico, consulta Configura las opciones de vistas.

Selecciona los datos que se mostrarán

Para configurar qué series temporales mostrar cuando agregas gráficos a un panel, puedes crear una consulta mediante una selección en los menús o puedes escribir una consulta. Cuando escribes una consulta, debes seleccionar su lenguaje de consulta y, luego, usar un editor de consultas o una interfaz basada en texto:

Las consultas del lenguaje de consulta de supervisión (MQL) especifican las series temporales y cómo se agrupan y alinean esas series temporales. La interfaz de MQL es compatible con un editor de consultas con sugerencias y verificación de sintaxis.

Por lo general, no es posible convertir las consultas de MQL en formularios que las otras interfaces puedan usar. Las consultas no guardadas se descartan cuando accedes a la pestaña MQL o la cambias desde ella.
Las consultas del lenguaje de consulta de Prometheus (PromQL) especifican las series temporales y cómo se agrupan y se alinean. La interfaz de PromQL es compatible con un editor con sugerencias.

Por lo general, no es posible convertir las consultas de PromQL en formularios que las otras interfaces puedan usar. Las consultas no guardadas se descartan cuando accedes a la pestaña PromQL o la cambias desde ella.
Las consultas del filtro de Monitoring especifican las series temporales, pero no incluyen instrucciones de agrupación o alineación.

Cualquier serie temporal que Monitoring pueda graficar se puede especificar mediante un filtro de Monitoring. Por ejemplo, para graficar la cantidad de procesos que se ejecutan en una VM, debes usar un filtro de Monitoring que especifique una función.

No siempre es posible convertir un filtro de Monitoring en el formato que requieren otras interfaces. Por lo tanto, es posible que se descarte la consulta si cambias a una interfaz diferente.

Por lo general, las consultas especifican un tipo de métrica, un tipo de recurso y filtros:

Un tipo de métrica identifica las mediciones que se recopilarán de un recurso. En este, se incluye una descripción de lo que se mide y cómo se interpretan las mediciones. A veces, nos referimos a un tipo de métrica como una métrica. Un ejemplo de métrica es “Uso de CPU”. Para obtener información conceptual, consulta Tipos de métricas.
Un tipo de recurso especifica desde qué recurso se capturan los datos de métricas. A veces, el tipo de recurso se denomina tipo de recurso supervisado o recurso. Un ejemplo de un recurso es una “instancia de máquina virtual (VM) de Compute Engine”. Para obtener información conceptual, consulta Recursos supervisados.

Las consultas de MQL y PromQL incluyen instrucciones de agrupación y alineación. Sin embargo, cuando escribes un filtro de Monitoring o usas menús para seleccionar las series temporales a fin de graficarlas, debes establecer la configuración de agrupación y alineación a través de menús.

Crea consultas mediante menús

Para compilar tu consulta mediante menús, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
Si se muestra el botón Editar panel, haz clic en él.
Arrastra un widget de la biblioteca de widgets al panel o selecciona un widget que esté en el panel.

Los widgets del panel se configuran automáticamente con selecciones de muestra cuando se agregan a un panel. En los siguientes pasos, se describe cómo cambiar esas selecciones.
Selecciona la pestaña Básica o la pestaña Avanzada.

La pestaña Básico proporciona opciones de configuración mínimas, mientras que la pestaña Avanzada proporciona acceso a la mayoría de los campos de agrupación y alineación. Puedes cambiar de la pestaña Básica a la pestaña Avanzada y conservar la configuración. Sin embargo, si cambias de la pestaña Avanzada a la pestaña Básica, es posible que pierdas los ajustes de configuración.
Selecciona la métrica y el recurso que deseas representar:
1. Expande el menú Seleccionar una métrica.
2. Opcional: Para reducir la cantidad de opciones que se muestran en el menú, ingresa el nombre de la métrica o del recurso en la barra de filtros . Por ejemplo, cuando ingresas util, restringes el menú para mostrar las entradas que incluyen util. Las entradas se muestran cuando pasan una prueba que no distingue entre mayúsculas y minúsculas.
  
  Para ver una lista de todas las métricas, incluso aquellas sin datos recientes, activa la opción Mostrar solo recursos y métricas activos. De forma predeterminada, este botón de activación está habilitado para que solo las métricas y los recursos con datos se muestren en los menús.
3. En el menú Recurso, selecciona el recurso del que se capturan los datos de métricas.
  
  Cuando una métrica no se escribe en un recurso, selecciona Sin especificar.
4. En el menú Categoría de métrica, selecciona la categoría de la métrica.
  
  La categoría suele ser el primer término que sigue al prefijo de las métricas. Por ejemplo, para la métrica compute.googleapis.com/instance/utilization, la categoría es instance.
5. En el menú Métrica, selecciona la métrica que quieres graficar.
6. Haz clic en Aplicar.
Por ejemplo, para graficar el uso de CPU de una máquina virtual, puedes hacer lo siguiente:
1. Ingresa util en la barra de filtros .
2. En el menú Recursos, selecciona Instancia de VM.
3. En el menú Categorías de métricas, selecciona Instancia.
4. En el menú Métricas, selecciona Uso de CPU y, luego, haz clic en Aplicar.
Después de seleccionar el tipo de recurso y la métrica, el gráfico muestra todas las series temporales disponibles para ese par. En la siguiente captura de pantalla, se muestra un gráfico después de seleccionar el tipo de recurso y la métrica:

El gráfico anterior contiene más datos que se pueden mostrar. Los gráficos tienen un límite de 300 líneas. En el gráfico, se indica que hay demasiados datos para mostrar y se sugiere usar el modo de valores atípicos, lo que reduce en gran medida la cantidad de datos que se muestran. Para acceder a los controles del modo de valores atípicos, haz clic en Configuración. Si deseas obtener más información, consulta Cómo configurar las opciones de vistas.

También puedes usar las opciones de filtrado y agregación para reducir la cantidad de datos del gráfico. Estas técnicas aumentan la utilidad de los gráficos para los diagnósticos y análisis, y mejoran el rendimiento y la respuesta de la interfaz de usuario en sí misma.
Opcional: Agrega filtros para restringir las series temporales que se muestran. En la siguiente sección, se describen las opciones de filtrado.
Opcional: Configura cómo se agrupan y alinean las series temporales. Para obtener más información, consulta Elige cómo mostrar datos del gráfico.

Puedes reducir la cantidad de datos que se representarán si especificas criterios de filtro, aplicas agregación o usas el modo de valores atípicos. Los filtros garantizan que solo se usen series temporales que cumplan con un conjunto de criterios. Cuando aplicas filtros, puedes reducir la cantidad de líneas en el gráfico, lo que puede mejorar su rendimiento.

El resto de esta sección se aplica a la configuración de un gráfico cuando se utiliza una interfaz controlada por menús. Esta sección no se aplica a las configuraciones de MQL, PromQL ni Monitoring.

Cuando proporcionas varios criterios de filtrado, el gráfico correspondiente muestra solo las series temporales que cumplen con todos los criterios, un AND lógico. Por lo general, puedes filtrar por grupo de recursos, por nombre, por etiqueta de recurso, por zona y por etiqueta de métricas.

Para agregar un filtro cuando seleccionas el modo Básico o Avanzado, haz clic en Agregar filtro y, luego, especifica la etiqueta de filtro, la comparación y el valor o rango de valores:

Haz clic en Etiqueta y selecciona una entrada del menú.

Para buscar una etiqueta específica, puedes usar la barra de desplazamiento o ingresar texto en el área de texto Filtro. Cuando ingresas el texto, el menú solo enumera las entradas que contienen el texto ingresado.

En la siguiente captura de pantalla, se muestran las etiquetas de filtro comunes para una métrica específica:
Haz clic en Comparación y, luego, selecciona una entrada del menú. Puedes elegir entre cuatro operadores: igual, =, diferente, !=, coincidencia de expresión regular, =~, y expresión regular que no coincide, !=~:
Haz clic en Validate y, luego, realiza una de las siguientes acciones:
- Para una comparación directa, = o !=, selecciona el valor del menú o ingresa un valor y haz clic en Listo. Los valores ingresados pueden ser valores simples, como us-central1-a, o puedes crear una string de filtro que comience con starts_with o ends_with. Por ejemplo, para mostrar los datos de cualquier zona us-central1, puedes ingresar la string de filtro starts_with("us-central1"). Consulta Filtros de supervisión para obtener más información sobre las strings de filtro.
  
  Debido a que las entradas del menú derivan de la serie temporal recibida, cuando un recurso supervisado no genera datos para la métrica seleccionada, debes ingresar un valor para la etiqueta.
  
  En la captura de pantalla siguiente, se muestra el menú de valor para un proyecto en particular cuando se selecciona la etiqueta del recurso zone:
- Para una comparación de expresiones regulares, =~ o !=~, ingresa una expresión regular RE2 en el campo Valor y haz clic en Listo. Por ejemplo, la expresión regular us-central1-.* coincide con todas las zonas us-central1:
  
  Para hacer coincidir cualquier zona de EE. UU. que termine con “a”, puedes usar la expresión regular ^us.*.a$.
  
  No puedes usar expresiones regulares para filtrar la etiqueta de recurso project_id.
  
  Por ejemplo, para ver solo las series temporales de una de las zonas us-central1, aplica un filtro zone="starts_with("us-central1")" o zone=~"us-central1.*":

Puedes especificar varios criterios de filtro y usar la misma etiqueta varias veces. Estas capacidades te permiten especificar un filtro para un rango de valores. Se deben cumplir todos los criterios de, filtro, ya que constituyen un AND lógico. Por ejemplo, la siguiente es una configuración que puedes usar con las strings de filtro starts_with y ends_with para mostrar solo las zonas “a” en EE. UU.:

Ejemplo mediante varios filtros

Escribe consultas de MQL y PromQL

Para ingresar una consulta de MQL y PromQL, haz lo siguiente:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
Si se muestra el botón Editar panel, haz clic en él.
Arrastra un widget de la biblioteca de widgets al panel o selecciona un widget que esté en el panel.
Selecciona la pestaña MQL o PROMQL.
Ingresa tu consulta y haz clic en Ejecutar.

En este documento, no se describe cómo usar MQL o PromQL. Para obtener información sobre estos idiomas, consulta los siguientes documentos:

Escribir consultas de filtros de Monitoring

Cuando quieras realizar cualquiera de las siguientes acciones, debes usar el modo de filtro directo, que te permite ingresar un filtro de Monitoring:

Muestre un objetivo de nivel de servicio (SLO).
Muestra el recuento de los procesos que se ejecutan en máquinas virtuales (VM).
Muestre una métrica personalizada para la que aún no tenga datos.
Filtra una serie temporal según una etiqueta de la que aún no tienes datos.

Un filtro de Monitoring, o un filtro de métrica equivalente, es una expresión que Monitoring usa para identificar las series temporales que se representarán en el gráfico. Por ejemplo, la siguiente expresión da como resultado un gráfico que muestra un recuento de los procesos cuyo nombre incluye nginx:

 select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
 resource.type="gce_instance"

También puedes usar los filtros de Monitoring para identificar series temporales por su tipo de recurso y métrica. La siguiente expresión da como resultado un gráfico que muestra el recuento de entradas de registro para todas las instancias de máquinas virtuales de Google Cloud en la zona us-east1-b:

metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance"
resource.label."zone"="us-east1-b"

Para ingresar un filtro de métrica, sigue estos pasos:

En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
Ir a Monitoring
En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
Si se muestra el botón Editar panel, haz clic en él.
Arrastra un widget de la biblioteca de widgets al panel o selecciona un widget que esté en el panel.
Selecciona el modo Básico o Avanzado.
Haz clic en Ayuda en el menú Seleccionar una métrica y, luego, selecciona Modo de filtro directo.

En la página, se muestra un cuadro de texto. Si seleccionaste un tipo de recurso, una métrica o filtros antes de cambiar al modo Direct Filter Mode, esas configuraciones se muestran en el cuadro de texto.
Ingresa una expresión de filtro de Monitoring en el cuadro de texto. Para obtener información sobre la sintaxis, consulta los siguientes documentos:
Se muestra un error cuando usas el modo de filtro directo y no hay datos disponibles que satisfagan el filtro. Los mensajes de error comunes incluyen Chart definition invalid y No data is available for the selected timeframe.
Opcional: Configura cómo se agrupan y alinean las series temporales. Para obtener más información, consulta Elige cómo mostrar datos del gráfico.

Para volver a la interfaz basada en menús, haga clic en Modo estándar.

Elige cómo mostrar los datos del gráfico

Después de seleccionar los datos de series temporales, el siguiente paso es determinar cómo se muestran esos datos. Por ejemplo, ¿quieres mostrar cada serie temporal o quieres combinarlas?

Para especificar cómo se muestran los datos, configura las opciones de agregación. La agregación consiste en alinear datos de series temporales y, luego, combinar distintas series temporales. La combinación de series temporales es opcional.

Para obtener una explicación detallada de la agregación, consulta Filtrado y agregación: manipula series temporales.

Alinea datos

La alineación es el proceso de conversión de los datos de la serie temporal que recibe Monitoring en una nueva serie temporal que tiene datos en intervalos fijos. El proceso de alineación consiste en recopilar todos los datos recibidos en un período fijo, aplicar una función para combinar esos datos y asignar una marca de tiempo al resultado. Esa función podría calcular el promedio de todas las muestras o podría extraer el máximo de todas las muestras.

El Período de alineación especifica el intervalo mínimo que se usará para alinear datos de series temporales. Cuando hay demasiados datos para representar en el período de visualización seleccionado, el período de alineación aumenta de forma automática para que se represente cada dato. La configuración predeterminada para este campo es de un minuto.

El campo Función de alineación especifica la función que se usa para combinar todos los datos en un período de alineación. La mayoría de los alineadores realizan funciones matemáticas comunes. Por ejemplo, si seleccionas min, el dato alineado es el mínimo de todos los datos dentro del período de alineación.

Por ejemplo, considera una métrica con un período de muestreo de un minuto. Si se configura un gráfico a fin de que muestre 1 hora de datos, el gráfico puede mostrar los 60 datos. Si el período de alineación se establece en 10 minutes, el gráfico muestra 6 datos. Cuando el campo Función de alineación tiene un valor de media, cada punto del gráfico es el promedio de todos los puntos de un período de alineación. Sin embargo, si ahora configuras el gráfico para que muestre una semana de datos, entonces hay demasiados puntos para mostrar en el gráfico, por lo que el período se modifica automáticamente. En este ejemplo, el período de alineación modificado es de una hora.

Si bien la mayoría de los alineadores realizan funciones matemáticas comunes, algunos realizan acciones más complicadas:

Siguiente más antiguo: Para conservar solo la muestra más reciente dentro de un período de alineación, usa el alineador siguiente más antiguo. Este alineador se suele usar con verificaciones de tiempo de actividad y es una buena opción cuando solo te interesa el valor más reciente.

Este alineador solo es válido para las métricas de indicador.
Percentil: Para mostrar una métrica de distribución en un tipo de trazado de gráfico de líneas, un gráfico de áreas apiladas o un gráfico de barras apiladas, debes seleccionar el percentil de la distribución que se mostrará. Una forma de especificar este percentil es seleccionar un alineador del percentil. Puedes seleccionar los percentiles 5, 50, 95 y 99. Los datos alineados se determina mediante el cálculo del percentil especificado mediante todos los datos del período de alineación.

Este alineador solo es válido para las métricas de indicador y delta cuando tienen un tipo de datos de distribución.
Delta: Para convertir una métrica acumulativa o una delta en una métrica delta con una muestra por período de alineación, usa este alineador. Este alineador puede generar la interpolación de datos. Para ver un ejemplo, consulta Categorías, tipos y conversiones.

Este alineador solo es válido para métricas acumulativas y delta.
Rate: Para convertir una métrica acumulativa o delta en una métrica del indicador, usa este alineador. Si eliges este alineador, puedes pensar en la serie temporal que se transforma como con un alineador delta y, luego, dividir por el período de alineación. Por ejemplo, si la unidad de la serie temporal original es MiB y la unidad del período de alineación es segundo, el gráfico tiene una unidad de MiB por segundo. Para obtener más información, consulta Categorías, tipos y conversiones.

Este alineador solo es válido para métricas acumulativas y delta.

Para obtener más información sobre los alineadores disponibles, consulta Aligner en la referencia de la API.

Para acceder a los campos de alineación, haz lo siguiente:

Modo básico: Todos los campos de alineación están preconfigurados.
Modo avanzado: Todas las opciones de alineación son accesibles después de seleccionar el tipo de recurso y la métrica. Se proporcionan los valores predeterminados para estos campos. Sin embargo, puedes modificar las selecciones.
Modo MQL: Todas las opciones de alineación están disponibles.

En la siguiente captura de pantalla, se ilustra el uso de CPU de las instancias de VM de Compute Engine en un proyecto de Google Cloud en particular. En esta imagen, los campos de alineación tienen los valores predeterminados: el alineador está configurado como mean y el período de alineación como 1 minute:

Uso de CPU de las instancias de VM mediante la configuración de alineación predeterminada

A modo de comparación, en la siguiente captura de pantalla, se muestra el efecto del cambio del período de alineación de 1 minute a 5 minutes:

Uso de CPU de las instancias de VM con el período predeterminado de 5 minutos de alineación

Cuando aumentas el período, el gráfico resultante tiene menos puntos, que disminuye de 60 puntos por serie temporal a 10 puntos por serie temporal. Cada punto del gráfico se calcula mediante el promedio de los puntos de serie temporal de un período de alineación. Si aumentas el período de alineación, se promedian más puntos y esto tiene un efecto de fluidez en los datos del trazado.

Combina series temporales

Puedes reducir la cantidad de datos que se muestran de una métrica si combinas diferentes series temporales. Para combinar varias series temporales, por lo general, debes especificar una agrupación y una función. La agrupación se realiza mediante valores de etiqueta. La función define cómo se combinan todos los datos de series temporales de un grupo en una nueva serie temporal.

Para agrupar y combinar series temporales, realiza una de las siguientes acciones:

Modo básico:
1. Determina cómo agrupar series temporales:
  - Para mostrar todas las series temporales, deja desmarcada la opción Agrupado.
  - Para agrupar series temporales por valores de etiqueta, selecciona Agrupado y, luego, usa el menú Agrupar por a fin de seleccionar las etiquetas para agrupar. Una vez que realices las selecciones que hagas, haz clic en Aceptar.
2. Determina cómo combinar los datos:
  - Si los botones de selección solo enumeran percentiles, entonces seleccionaste una métrica que tiene un valor de distribución. Usa los botones de selección para elegir el percentil de la distribución que deseas ver.
  - Si los botones de selección enumeran mean, min y max, seleccionaste una métrica con un valor numérico. Usa estos botones para especificar cómo se combinan los datos como parte del proceso de creación de gráficos. Para comprender cómo funcionan estos combinadores, supongamos que un gráfico puede mostrar 60 datos y que la tasa de datos es de 1 punto por minuto. Si muestras una hora de datos, el gráfico puede mostrar cada punto. Sin embargo, si deseas mostrar 3 horas de datos, debes reducir 180 datos a 60, que es la cantidad de puntos que se puede mostrar en el gráfico. Una forma de reducir los datos es promediar tres muestras adyacentes; otra es la mínima.
Modo avanzado:
- Para combinar todas las series temporales en una sola serie temporal, asegúrate de que Agrupar por esté vacío y selecciona cómo se combinan las series temporales con la función Agrupar por función.
  
  Nota: Debes usar esta opción si muestras series temporales en un gráfico de mapa de calor. Para obtener más información, consulta Métricas de distribución.
- Para mostrar todas las series temporales, realiza una de las siguientes acciones:
  - Asegúrate de que Agrupar por esté vacío y selecciona none para la Agrupar por función.
  - Haz clic en el menú Agrupar por, selecciona Agregar todo y, luego, selecciona Agrupar por función. Para las métricas que almacenan un valor numérico, la elección de agrupación por función no puede producir un gráfico visible de manera diferente.
- Para agrupar series temporales por valores de etiqueta específicos, haz clic en Agrupar por y selecciona las etiquetas que deseas agrupar. Para especificar cómo se combinan las series temporales, selecciona una función con el menú Agrupar por función.
Modo MQL:

Para obtener información sobre el lenguaje de consulta de Monitoring, consulta Usa el Editor de consultas.

En la siguiente captura de pantalla, se muestra una agrupación por user_labels.version con la función de agrupación configurada en el valor predeterminado de sum. Esta selección da como resultado una serie temporal para cada valor de user_labels.version. Los datos de cada serie temporal se calculan a partir de la suma de todos los valores de una serie temporal individual de una versión específica:

Se muestran las series temporales agrupadas por versión.

Puedes agrupar por varias etiquetas. Cuando tienes varias opciones de agrupación, la función de agrupación se aplica al conjunto de series temporales que tienen los mismos valores para las etiquetas seleccionadas.

En el gráfico resultante, se muestra una serie temporal para cada combinación de valores de etiqueta. No importa el orden en que especifiques las etiquetas.

Por ejemplo, en la siguiente captura de pantalla, se muestra la agrupación por user_labels.version y por system_labels.machine_image:

Se muestran las series temporales agrupadas por imagen de máquina y versión

Como se ilustra, si agrupas mediante ambas etiquetas, obtienes una serie temporal para cada par de valores. El hecho de que obtengas una serie temporal por cada combinación de etiquetas significa que esta técnica puede crear fácilmente más datos de los que puedes utilizar en un solo gráfico.

Cuando especificas la agrupación o si seleccionas una agrupación por función, la serie temporal representada solo contiene las etiquetas obligatorias, como el identificador del proyecto, y las etiquetas que especifica la agrupación.

Quita las condiciones de agrupación

Para quitar todas las condiciones agrupadas, realiza una de las siguientes acciones:

Modo básico: Desmarca Agrupado.
Modo avanzado: Haz lo siguiente:
1. En el menú Agrupar por, haz clic en Quitar todo y, luego, en Aceptar.
2. En el menú Agrupar por función, selecciona none.
Nota: Cuando usas el modo avanzado, si solo borras las etiquetas de agrupar por, en el gráfico se muestra una sola línea que representa todos los datos después de que se aplicó la función de agrupación. Para deshacer la agrupación, debes quitar las etiquetas de agrupación y restablecer la función de agrupación en none.
Modo MQL: borra los comandos de agrupación.

Para obtener información sobre el lenguaje de consulta de Monitoring, consulta Usa el Editor de consultas.

Agregación secundaria

La pestaña que seleccionas determina las opciones de agregación:

Modos básico y Avanzado: el editor del panel determina cómo asignar tus selecciones de agregación a los campos de agregación principal y secundario especificados por la API de Cloud Monitoring mediante la siguiente información:
- Tipo de widget
- Categoría de métrica
- Tipo de valor de la métrica
- Qué modo se utiliza para configurar el widget
A fin de determinar esta asignación para gráficos en paneles personalizados, puedes recuperar la configuración del panel mediante Google Cloud CLI. Para obtener más información, consulta Enumera paneles.
Modo MQL: estos campos son accesibles.