En este documento, se describe cómo agregar gráficos, tablas, indicadores y cuadros de evaluación a un panel personalizado con la consola de Google Cloud. Puedes mostrar datos de métricas durante un intervalo de tiempo agregando un gráfico de líneas un gráfico de áreas apiladas, un gráfico de barras o un gráfico de mapa de calor. Si solo estás interesadas en las mediciones más recientes, agregaremos una tabla, un gráfico circular un indicador o un cuadro de evaluación. Los indicadores y cuadros de evaluación cambian de color según cómo se compara el valor más reciente con los umbrales de advertencia y peligro.
Las visualizaciones que puedes agregar a los paneles se denominan de forma colectiva widgets. Para obtener información general sobre los diferentes tipos de widgets, consulta Descripción general de los paneles.
Los gráficos, las tablas, los indicadores y los cuadros de evaluación de los paneles personalizados pueden mostrar cualquier tipo de métrica que tenga un valor numérico o de distribución, incluidas las métricas definidas por el usuario y las métricas basadas en registros. En los gráficos, no se pueden graficar datos de tipo cadena.
En este documento, se describe cómo agregar gráficos, tablas, medidores y cuadros de evaluación en un panel personalizado que muestra datos de series temporales. Para obtener información sobre cómo agregar otros tipos de widgets a tus paneles, consulta los siguientes documentos:
- Incidentes y políticas de alertas
- Registros y errores
- Texto descriptivo
- Objetivos de nivel de servicio (SLO) para un conjunto de servicios
- Gráficos que muestran los resultados de una consulta del Análisis de registros
Para obtener información sobre la API de Cloud Monitoring, consulta Administra paneles con la API.
Antes de comenzar
-
Para obtener los permisos que necesitas para crear y modificar paneles personalizados con la consola de Google Cloud, pídele a tu administrador que te otorgue el rol de IAM de editor de Monitoring (
roles/monitoring.editor
) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Para obtener más información sobre los roles, consulta Controla el acceso con Identity and Access Management.
Puedes colocar hasta 40 gráficos en un panel.
Para agregar un widget a un panel, puedes seleccionar la visualización y, luego, configurar el widget, o bien seleccionar primero el tipo de datos y, luego, configurar la visualización.
Por ejemplo, para agregar una tabla que muestre el uso de CPU de tus de VM a un panel, puedes realizar cualquiera de las siguientes acciones:
- Selecciona el widget Tabla y, luego, configúralo para que muestre la el uso de CPU de tus instancias de VM.
- Selecciona el tipo de datos Métrica y configura el widget para que muestre la el uso de CPU de tus instancias de VM y, luego, cambia el tipo de widget a Tabla:
En las instrucciones de esta página, se supone que primero seleccionas el tipo de datos y, luego, configurar cómo se muestran esos datos.
Agrega gráficos y tablas a un panel
En esta sección, se describe cómo configurar gráficos y tablas con el Consola de Google Cloud:
Los gráficos muestran datos a lo largo del tiempo y hay cuatro estilos disponibles: Línea, Área apilada, Barra apilada y Mapa de calor. Un solo gráfico puede mostrar varios tipos de métricas. Por ejemplo, puedes configurar un gráfico para mostrar los bytes de disco que se leen de tus instancias y los bytes de disco que se escriben en ellas.
Después de configurar un gráfico, puedes cambiar su tipo de widget. Para obtener información sobre por qué podrías seleccionar un estilo específico, consulta Gráficos que muestran datos a lo largo del tiempo.
Si deseas obtener información sobre el uso de la API de Cloud Monitoring para configurar un gráfico, consulta Panel con un widget
XyChart
.Las tablas contienen una fila para cada combinación de valores de etiqueta. Cuando las tablas muestran datos de varios tipos de métricas, cada fila contiene un resultado de todas las consultas, cuando es posible realizar esa combinación.
Hay dos estilos de tablas. La Tabla muestra un valor numérico como "25%". Se muestra el widget Top List. el valor y un indicador visual del valor comparado con el rango de valores posibles.
Puedes cambiar el estilo entre las tablas y los gráficos, configurar los nombres de las columnas de las tablas y agregar umbrales que cambien el color de las celdas de la tabla. Para obtener más información y un ejemplo, consulta Muestra datos en formato tabular en un panel.
Si deseas obtener más información sobre el uso de la API de Cloud Monitoring para configurar una tabla, consulta Panel con un widget
TimeSeriesTable
.
Para agregar un gráfico o una tabla a un panel, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página Paneles.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Realiza una de las siguientes acciones:
- Para crear un panel nuevo, selecciona Crear panel.
- Para actualizar un panel existente, busca el panel en la lista de todos los paneles y selecciona su nombre.
En la barra de herramientas, haz clic en add Agregar widget.
En el diálogo Agregar widget, selecciona leaderboard Métrica.
Especifica los datos que se mostrarán en el gráfico. Puedes usar una interfaz controlada por menús, el lenguaje de consulta de Monitoring (MQL), PromQL o ingresar un filtro de Monitoring:
Interfaz controlada por menús
Selecciona los datos de series temporales que deseas ver:
En el elemento Métrica, expande el menú Selecciona una métrica.
El menú Selecciona una métrica (Select a metric) contiene funciones que te ayudan a encontrar los tipos de métricas disponibles:
Para encontrar un tipo de métrica específico, usa la filter_list Barra de filtros. Por ejemplo, si ingresas
util
, restringirás el menú a mostrar entradas que incluyanutil
. Las entradas se muestran cuando pasan una prueba de "contiene" que no distingue mayúsculas de minúsculas.Para mostrar todos los tipos de métricas, incluso las que no tienen datos, haz clic en
Activa. De forma predeterminada, los menús solo mostrar tipos de métricas con datos.
Por ejemplo, puedes tomar las siguientes decisiones:
- En el menú Recursos activos, selecciona Instancia de VM.
- En el menú Categorías de métricas activas, selecciona uptime_check.
- En el menú Métricas activas, selecciona Latencia de la solicitud.
- Haz clic en Aplicar.
Opcional: Para especificar un subconjunto de datos para mostrar, en el elemento Filtro, selecciona Agregar filtro y, luego, completar el diálogo. Por ejemplo, puedes ver los datos de una zona aplicar un filtro. Puedes agregar varios filtros. Para obtener más información, consulta Filtra los datos del gráfico.
Para obtener más información, consulta Selecciona los datos que deseas graficar.
Combina y alinea series temporales:
Para mostrar cada serie temporal, en el elemento Aggregation (Agregación) Configura el primer menú en Sin agregar y el segundo menú en Ninguno.
Para combinar series temporales, en el elemento Agregación, haz lo siguiente:
Expande el primer menú y selecciona una función.
El gráfico se actualiza y muestra una sola serie temporal. Por ejemplo: si seleccionas Media, la serie temporal que se muestra es el promedio de todas las series temporales.
Para combinar series temporales que tienen los mismos valores de etiqueta, haz lo siguiente: expandir el segundo menú y, luego, seleccionar una o más etiquetas.
El gráfico se actualiza y muestra una serie temporal por cada combinación de valores de etiquetas. Por ejemplo, para mostrar las series temporales por zona, configura el segundo menú como zona.
Cuando el segundo menú se establece en Ninguno, el gráfico muestra uno series temporales.
Opcional: Para configurar el espaciado entre los datos, haz clic en add Agregar elemento de consulta, selecciona Intervalo mínimo y, luego, ingresa un valor.
Para obtener más información sobre la agrupación y la alineación, consulta Elige cómo mostrar los datos del gráfico.
Opcional: Para mostrar solo las series temporales con la puntuación más alta o más baja valores, usa la opción Ordenar y Limit.
MQL
- En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea codeMQL o codeMQL.
- Verifica que MQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
-
Ingresa tu consulta en el Editor de consultas. Por ejemplo, para graficar la Usa el uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa el siguiente consulta:
fetch gce_instance | metric 'compute.googleapis.com/instance/cpu/utilization' | group_by 1m, [value_utilization_mean: mean(value.utilization)] | every 1m
Para obtener más información sobre MQL, consulta los siguientes documentos:
PromQL
- En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea codeMQL o codeMQL.
- Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
-
Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar el promedio El uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa siguiente consulta:
avg(compute_googleapis_com:instance_cpu_utilization)
Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.
Filtro de supervisión
-
En el elemento Métrica, haz clic en help_outline Ayuda y, luego, selecciona Modo de filtro directo.
Se borran los elementos Métrica y Filtro, y se crea un elemento Filtros que te permite ingresar texto.
Si seleccionaste un tipo de recurso, una métrica o filtros antes de cambiar al modo Direct Filter Mode, esa configuración se mostrará en el campo del elemento Filters.
- Ingresa un filtro de Monitoring en el campo de la Filters.
Combina y alinea series temporales:
Para mostrar cada serie temporal, en el elemento Aggregation (Agregación) Configura el primer menú en Sin agregar y el segundo menú en Ninguno.
Para combinar series temporales, en el elemento Agregación, haz lo siguiente:
Expande el primer menú y selecciona una función.
El gráfico se actualiza y muestra una sola serie temporal. Por ejemplo: si seleccionas Media, la serie temporal que se muestra es el promedio de todas las series temporales.
Para combinar series temporales que tienen los mismos valores de etiqueta, haz lo siguiente: expandir el segundo menú y, luego, seleccionar una o más etiquetas.
El gráfico se actualiza y muestra una serie temporal por cada combinación de valores de etiquetas. Por ejemplo, para mostrar las series temporales por zona, configura el segundo menú como zona.
Cuando el segundo menú se establece en Ninguno, el gráfico muestra uno series temporales.
Opcional: Para configurar el espaciado entre datos, haz clic en add Agregar elemento de consulta, selecciona Intervalo mínimo y, luego, ingresa un valor.
Para obtener más información sobre la agrupación y la alineación, consulta Elige cómo mostrar los datos del gráfico.
Opcional: Configura el gráfico o la tabla para que muestren varios tipos de métricas.
Interfaz controlada por menús
Selecciona Agregar consulta. Se agrega una nueva consulta. Por ejemplo, una consulta con el podría agregarse la etiqueta B.
Para la consulta nueva, en el elemento Métrica, selecciona un tipo de recurso y un tipo de métrica. También puedes agregar filtros, combinar series temporales y ordenar y limitar la cantidad de series temporales que se muestran.
En la siguiente captura de pantalla, se muestra la pantalla del Explorador de métricas cuando hay dos tipos de métricas representadas en un gráfico:
MQL
No compatible.
PromQL
No compatible.
Filtro de supervisión
No compatible.
Opcional: Configura el gráfico para que muestre una proporción de tipos de métricas.
Interfaz controlada por menús
- Configura el gráfico para que muestre dos tipos de métricas iguales
tipo de métrica. Por ejemplo, ambas son métricas
GAUGE
. - Asegúrate de que el valor del campo Intervalo mínimo sea el mismo para ambos tipos de métricas. Para acceder a este campo, haz clic en add Agrega un elemento de consulta y selecciona Intervalo mínimo.
-
Actualiza los campos de agregación.
Recomendamos que las etiquetas para el tipo de métrica de denominador coincidan con los valores establecidos para el tipo de métrica del numerador. Por ejemplo, puedes seleccionar la etiqueta
zone
para el numerador y el denominador.No es necesario que uses el mismo conjunto de etiquetas para ambos tipos de métricas. Sin embargo, solo puedes seleccionar etiquetas que sean comunes para ambos tipos de métricas.
-
En la barra de herramientas del panel de consulta, selecciona Crear proporción y, luego, completa el diálogo.
Después de crear la proporción, se muestran tres consultas:
- Proporción A/B identifica la consulta de proporción.
- A identifica la consulta del numerador.
- B identifica la consulta del denominador.
En el siguiente ejemplo, se muestra una proporción que compara la suma de los bytes escritos en el disco por zona con la cantidad total de bytes escritos en el disco:
-
Opcional: Para cambiar las métricas del numerador y del denominador, en el elemento Proporción, expande el menú y, luego, haz una selección.
MQL
- En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea codeMQL o codeMQL.
- Verifica que MQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
-
Ingresa tu consulta en el Editor de consultas. MQL te permite calcular un entre dos métricas diferentes y te permite filtrar una sola métrica por una etiqueta y, luego, calculamos la proporción. La siguiente consulta calcula la proporción de respuestas con un valor de
500
y la cantidad total de respuestas:fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count | { filter response_code_class = 500 ; ident } | group_by [matched_url_path_rule] | outer_join 0 | div
Para obtener más información sobre MQL, consulta los siguientes documentos:
PromQL
- En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea codeMQL o codeMQL.
- Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
-
Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar la proporción latencia promedio de tu métrica
my_summary_latency_seconds
, usa el siguiente consulta:sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) / sum without (instance)(rate(my_summary_latency_seconds_count[5m]))
Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.
Filtro de supervisión
No compatible.
- Configura el gráfico para que muestre dos tipos de métricas iguales
tipo de métrica. Por ejemplo, ambas son métricas
Opcional: Para cambiar la visualización, en el panel Display, Haz clic en arrow_drop_down Tipo de widget y, luego, selecciona una opción.
El menú Tipo de widget enumera todos los tipos de widgets que pueden mostrar la mismo tipo de datos; Sin embargo, es posible que algunos widgets no estén habilitados. Por ejemplo, imagina un gráfico en un panel configurado para mostrar uno tipo de métrica. El gráfico de líneas muestra varias series temporales y que cada una el valor medido es un doble:
Los widgets Tabla, Gráfico circular, Gráfico de líneas, Gráfico de barras apiladas y Gráfico de áreas apiladas aparecen como Compatibles. Puedes seleccionar cualquiera de estos tipos.
Los widgets de Cuadro de evaluación y Indicador se enumeran como Son compatibles con los ajustes, ya que estos widgets pueden mostrar solo una serie temporal. Para habilitar estos tipos de widgets, modifica la configuración de agrupación.
El widget Mapa de calor está inhabilitado porque estos widgets solo pueden mostrar datos con valores de distribución.
El panel de registros no aparece en la lista porque no puede mostrar datos de series temporales.
Opcional: Para cambiar la forma en que un gráfico o una tabla muestran los datos seleccionados, usa el en el panel Display:
Opciones del gráfico:
- Menú Modo de análisis: Selecciona entre gráficos de líneas, rayos X y estadísticas.
- Menú Comparar con los anteriores: Superpone los datos actuales con los anteriores.
- Menú Threshold Line: agregar un umbral de referencia.
- Menú Alias de leyenda: Configura el nombre de una columna de leyenda.
- Menús de asignación del eje Y, etiquetas del eje Y y escala del eje Y: Configura la asignación, las etiquetas o la escala del eje Y.
Opciones de la tabla:
- Menú Opción de valor: Selecciona entre el valor más reciente y un valor agregado.
- Menú Columnas visibles: Selecciona las columnas que deseas mostrar.
- Menú de formato de columna: Configura los nombres de las columnas, la alineación de los datos en una columna, las unidades y si las celdas tienen códigos de color.
- Menú Vista de métricas: Selecciona si el valor se muestra solo o en relación con un rango de valores.
- Menú Alias de leyenda: Configura el nombre de una columna de leyenda.
Para aplicar los cambios en el panel, en la barra de herramientas, Haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.
Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.
Cómo mostrar solo los datos más recientes
Monitoring te proporciona varias formas de visualizar solo las mediciones más recientes, en lugar de ver el historial de mediciones:
Para mostrar gráficamente el valor más reciente de cada serie temporal, en el que cada valor se muestra como una fracción de la suma de todos los valores, agrega un gráfico circular. Puedes configurar estos gráficos para que muestren el valor total.
Para mostrar el valor más reciente de cada serie temporal en forma tabular, agrega una tabla. Puedes limitar el número de filas en una tabla y configurar filas de una tabla para mostrar un valor comparado con un rango de valores.
Para obtener una indicación verde, ámbar o rojo del valor más reciente comparado a un conjunto de umbrales, Agrega un indicador o cuadro de evaluación al panel.
Representar gráficamente los datos más recientes mediante un gráfico circular
Para ver los datos más recientes como una fracción del total, agrega un gráfico circular. Al igual que las tablas, un gráfico circular puede mostrar cualquier tipo de métrica que tiene un valor numérico y pueden mostrar percentiles para las métricas con valor de distribución. Cada serie temporal contribuye una porción.
En la siguiente captura de pantalla, se muestra un panel que muestra el uso de CPU de las instancias de máquina virtual con dos configuraciones diferentes de un widget de gráfico circular:
Para obtener información sobre cómo agregar gráficos circulares a un panel, consulta los siguientes documentos:
Consola de Google Cloud: Consulta la sección titulada Agrega gráficos y tablas en este documento.
- Después de seleccionar los datos que deseas graficar, en el panel Mostrar, establece el campo Tipo de widget en Gráfico circular.
- Para mostrar el valor total, establece el campo Tipo de gráfico en Donut.
API de Cloud Monitoring: Consulta Panel con un widget
PieChart
.
Cómo mostrar los datos más recientes en formato tabular
Para ver los datos más recientes en formato tabular, agrega una tabla. Las tablas pueden mostrar datos numéricos. Por ejemplo, pueden mostrar uno o más tipo de métrica o percentiles para métricas con valores de distribución.
Cuando una tabla muestra un tipo de métrica, cada fila de la tabla corresponde a una serie temporal. Una columna de la tabla que muestra un valor numérico, que es el valor más reciente o un valor agregado. Las otras columnas muestran las etiquetas de la serie temporal. Cuando una tabla muestra varios tipos de métricas, los datos de ambos tipos se muestran en la misma fila, cuando es posible. Para obtener más información, consulta Cómo las tablas combinan varios tipos de métricas.
Hay dos widgets que muestran datos en forma tabular: el widget Top List y el widget Table. La diferencia principal entre estos dos widgets es que el widget Top List ordena el orden de las filas y muestra las valor junto con un indicador visual del valor comparado con el rango de valores posibles. Debido a que el widget Top List proporciona una imagen del valor, no puedes codificar por color la celda según cómo se compara el valor con un umbral.
Para obtener información sobre la configuración de tablas, consulta las siguientes secciones:
Para obtener información general sobre cómo seleccionar métricas y configurar opciones de agregación, consulta la sección Agrega gráficos y tablas en este documento.
Después de seleccionar los datos que deseas graficar, en el panel Mostrar, establece el campo Tipo de widget en Tabla o Lista de elementos principales.
Para conocer las opciones de configuración, consulta las siguientes secciones de este documento:
Para obtener más información sobre cómo ordenar y filtrar tu tabla, consulta la Ordena y filtra tablas de este documento.
Para obtener información sobre cómo usar la API para configurar una tabla, consulta Panel con un widget
TimeSeriesTable
.
En la siguiente captura de pantalla, se muestran dos tablas. La primera tabla muestra dos tipos de métricas: la cantidad de bytes leídos de las instancias y la cantidad de bytes escritos en ellas. Se muestra un valor agregado junto con una barra de referencia. La segunda tabla muestra el valor más reciente de un tipo de métrica, y la columna de valor se configuró para asignar un código de color a la celda según cómo se compara el valor con un umbral:
Mostrar el valor agregado o el más reciente
De forma predeterminada, las tablas muestran el valor más reciente. Sin embargo, una tabla puede mostrar un valor que se calcula en el intervalo de tiempo seleccionado para tu panel.
Para seleccionar entre el valor más reciente y el agregado, usa el campo Opción de valor.
Si muestras el valor agregado, para cada serie temporal, los datos dentro del intervalo de tiempo seleccionado por tu panel se combina función de alineación. La función de alineación es una de las opciones de agregación y no se muestra de forma predeterminada. Para ver la función de alineación, expande el Agregación y, en el primer elemento, selecciona Configurar alineador. Después de que hagas esta selección, se reemplazará el elemento Aggregation (Agregación) con un elemento Grouping y un menú llamado Alignment function (Función de alineación).
Selecciona las columnas que quieres mostrar
De forma predeterminada, una columna de la tabla muestra un valor numérico. Todas las demás columnas corresponden a una etiqueta en la serie temporal. Para las columnas basadas en etiquetas, el nombre de la columna se deriva de la etiqueta.
Para configurar las columnas que muestra la tabla, expande el menú Columnas visibles y realiza tus selecciones.
Configura el formato de la columna
Para configurar una columna individual, en el elemento Columnas, extiende el menú Anular columna, selecciona la columna que se modificará y, luego, haz lo siguiente:
- Para establecer el nombre de la columna, usa el campo Nombre visible.
- Para establecer la alineación de los datos en la columna, usa la format_align_left Alinear a la izquierda, format_align_center alinear al centro format_align_right Botones Alinear a la derecha.
- Codificar por color la celda según cómo se compara el valor numérico con una límite, establece los umbrales de advertencia y peligro.
- Si escribes consultas de PromQL, usa el menú Unidad para establecer las unidades que se muestran con los datos. Las unidades se configuran automáticamente cuando configuras tu consulta con las selecciones del menú.
Cómo mostrar el valor de referencia
Las tablas pueden mostrar solo un valor o un valor relativo a el rango de valores. Cuando se selecciona la opción de rango, se muestra el valor junto con una barra de color azul, la longitud de la barra es proporcional a la valor mostrado.
Para configurar si se muestra un valor de referencia, usa el elemento Vista de métricas.
Cómo ordenar y filtrar tablas
Puedes cambiar el orden de las filas en la visualización de la tabla y puedes filtrar el contenido de la tabla para que solo se muestren filas específicas. Esta configuración no es persistente. Cuando sales de la página del panel o cuando lo vuelves a cargar, se descartan las opciones de ordenamiento y filtrado que aplicaste.
Dispones de las siguientes opciones de orden y filtrado:
Para ordenar la tabla por una columna, haz clic en el encabezado de la columna.
Para cambiar las columnas de la tabla, haz clic en view_column Ver columnas, realiza las modificaciones y, luego, haz clic en Aceptar.
Para enumerar solo filas específicas, agrega uno o más filtros. Puedes agregar varios filtros. Cuando no especificas el operador OR entre dos filtros, un operador lógico AND une esos filtros.
Para agregar un filtro, haz clic en
Enter property name or value
, selecciona una propiedad del menú y, luego, ingresa un valor o selecciona el menú. Por ejemplo, si filtras la propiedadName
y, luego, ingresas el valordemo
, la tabla solo mostrará las filas en las que el campoName
incluye el valordemo
.
Muestra los datos más recientes con indicación de advertencia o error
Agrega un indicador o un cuadro de evaluación para ver las mediciones más recientes en comparación con un conjunto de umbrales codificado por colores. Los indicadores solo muestran la información más reciente la medición mientras que los cuadros de evaluación también muestran un historial de las mediciones recientes. El color de fondo de estos widgets también está codificado por color. Cuando la mayor el valor reciente se encuentra dentro de los rangos esperados, el color del widget es blanco. Cuándo el valor está en un rango de advertencia, el widget se vuelve ámbar. Del mismo modo, cuando el valor está en un rango de peligro, el widget se vuelve rojo.
Ambos widgets muestran una sola serie temporal. En la siguiente captura de pantalla, se muestra un ejemplo de un indicador cuando la versión más reciente es inferior a los umbrales de advertencia y peligro:
El resto de la información de esta sección es para la consola de Google Cloud. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un Scorecard
básico.
Para agregar un indicador o un cuadro de evaluación a un panel, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página Paneles.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Realiza una de las siguientes acciones:
- Para crear un panel nuevo, selecciona Crear panel.
- Para actualizar un panel existente, busca el panel en la lista de todos los paneles y selecciona su nombre.
En la barra de herramientas, haz clic en add Agregar widget.
En el diálogo Agregar widget, selecciona leaderboard Métrica.
Especifica los datos que se mostrarán en el gráfico. Puedes usar una interfaz controlada por menús, el lenguaje de consulta de Monitoring (MQL), PromQL o ingresar un filtro de Monitoring:
Interfaz controlada por menús
Selecciona los datos de series temporales que deseas ver:
En el elemento Métrica, expande el menú Selecciona una métrica.
El menú Selecciona una métrica (Select a metric) contiene funciones que te ayudan a encontrar los tipos de métricas disponibles:
Para encontrar un tipo de métrica específico, usa la filter_list Barra de filtros. Por ejemplo, si ingresas
util
, restringirás el menú a mostrar entradas que incluyanutil
. Las entradas se muestran cuando pasan una prueba de "contiene" que no distingue mayúsculas de minúsculas.Para mostrar todos los tipos de métricas, incluso las que no tienen datos, haz clic en
Activa. De forma predeterminada, los menús solo mostrar tipos de métricas con datos.
Por ejemplo, puedes tomar las siguientes decisiones:
- En el menú Recursos activos, selecciona Instancia de VM.
- En el menú Categorías de métricas activas, selecciona uptime_check.
- En el menú Métricas activas, selecciona Latencia de la solicitud.
- Haz clic en Aplicar.
Opcional: Para especificar un subconjunto de datos para mostrar, en el elemento Filtro, selecciona Agregar filtro y, luego, completar el diálogo. Por ejemplo, puedes ver los datos de una zona aplicar un filtro. Puedes agregar varios filtros. Para obtener más información, consulta Filtra datos del gráfico.
Para obtener más información, consulta Selecciona los datos que deseas graficar.
Combina las series temporales con los campos Agregación:
- Expande el primer menú y selecciona la función que combina la serie temporal.
- Expande el segundo menú y asegúrate de que no haya etiquetas seleccionadas.
MQL
- En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea codeMQL o codeMQL.
- Verifica que MQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
-
Ingresa tu consulta en el editor de consultas. Debes asegurarte de que la agregación están configurados para combinar todas las series temporales. Por ejemplo, para graficar la El uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa siguiente consulta:
fetch gce_instance | metric 'compute.googleapis.com/instance/cpu/utilization' | group_by 1m, [value_utilization_mean: mean(value.utilization)] | every 1m | group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]
Para obtener más información sobre MQL, consulta los siguientes documentos:
PromQL
- En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea codeMQL o codeMQL.
- Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.
-
Ingresa tu consulta en el Editor de consultas. Por ejemplo, para graficar el promedio El uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa siguiente consulta:
avg(compute_googleapis_com:instance_cpu_utilization)
Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.
Filtro de supervisión
-
En el elemento Métrica, haz clic en help_outline Ayuda y, luego, selecciona Modo de filtro directo.
Se borran los elementos Métrica y Filtro, y se crea un elemento Filtros que te permite ingresar texto.
Si seleccionaste un tipo de recurso, métrica o filtros antes de cambiar al modo de filtro directo y, luego, esos parámetros de configuración se muestran en el campo del elemento Filtros.
- Ingresa un filtro de Monitoring.
Combina las series temporales con los campos Agregación:
- Expande el primer menú y selecciona la función que combina la serie temporal.
- Expande el segundo menú y asegúrate de que no haya etiquetas seleccionadas.
En el panel Display, configura el indicador o cuadro de evaluación:
Haz clic en arrow_drop_down Tipo de widget y selecciona Indicador o Cuadro de evaluación.
Para los widgets de medidor, haz clic en arrow_drop_down Rango de medidor y, luego, establece los valores mínimo y máximo. Cuando un indicador muestra una por porcentaje, establece estos valores en 0 y 1 respectivamente.
Haz clic en arrow_drop_down Límite del medidor y, luego, establece los límites de advertencia y peligro. No se usan los campos de umbral que están vacíos.
Para el indicador que se mostró antes, se establecieron dos umbrales. Los valores superiores a 0.9 están en el rango de peligro. Valores superiores a 0.7, pero que no se encuentran en el rango de peligro o de advertencia.
Para los cuadros de evaluación, haz clic en arrow_drop_down Vista de gráfico de Spark. expande el menú de opciones y selecciona el estilo de visualización.
Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.
Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.
Cómo las tablas combinan datos de varios tipos de métricas
Si una tabla realiza consultas de varios tipos de métricas, la consola de Google Cloud realiza una operación de combinación examinando las etiquetas adjuntas al datos para ambos tipos de métricas. Cuando las etiquetas comunes a ambas consultas permiten que la supervisión determine un identificador de fila único, una sola fila de la tabla muestra el valor más reciente de cada consulta. De lo contrario, hay una fila para cada serie temporal.
Por ejemplo, supongamos que una tabla consulta dos tipos de métricas diferentes. Llamaremos
a estas consultas A
y B
. A continuación, se describe cómo se combinan los resultados de las consultas:
Si el resultado de ambas consultas tiene el mismo conjunto de etiquetas, la combinación se siempre exitosa. Cada fila contiene el valor más reciente de cada consulta. Si una consulta no muestra un valor para una combinación particular de etiquetas, la celda de la tabla estará vacía.
Por ejemplo, supongamos que ambas consultas contienen una etiqueta
zone
. La tabla contiene una fila por cada zona informada por las consultasA
yB
. Sin embargo, si la consultaA
muestra una serie temporal cuya zona esus-central1-a
pero la consultaB
no devuelve una serie temporal con este valor, entonces El valor más reciente de la consultaB
se muestra como una celda vacía.Si las etiquetas de los resultados de una consulta son un subconjunto de las etiquetas de los resultados de la otra consulta, los resultados se combinan.
Por ejemplo, supongamos que los resultados de ambas consultas incluyen etiquetas para
location
ycluster_name
, pero que los resultados de la consultaA
también incluye una etiqueta paramemory_type
. En este caso, cada fila corresponde a una serie temporal con valores únicos para las tres etiquetas.En cualquier fila, el valor que se muestra para la consulta
B
es el valor de la serie temporal que coincide con las dos etiquetas comunes,location
ycluster_name
, y se ignora la tercera etiqueta.Si los resultados de las dos consultas no comparten ninguna etiqueta o si comparten algunas, pero no suficientes para formar un identificador de fila único, no se pueden combinar los resultados. La tabla muestra una fila para cada serie temporal que muestra la consulta
A
oB
, y algunas celdas de la tabla están vacíasPor ejemplo, supongamos que las etiquetas de la consulta
A
sonlocation
ymemory_type
, y que las etiquetas de la consultaB
sonlocation
ycluster_name
. Aunque la etiquetalocation
es común, no es suficiente para crear un identificador de fila único.Como se describe en la siguiente sección, es posible que puedas resolver una combinación falla.
Resolver error de combinación
Cuando graficas varias métricas, puede producirse un error de combinación
porque las métricas usan diferentes nombres de etiquetas para el mismo campo.
Una forma de resolver este error es convertir una consulta en PromQL
y, luego, usa la función label_replace()
para
convertir los nombres de las etiquetas que usa un tipo de métrica para que coincidan con los de la
otro tipo de métrica.
Por ejemplo, considera una tabla configurada con dos consultas:
A
: Consulta el tipo de métricaPrometheus/kube_pod_container_status_ready/gauge
. Las opciones de agregación están configuradas para sumar series temporales agrupando los datos por la etiquetacluster
.B
: Consulta el tipo de métricakubernetes.io/container/memory/request_bytes
. Las opciones de agregación se establecen para sumar series temporales después de agrupar los datos por la etiquetacluster_name
.
La tabla no puede combinar los resultados porque los resultados de la consulta A
y
la consulta B
tienen etiquetas diferentes.
Para resolver la falla, convierte la consulta A
a PromQL y reemplaza cluster
con cluster_name
. En el siguiente ejemplo, se ilustra la consulta modificada:
sum by (cluster_name)(
label_replace(
avg_over_time(kube_pod_container_status_ready[${__interval}]),
"cluster_name", "$1", "cluster", "(.*)"
)
)
Con los cambios, ambas consultas producen el mismo conjunto de etiquetas.
Por lo tanto, cada fila de la tabla muestra un nombre de clúster,
el valor de la consulta A
y el valor de la consulta B
.
Para obtener información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.
¿Qué sigue?
También puedes agregar los siguientes widgets a tus paneles personalizados:
- Cómo mostrar políticas de alertas e incidentes
- Entradas de registro
- Texto descriptivo
- Objetivos de nivel de servicio (SLO) para un conjunto de servicios
Para obtener información sobre cómo explorar los datos del gráfico y filtrar tus paneles, consulta los siguientes documentos: