Soluciona problemas con los gráficos

Para resolver los mensajes de error o los resultados inesperados en los gráficos y los widgets del panel en Cloud Monitoring, puedes ajustar tus consultas, períodos de alineación y permisos para que tu telemetría se renderice con precisión. En este documento, se te ayuda a diagnosticar problemas habituales en el Explorador de métricas y los paneles personalizados, como brechas de datos, límites de visualización de series temporales, unidades del eje Y que no coinciden y errores de configuración de widgets.

Errores de gráficos

En esta sección, se describen los errores que puedes ver cuando configuras un gráfico. Puedes configurar gráficos con el Explorador de métricas o agregarlos a un panel.

Brechas en los datos del gráfico

En ocasiones, los gráficos muestran brechas en los datos. Por ejemplo, en la siguiente captura de pantalla, se muestra este comportamiento para la métrica loadbalancing.googleapis.com/https/total_latencies:

Se pueden producir brechas en los datos cuando los datos se escriben con muy poca frecuencia. Cloud Monitoring recopila métricas mediante el muestreo y, con datos muy dispersos, es posible que no haya datos disponibles cuando se recopile una muestra. Por ejemplo, los espacios en las métricas del balanceador de cargas pueden ocurrir cuando el recuento de solicitudes es de 0.05 consultas por segundo (QPS) o menos. Cuando la tasa de consultas aumenta, las brechas desaparecen.

Para quitar las brechas visuales, aumenta el intervalo de alineación. Cuando el sistema genera una serie temporal nueva con datos espaciados de forma regular, usa el intervalo de alineación para determinar el período en el que se combinan los datos sin procesar. Para obtener más información, consulta Alineación: regularización dentro de la serie.

Para establecer un intervalo de alineación mínimo, edita la consulta de tu gráfico. Por ejemplo, cuando uses el Explorador de métricas, ve al panel de consulta y selecciona Agregar elemento de consulta. En el menú, selecciona Intervalo mínimo y, luego, un intervalo de tiempo.

El período de alineación cambia cuando se modifica el intervalo de tiempo

Agregas un gráfico a un panel. Cuando cambias el intervalo de tiempo del panel o el del gráfico, a veces cambia el período de alineación. Por ejemplo, si cambias el período de una hora a dos horas, el período de alineación se muestra como 1 minute interval. Sin embargo, si cambias el intervalo de tiempo de una hora a un día, el período de alineación se muestra como 5 minute interval.

Se espera que esto suceda.

Los gráficos tienen un límite en la cantidad de datos que pueden mostrar. Por lo tanto, cuando la cantidad de datos disponibles para el período seleccionado es mayor que el límite de visualización, Monitoring modifica automáticamente la configuración de alineación para reducir la cantidad de datos que se mostrarán.

El gráfico no muestra todas las series temporales

Configuras un gráfico, pero no muestra todas las series temporales.

Por motivos de rendimiento, los gráficos están configurados para mostrar un máximo de 50 series temporales.

Cuando configuras un gráfico y hay más de 50 series temporales disponibles, el gráfico limita la cantidad de series temporales que se muestran y agrega un ícono con un punto rojo a la barra de herramientas. La información sobre la herramienta para el ícono muestra el siguiente mensaje:

To improve performance, we've limited the time series displayed in this chart.

Para mostrar todas las series temporales, expande la información sobre la herramienta y selecciona el botón etiquetado como Mostrar todas las series temporales.

El gráfico no muestra ningún dato

Configuras un gráfico, pero este muestra un mensaje de error en lugar de datos:

• Cuando no hay datos disponibles para el período especificado en el gráfico, se muestra el siguiente mensaje:

  No data is available for the selected time frame.
  

  Para resolver el problema, prueba lo siguiente:

  • Aumenta el intervalo de tiempo del gráfico. Algunos tipos de métricas, como las que informan el uso de la cuota, proporcionan solo una muestra por día.

  • Cambia el tipo de métrica seleccionado para tu gráfico. Es posible que el tipo de métrica que especifica tu gráfico esté inactivo. Un tipo de métrica está inactivo cuando no hay ninguna serie temporal para el tipo.

• Cuando no se reconoce el tipo de métrica o el tipo de recurso especificado por la consulta, se muestra el siguiente mensaje:

  An error occurred requested data. One or more resources could not be found.
  

  Para resolver este problema, realiza las siguientes acciones:

  • Verifica que se definan el tipo de métrica y el tipo de recurso especificados en la consulta. Puedes usar la interfaz basada en menús para los gráficos con el objetivo de buscar el tipo de métrica.

  • Verifica la ortografía del tipo de métrica y del tipo de recurso en la consulta.

El gráfico muestra una advertencia sobre metadatos sensibles

Abres un panel personalizado y esperas que todos los widgets muestren datos. Sin embargo, uno o más widgets que contienen consultas en SQL muestran mensajes similares a los siguientes:

This SQL query is configured to run on the BigQuery engine using [PROJECT_ID],
and references resources from [RESOURCE, ...]. Sensitive metadata,
including table contents, may be written to [PROJECT_ID].

El mensaje de advertencia indica que la consulta cruza los límites de propiedad y te brinda la oportunidad de verificarla antes de que se ejecute. Los límites de propiedad se determinan por varios factores, uno de los cuales es la jerarquía de los recursos que usa la consulta.

El sistema realiza verificaciones de límites cada vez que se abre un panel. No puedes impedir ni descartar estas advertencias.

Nota: Si determinas que no es seguro ejecutar una consulta, cierra el panel. También deberías considerar borrar el panel. No ejecutes la consulta.

Si un widget muestra el mensaje de advertencia, puedes realizar cualquiera de las siguientes acciones:

• Si sabes que la consulta es segura para ejecutar y quieres ver los resultados, haz clic en Confirmar y ejecutar.

• Debes ignorar este mensaje de error. Este widget no mostrará datos de tu sesión actual.

• Analiza la consulta y, si es necesario, inhabilítala. Por ejemplo, puedes hacer lo siguiente:

  1. Inspecciona la consulta y evalúa qué datos se consultan.
  2. Revisa el historial del panel para determinar quién agregó el widget y cuándo.
  3. Si recibiste un vínculo al panel, verifica que el remitente sea una fuente de confianza.
  4. Para referencia futura, guarda tu análisis en el panel agregando un widget de Texto.

Google Cloud proporciona algunas funciones que pueden ayudar a evitar el robo de datos a través de phishing, ataques de usuarios con información privilegiada o entidades externas. Para obtener más información, consulta Seguridad de los datos con Estadísticas de observabilidad.

El gráfico con varias métricas muestra un mensaje de error

Estás configurando un gráfico para mostrar varias métricas y el gráfico muestra el siguiente mensaje de error:

    The units for queries using the same Y-axis must be the same for the chart
    to render correctly.

Los gráficos pueden mostrar varios tipos de métricas, y puedes asignar un tipo de métrica al eje Y izquierdo o al eje Y derecho. Las unidades de todos los tipos de métricas asignados al eje Y izquierdo deben ser las mismas; de lo contrario, se muestra el mensaje de error anterior. Del mismo modo, las unidades de todos los tipos de métricas asignados al eje Y derecho deben ser las mismas, o se mostrará el mensaje de error anterior.

Para resolver este error, haz lo siguiente:

1. Si tu gráfico contiene métricas con más de dos tipos de unidades, quítalas hasta que solo tengas dos tipos de unidades.

2. Asigna todas las métricas con un tipo de unidad al eje Y izquierdo y todas las métricas con el otro tipo de unidad al eje Y derecho.

El gráfico con varias métricas muestra datos inesperados

Se configuró un gráfico para mostrar varias métricas y se agregaron filtros para mostrar solo series temporales específicas. Sin embargo, el gráfico muestra series temporales que no cumplen con los filtros.

Para resolver esta situación, asegúrate de aplicar filtros a cada métrica que se grafica.

Por ejemplo, en la siguiente captura de pantalla, se muestra el panel de configuración del Explorador de métricas para un gráfico que muestra la cantidad de bytes que leen y escriben las instancias de máquina virtual (VM):

En la captura de pantalla, hay un encabezado para cada tipo de métrica que muestra el gráfico.

Por ejemplo, si deseas que el gráfico muestre series temporales solo para las VMs que están en la zona us-central1-a, agrega el filtro zone = us-central1-a a cada consulta.

No se pueden seleccionar valores de filtro para los gráficos definidos por PromQL

Crea gráficos en un panel personalizado y configúralos con PromQL. Luego, creas filtros de panel permanentes. Cuando ves el panel, intentas cambiar el valor predeterminado del filtro, pero no se muestra el menú de valores de etiqueta o el menú de valores de etiqueta no es correcto:

Para resolver este problema, ingresa el valor del filtro y, luego, selecciona Aplicar. Por ejemplo, si la clave de filtro es zone, puedes ingresar us-central1-a.

Faltan etiquetas de metadatos del usuario en los menús de filtro o agrupación

Configuras un gráfico con los menús, pero los menús Filtro y Agregación no muestran las etiquetas de metadatos del usuario, como goog-dataproc-* o dataflow-*.

Para filtrar o agrupar series temporales cuando las etiquetas de metadatos del usuario no aparecen en los menús, consulta las series temporales con PromQL o modo de filtro directo:

• En PromQL, antepone la clave de etiqueta de metadatos del usuario con metadata_user_ y encierra la clave entre comillas dobles si contiene caracteres especiales, como guiones. Por ejemplo, la siguiente consulta de PromQL filtra el uso de CPU de la VM de Compute Engine para las series temporales que tienen una etiqueta de metadatos de usuario goog-dataproc-cluster-name no vacía:

  {"compute.googleapis.com/instance/cpu/utilization", monitored_resource="gce_instance", "metadata_user_goog-dataproc-cluster-name"!=""}
  

• En el modo de filtro directo, filtra por metadata.user_labels. Por ejemplo, para filtrar por una etiqueta de metadatos de usuario goog-dataproc-cluster-name no vacía, ingresa metadata.user_labels."goog-dataproc-cluster-name"!="".

Errores del panel

En esta sección, se describen los errores que podrías ver cuando creas o editas paneles.

No se puede crear el panel

Para crear un panel, usa una descripción en JSON o YAML del panel, y esa descripción incluye un campo name. Cambias el nombre visible y tratas de crear un segundo panel, pero recibes un error. Por ejemplo, si usas Google Cloud CLI, obtendrás el siguiente error:

ERROR: (gcloud.alpha.monitoring.dashboards.create) Resource in projects [xxxxxxx] is the subject of a conflict: Requested entity already exists.

La causa de la falla es que el ID del panel, que identifica este panel en el valor del campo name, ya existe. Por lo tanto, no se puede crear el panel.

Si especificas el campo name cuando creas un panel, el valor que especifiques debe ser único a nivel global. El campo name tiene la siguiente sintaxis:

"name": "projects/PROJECT_ID_OR_NUMBER/dashboards/DASHBOARD_ID"

No es necesario que el nombre visible sea único.

El panel no muestra todos los eventos

Configuras un panel para mostrar eventos; sin embargo, solo se muestran los eventos recientes. No se muestran los eventos más antiguos.

Para solucionar este problema, realiza una de las siguientes acciones:

• Usa un período más corto. Por ejemplo, muestra los datos de la hora más reciente en lugar del día más reciente o selecciona un período personalizado.

• Agrega filtros.

Por motivos de rendimiento, los paneles tienen un límite en la cantidad de eventos que pueden mostrar. Cuando se alcanzan estos límites, los paneles muestran solo los eventos más recientes.

Se cambia la escala del panel creado con Terraform

Creaste un panel con Terraform y, luego, lo editaste con la consola de Google Cloud . Esperabas que el panel no cambiara, excepto por tus ediciones. En cambio, se cambia la escala del panel. Por ejemplo, tu panel tenía 12 columnas y ahora tiene 48.

No uses la consola de Google Cloud para editar los paneles que se crearon con Terraform. Cuando se edita el panel, el tamaño se escala por un factor de cuatro.

El widget de la política de alertas no muestra ningún dato

Un panel contiene un gráfico para una política de alertas, pero el gráfico no muestra ningún dato.

Para resolver esta situación, realiza las siguientes acciones:

• Visualiza la configuración del gráfico y asegúrate de que se haya seleccionado una política de alertas. Si no se muestra ninguna política de alertas, asocia el gráfico con una política de alertas o bórralo del panel.

  Los gráficos de los paneles que muestran datos de una política de alertas dejan de mostrar datos cuando se borra la política de alertas a la que se hace referencia. Borrar una política de alertas no borra los gráficos que hacen referencia a esa política.

• Consulta los detalles de la política de alertas y verifica que contenga una sola condición.

  Los gráficos de los paneles que muestran datos de una política de alertas dejan de mostrar datos si la política de alertas se modifica para que contenga varias condiciones. Para resolver este problema, asocia el gráfico con una política de alertas de condición única o bórralo del panel.

• Aumenta el intervalo de tiempo. El selector de período debe establecerse en un valor mayor que el período de muestreo de los datos. Si bien la mayoría de las métricas se muestrean cada 60 segundos, algunas se muestrean con poca frecuencia. Por ejemplo, la métrica serviceruntime.googleapis.com/quota/limit se muestrea cada 86,400 segundos (1 día).

El panel de registros informa una consulta no válida

Verás el mensaje de error "Error: Invalid query" y el panel de registros no mostrará ninguna entrada de registro.

Para resolver este problema, reduce la cantidad de proyectos cuyos registros se configuró para mostrar el panel de registros.

Para obtener más información sobre esta condición de falla, consulta La consulta muestra un error.

El panel de registros informa que no se encontraron entradas

Verás el mensaje de error "No se encontraron entradas que coincidan con el filtro actual" en un panel de registros. Existen varios motivos por los que podrías ver este mensaje. Verifica lo siguiente:

• Para cada proyecto cuyas entradas de registro quieras ver, asegúrate de que se cumpla una de las siguientes condiciones:

  • Tienes el rol de Visualizador de registros (roles/logging.viewer).

  • Para los roles personalizados, tienes los siguientes permisos:

    • logging.logs.list
    • logging.logServiceIndexes.list
    • logging.logServices.list

• Asegúrate de que las cláusulas del editor de consultas no entren en conflicto con la configuración que se muestra en el panel de registros.

  Por ejemplo, cuando el campo Editor de consultas contiene severity=NOTICE, el panel de registros recupera todos los registros que tienen un nivel de gravedad de exactamente NOTICE. Si el menú Gravedad del panel de registros está configurado en "Advertencia", el panel de registros mostrará "No se encontraron entradas que coincidan con el filtro actual". El mensaje se muestra porque ninguna de las entradas de registro recuperadas tiene un nivel de gravedad de, al menos, "Advertencia".

  En cambio, cuando el campo Editor de consultas contiene severity=WARNING y el menú Gravedad del panel de registros está configurado como "Aviso", es posible que veas entradas de registro. Con esta configuración, el panel de registros recupera los registros cuyo nivel de gravedad es WARNING. Luego, esa lista de registros se filtra para mostrar solo aquellos cuya gravedad sea, al menos, "Aviso", y todos los registros recuperados tienen, al menos, ese nivel de gravedad.

El panel Registros indica que muestra datos parciales

Verás un indicador de advertencia y el mensaje "Mostrando resultados parciales" en un panel de registros.

Cuando no tienes permiso para ver los registros de un proyecto de Google Cloud cuyos registros seleccionaste para mostrar, se muestra este indicador. Para quitar el indicador de advertencia, realiza una de las siguientes acciones:

• Comunícate con el administrador del sistema y pídele que realice una de las siguientes acciones para cada proyecto de Google Cloud cuyos registros quieras ver:

  • Otorgarte el rol de Visualizador de registros (roles/logging.viewer).

  • Para los roles personalizados, otorga los siguientes permisos:

    • logging.logs.list
    • logging.logServiceIndexes.list
    • logging.logServices.list

• Cambia la configuración del panel de registros para que solo se muestren los registros de los proyectos deGoogle Cloud en los que tienes permiso para ver las entradas de registro.

El panel de registros muestra un mensaje de permiso denegado

El widget del panel de registros en un panel muestra el siguiente mensaje de permiso denegado:

Error: Permission 'logging.views.access' denied on resource (or it may not exist).

Para solucionar este problema, haz lo siguiente:

1. Editar el widget del panel de registros

2. Realiza una de las siguientes acciones:

   • Establece el menú Alcance por en Proyecto y, luego, usa el menú Proyectos para seleccionar Proyecto actual.

   • Quita del menú Vistas de almacenamiento las vistas de registro que no tienes permiso para ver. Para obtener información sobre los roles de IAM necesarios para acceder a las vistas de registro, consulta Otorga acceso a una vista de registro.

     Cuando el widget del panel de registros busca vistas de registro, debes tener permiso para leer las entradas de registro en todas las vistas de registro que se enumeran. De lo contrario, se mostrará un mensaje de error.

3. Haz clic en Aplicar.

La tabla no muestra todas las series temporales

Configuras una tabla, pero no muestra todas las series temporales.

Por motivos de rendimiento, las tablas están configuradas para mostrar un máximo de 300 filas.

La llamada a la API para crear un panel con un panel de registros falla

Existen varios motivos por los que puedes ver un mensaje de error cuando creas un panel con un panel de registros:

• Cuando el panel de registros no cumple con los requisitos mínimos de altura o ancho, se muestra el siguiente error:

  Unable to save dashboard: Field mosaicLayout.tiles[0] has an invalid value: LogsPanel must have a minimum width of 3 and height of 3.
  

  Para resolver esta condición, en la representación JSON del panel, asegúrate de que los campos height y width del widget del panel de registros cumplan con los requisitos mínimos.

• Cuando el campo logsPanel.filter supera los 2,000 caracteres, se muestra el siguiente error:

  Unable to save dashboard: filter cannot be greater than 2000 characters.
  

  Para resolver esta condición, acorta el filtro.

• Cuando falta el campo resourceNames, verás el siguiente mensaje de error:

  Unable to save dashboard: Dashboard is missing required field mosaicLayout.tiles[0].widget.logsPanel.resourceNames.
  

  Para resolver esta condición, agrega un campo resourceNames al JSON del panel.

• Cuando la sintaxis del campo resourceNames es incorrecta, verás un error similar al siguiente:

  Unable to save dashboard: Field mosaicLayout.tiles[0].widget.logsPanelWidget.resourceNames has an invalid value of "a-project": resource name must have the format `projects/{project}`.
  

  Para resolver esta condición, reemplaza a-project por projects/a-project en el JSON del panel.

• Para obtener información sobre cómo resolver errores de sintaxis en el campo filter, consulta Solución de problemas: problemas de sintaxis.

Para ver un ejemplo de un archivo JSON con el formato correcto, consulta Panel con un widget LogsPanel.

Importa paneles de Grafana

Para obtener información sobre el uso y la solución de problemas del importador de panel, consulta Importa paneles de Grafana a Cloud Monitoring.

Para obtener información sobre los problemas con la conversión del contenido del panel, consulta el archivo README del importador.