Selecciona métricas cuando usas el Explorador de métricas

En esta página, se describe cómo elegir los datos que se mostrarán y cómo mostrarlos cuando se usa el Explorador de métricas. Para obtener información sobre cómo configurar el estilo de un gráfico, consulta Configura las opciones de vista.

Selecciona los datos que se mostrarán

Para especificar las métricas que se mostrarán cuando se use el Explorador de métricas, haz clic en la pestaña Métrica de la página de definición de gráficos. La siguiente captura de pantalla muestra la pestaña del selector de métricas:

Para propagar el campo Buscar tipo de recurso y métrica, debes especificar al menos un par de valores:

• Un tipo de métrica que identifica las medidas que se pueden recopilar desde un recurso supervisado. En este, se incluye una descripción de lo que se mide y cómo se interpretan las mediciones. A veces, el tipo de métrica se denomina métrica. Para obtener información conceptual, consulta Tipos de métricas.

• Un recurso supervisado especifica desde qué recurso se capturan los datos de la métrica. A veces, el recurso supervisado se denomina tipo de recurso supervisado o recurso. Para obtener información conceptual, consulta Recursos supervisados.

Monitoring tiene muchos tipos de métricas predefinidos y recursos supervisados disponibles. También puedes crear métricas personalizadas:

• Para obtener información sobre los tipos de métricas predefinidas, consulta la Lista de métricas. Las métricas se enumeran por tipo de servicio. Por ejemplo, la página Métricas de Google Cloud contiene una serie de tablas, una para cada servicio de Google Cloud.

• Para obtener información sobre los tipos de recursos supervisados disponibles, consulta la Lista de recursos supervisados.

• Para obtener información sobre cómo definir tus propias métricas, consulta Usa métricas personalizadas.

Campo de especificación de métrica

Para seleccionar una métrica, usa el campo Find resource type and metric (Buscar tipo de recurso y métrica) a fin de elegir un tipo de recurso y un tipo de métrica. Puedes especificarlos en cualquier orden. Para empezar, haz clic en el campo. Esto muestra una o dos listas, según cualquier selección previa. Las listas se indican mediante encabezados, Tipos de recursos (Resource types) y Métricas (Metrics), como se ve en la siguiente captura de pantalla:

Nota: No puedes seleccionar tipos de métricas con valores de tipo String desde la consola. Los datos con valores de string no pueden mostrarse en los gráficos ni usarse en las políticas de alertas. Para recuperar los datos de estos tipos de métricas, debes usar un método en la API, como timeSeries.list.

Puedes seleccionar una entrada de las siguientes dos maneras:

• Selecciona las entradas de las listas.

  Debido a que hay menos tipos de recursos que métricas, primero selecciona el Tipo de recurso. Si tu tipo de recurso no aparece en la lista corta, haz clic en Ver todos (See all). Después de seleccionar el tipo de recurso, la lista de métricas se filtra de manera automática para mostrar solo las métricas relevantes.

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

  1. Junto a Buscar tipo de recurso y métrica, haz clic en Ayuda .

  2. Haz clic en Modo de filtro directo en el panel de ayuda.

     Cuando el Modo de filtro directo está habilitado, la opción Buscar tipo de recurso y métrica se reemplaza por un cuadro de texto editable con el encabezado Tipo de recurso, métrica y filtro (Resource type, metric, and filter):

     

     Si realizaste selecciones para un tipo de recurso, una métrica o un filtro antes de seleccionar el Modo de filtro directo, esa configuración se usará para completar previamente el cuadro de texto Tipo de recurso, métrica y filtro (Resource type, metric, and filter).

  3. Ingresa un filtro de métrica en el cuadro de texto Tipo de recurso, métrica y filtro (Resource type, metric, and filter). El filtro debe incluir un tipo de métrica y de recurso. También puedes incluir filtros de etiquetas. Para obtener información sobre la gramática del filtro, consulta Filtros de supervisión.

     Por ejemplo, para mostrar las entradas de registro de todas las instancias de VM de Google Cloud en la zona us-east1-b, ingresa lo siguiente:

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

     Si usaste el modo de filtro directo para configurar gráficos o políticas de alertas y no hay datos disponibles, en el gráfico se mostrará un mensaje de error. El mensaje de error exacto depende del filtro que ingresaste. Por ejemplo, un mensaje típico es Chart definition invalid. Es posible que también veas el mensaje No data is available for the selected time frame.

Si te desplazas sobre un elemento en cualquiera de las listas, aparece información sobre la herramienta que muestra el contenido en el descriptor del elemento. Para obtener información sobre los descriptores de tipos de métrica o recursos supervisados, consulta la lista de métricas o la lista de recursos supervisados.

Cuando se selecciona al menos un tipo de recurso y un par de métricas, el gráfico muestra todas las series temporales disponibles y los elementos adicionales aparecen debajo de la métrica específica en la pestaña Métrica (Metric). En la siguiente captura de pantalla, se muestra la pestaña Métrica después de que se especificó una métrica:

Según la métrica y el recurso seleccionados, sin otra configuración, en la siguiente captura de pantalla, se muestra un gráfico resultante:

En este gráfico, hay más datos de los que se pueden mostrar; los gráficos pueden mostrar un máximo de 300 líneas. El gráfico indica que hay demasiados datos para mostrar y sugiere usar el modo de valores atípicos, una de las opciones de la pestaña Opciones de vista, que reduce enormemente la cantidad de datos que se muestran.

No obstante, también puedes usar las opciones de configuración de métricas adicionales para simplificar la administración del conjunto de datos. 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.

Filtra los datos

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. Si aplicas filtros, habrá menos líneas en el gráfico y esto puede mejorar su rendimiento.

Si proporcionas varios criterios de filtrado, el gráfico correspondiente solo mostrará las series temporales que cumplan con todos los criterios, un AND lógico.

En Google Cloud Console, para agregar un filtro, haz clic en el campo Filtro. Esto abre un panel que contiene listas de los criterios por los que puedes filtrar. Por ejemplo, puedes filtrar por grupo de recursos, por nombre, por etiqueta de recurso, por zona y por etiqueta de métrica.

En la siguiente captura de pantalla, se muestran las etiquetas de filtro comunes para una métrica específica:

Puedes seleccionar de las listas o escribir para buscar coincidencias. Además, puedes crear filtros para los datos que aún no han aparecido, estos criterios de filtro no aparecerán en la lista de selección, pero puedes especificar manualmente los filtros que sabes que serán válidos en el futuro.

Después de elegir una etiqueta en la cual filtrar, debes especificar el resto del filtro: Un valor o rango de valores y una comparación.

Nota: Si un recurso supervisado no genera datos para la métrica seleccionada, el menú Valores de un filtro no contendrá información para ese recurso supervisado. Por ejemplo, supongamos que tu proyecto contiene una instancia de VM que se detiene. Supongamos que creas un gráfico para el uso de CPU de una instancia de VM. A continuación, debes agregar un filtro y seleccionar instance_id. En este caso, el menú Valores, en el que se enumeran todas las instancias disponibles, está vacío. Sin embargo, puedes ingresar el valor de forma manual y, luego, seleccionar Aplicar.

Por ejemplo, en la siguiente captura de pantalla, se muestra un filtro en la etiqueta de recurso zone. El campo Filtro (Filter) admite un par de operadores de comparación para la igualdad, = y =~, y otro correspondiente a la desigualdad, != y !=~. El segundo elemento de cada par toma una expresión regular como un valor. La igualdad simple, =, es el valor predeterminado.

Debajo de la lista de operadores de comparación hay una lista de los valores disponibles. La siguiente captura de pantalla muestra los nombres de las zonas en el proyecto:

Para el campo Valor, puedes seleccionar uno de los elementos en la lista desplegable o puedes ingresar una expresión que coincida con varios elementos:

• Si usas una comparación directa, = o !=, puedes crear una string de filtro como starts_with. Por ejemplo, la string de filtro starts_with("us-central") coincide con cualquier zona us-central:

  

  Consulta Filtros de supervisión para obtener más información sobre las strings de filtro.

• Si seleccionas =~ o !=~, ingresa una expresión regular RE2 como valor. Por ejemplo, la expresión regular us-central1-.* coincide con cualquier zona us-central1:

  

  Nota: No puedes usar expresiones regulares para filtrar la etiqueta de recurso project_id.

  La expresión regular ^us.*.a$ coincide con cualquier zona de EE.UU. que termine con “a”:

  

Puedes especificar varios criterios de filtro y usar la misma etiqueta varias veces. Esto te permite especificar un filtro para un rango de valores. Para agregar filtros adicionales, haz clic en Agregar un filtro (Add a filter) cerca de la parte inferior del campo de filtro. Por el momento, se deben cumplir todos los criterios de filtro, ya que constituyen un AND lógico. Por ejemplo, puedes usar las strings de filtro starts_with y ends_with para mostrar solo las zonas “a” en EE.UU.:

Si se utilizan los filtros zone="starts_with("asia-east1")" o zone=~"asia-east1.*" en su lugar, solo se mostrarán las series temporales con los datos de una de las zonas asia-east1:

Elige cómo mostrar los datos

En la sección, se explica cómo mostrar los datos seleccionados mediante la configuración de los campos de agregación. La agregación consiste en la alineación de los datos y la combinación de diferentes series temporales en conjunto. Para obtener una explicación detallada de la agregación, consulta Filtrado y agregación: manipula series temporales.

• Para obtener información sobre las opciones de vista, incluido el modo de valores atípicos, consulta Configuración de las opciones de vistas.
• Para obtener más información sobre la interacción con el gráfico, consulta Explora los datos representados.

Agrupación

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 todas las series temporales de un grupo en una nueva serie temporal.

Para agregar una agrupación, haz clic en el texto en el cuadro de texto Agrupar por y, luego, elige una opción del menú. El menú se construye de forma dinámica según los datos de series temporales para el recurso y la métrica que seleccionaste. La agrupación y el filtrado usan el mismo conjunto de etiquetas.

Cuando agregas la primera etiqueta, ocurre lo siguiente:

• Se selecciona un agregador. La función seleccionada está determinada por el tipo de datos que se muestran. Sin embargo, puedes cambiar esta función.
• El agregador determina cómo se combinan las series temporales que tienen el mismo valor de etiqueta en una sola serie temporal.
• El gráfico muestra una serie temporal para cada valor de la etiqueta que aparece en el cuadro de texto Agrupar por.

Si agrupas por varias etiquetas, el agregador combina las series temporales que tienen el mismo valor para las etiquetas especificadas.

Si no especificas una opción de agrupación y especificas un agregador, esa función se aplica a todas las series temporales seleccionadas y genera una sola serie temporal.

En la siguiente captura de pantalla, se muestra una agrupación por user_labels.version con el agregador 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:

Puedes agrupar por varias etiquetas. Cuando tienes varias opciones de agrupación, las series temporales se agrupan por cada combinación de valores de etiqueta, y el agregador se aplica a cada grupo. 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:

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 un agregador, 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 una condición de agrupación, debes hacer lo siguiente:

1. Quita las etiquetas agrupadas.
2. Configura el agregador como none.

Nota: Si solo borras las etiquetas agrupar por, en el gráfico, se mostrará una sola línea que representa todos los datos después de que se aplicó el agregador. Para deshacer la agrupación, debes quitar las etiquetas de agrupación y restablecer el agregador en none.

Alineación

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 campo Período especifica el intervalo de tiempo mínimo que se usa cuando se alinean los datos de las 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.

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. Sin embargo, si configuras el gráfico para que muestre una semana de datos, hay demasiados puntos para mostrar en el gráfico a fin de que el período se modifique automáticamente. En este ejemplo, el período de alineación modificado es de una hora.

El campo Alineador 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 punto de datos alineado es el mínimo de todos los datos dentro del período de alineación. Algunos de los alineadores realizan acciones más compuestas:

• 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 las unidades de la serie temporal original son MiB y las unidades del período de alineación son segundos, esta opción de alineador da como resultado un gráfico con las unidades 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:

Después de seleccionar el tipo de recurso y la métrica, el período de alineación se muestra en el panel principal:

Para ver las funciones de alineación, haz clic en Mostrar opciones avanzadas:

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:

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:

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.

Agregación secundaria

Cuando tienes varias series temporales que ya representan agregaciones, como los ejemplos que ilustran la opción Agrupar por (Group By), puedes agregarlas mediante la selección de un agregador secundario:

La agregación secundaria reduce todas las series temporales del gráfico a una sola serie temporal.

En la siguiente captura de pantalla, se muestran varias series temporales que resultan de la agrupación de un conjunto de datos filtrados. El uso de la agrupación requiere agregación; cada grupo de líneas se agrega a una. En la siguiente captura de pantalla, se muestran series temporales agrupadas por zona:

En la siguiente captura de pantalla, se muestra el resultado de usar la agregación secundaria para encontrar el valor medio en las series temporales agrupadas:

¿Qué sigue?

• Para obtener información sobre los recursos supervisados, consulta el artículo sobre recursos supervisados.

• Para obtener una lista de las métricas predefinidas, consulta métricas.

• Para obtener información sobre cómo definir tus propias métricas, consulta Usa métricas personalizadas.

• Para obtener información sobre cómo usar la plantilla de leyendas, consulta Configura la plantilla de leyendas.

• Para obtener información sobre las opciones de vista, incluido el modo de valores atípicos, consulta Configuración de las opciones de vistas.

• Para obtener más información sobre la interacción con el gráfico, consulta Explora los datos representados.