Cómo generar gráficos con los resultados de las consulta en SQL

En este documento, se describe cómo generar gráficos con los resultados de las consultas de Análisis de registros, que emiten consultas en SQL. Analizar tus datos de registro y de seguimiento con SQL te permite identificar patrones y tendencias. Puedes ver los resultados de tu consulta como una tabla o visualizarlos creando un gráfico. También puedes guardar un gráfico en un panel personalizado.

En la siguiente captura de pantalla, se muestran los resultados de la consulta de ejemplo de seguimiento, que se muestra más adelante en este documento. En la captura de pantalla, se muestra el estado que informan los intervalos, después de agregar las respuestas por hora y por service_name:

Antes de comenzar

Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Habilita la API de Observability.

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

Habilitar la API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Habilita la API de Observability.

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

Habilitar la API

1. Para obtener los permisos que necesitas para cargar la página Log Analytics, escribir y ejecutar consultas en tus datos de registros y de seguimiento, y guardar gráficos en paneles personalizados, pídele a tu administrador que te otorgue los siguientes roles de IAM:

   • Editor de Monitoring (roles/monitoring.editor) en tu proyecto
   • Usuario con acceso a vistas de observabilidad (roles/observability.viewAccessor) en las vistas de observabilidad que deseas consultar. Este rol admite condiciones de IAM, que te permiten restringir el otorgamiento a una vista específica. Si no adjuntas una condición al otorgamiento del rol, la principal podrá acceder a todas las vistas de observabilidad. Las vistas de observabilidad están disponibles en versión preliminar pública.
   • Visor de registros (roles/logging.viewer) en tu proyecto
   • Descriptor de acceso de vista de registros (roles/logging.viewAccessor) en el proyecto que almacena las vistas de registros que deseas consultar.

   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 a través de roles personalizados o cualquier otro rol predefinido.

Selecciona los datos para graficarlos

Para configurar los datos que se mostrarán en un gráfico, crea una consulta con SQL. Cuando seleccionas la pestaña Gráfico, se muestra un gráfico con los resultados de tu búsqueda. Después de ejecutar la consulta y generar un gráfico, puedes personalizar la configuración del gráfico cambiando el tipo de gráfico y seleccionando columnas para ver diferentes datos.

Para ver los resultados de la consulta como un gráfico, ejecuta una consulta de la siguiente manera:

1. En la consola de Google Cloud , ve a la página Análisis de registros:

   Ir a Análisis de registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

2. En el panel Consulta, ingresa una consulta y, luego, haz clic en Ejecutar.

3. Una vez que se complete la consulta, en la pestaña Resultados, selecciona cómo deseas ver los resultados de la consulta:

   • Tabla: Solo formato tabular.

   • Gráfico: Solo formato de gráfico

   • Ambos: Formato de gráfico y tabla.

     Después de seleccionar cómo ver los resultados de la consulta, puedes configurar los campos de la visualización seleccionada y, luego, guardar la consulta y los resultados en un panel personalizado. El formato guardado es tabular cuando seleccionaste la opción Tabla. De lo contrario, el formato es un gráfico.

     En el caso de los gráficos, las opciones de visualización te permiten seleccionar el tipo de gráfico y elegir qué filas y columnas se incluirán en el gráfico. Para obtener más información sobre la configuración del gráfico, consulta Cómo personalizar la configuración del gráfico.

Personaliza la configuración del gráfico

Puedes personalizar la configuración del gráfico cambiando el tipo de gráfico, seleccionando la dimensión y la medida que se incluirán en el gráfico, y aplicando un desglose. La dimensión se usa para agrupar o categorizar filas y es el valor del eje X. La medida, o el valor del eje Y, es una serie de datos que se traza en el eje Y.

Cambiar el tipo de gráfico

Puedes seleccionar uno de los siguientes tipos de gráficos, según el tipo de filas y columnas que hayas seleccionado como dimensión y medida, y cómo deseas que se visualicen esos datos.

• Gráfico de barras (predeterminado): Los gráficos de barras representan los datos en dos ejes. Si tu gráfico usa una categoría o una cadena como dimensión, puedes establecer la configuración del gráfico de barras como horizontal o vertical, en la que se intercambian los ejes de dimensión y medida.

• Gráfico de líneas: Los gráficos de líneas se pueden usar para mostrar los cambios en los datos a lo largo del tiempo. Cuando usas un gráfico de líneas, cada serie temporal se muestra con una línea diferente que corresponde a las medidas que seleccionaste.

  Si tu eje X se basa en el tiempo, cada punto de datos se coloca al comienzo de un intervalo de tiempo. Cada punto de datos se conecta a través de una interpolación lineal.

• Gráfico de áreas apiladas: Un gráfico de áreas se basa en un gráfico de líneas, y el área debajo de cada línea está sombreada. En los gráficos de áreas, las series de datos se apilan. Por ejemplo, si tienes dos series idénticas, estas se superpondrán en un gráfico de líneas, pero el área sombreada se apilará en un gráfico de áreas.

• Gráfico circular o de anillo: Un gráfico circular muestra cómo se relacionan las categorías de un conjunto de datos con el conjunto de datos completo. Para ello, usa un círculo para representar el conjunto de datos completo y secciones en el círculo para representar las categorías del conjunto de datos. El tamaño de una porción indica cuánto, a menudo como porcentaje, contribuye la categoría al total.

• Tabla: Una tabla muestra una fila por cada fila del resultado de la consulta. Las columnas de la tabla se definen con la cláusula SELECT. Si planeas mostrar datos en formato tabular en un panel, usa una cláusula LIMIT para restringir la cantidad de filas en el resultado a menos de unos cientos.

• Medidor o cuadro de evaluación: Los medidores y los cuadros de evaluación te proporcionan el valor más reciente junto con una indicación verde, ámbar o roja según cómo se compare ese valor con un conjunto de umbrales. A diferencia de los indicadores, que solo muestran información sobre el valor más reciente, los cuadros de evaluación también pueden incluir información sobre valores anteriores.

  Los indicadores y los cuadros de evaluación solo pueden mostrar el resultado de la consulta cuando este contiene al menos una fila, y esa fila contiene una columna con una marca de tiempo y una columna con datos numéricos. El resultado de la consulta puede contener varias filas y más de dos columnas.

  Si deseas realizar la agregación basada en el tiempo como parte de tu consulta, haz lo siguiente:

  • Configura tu consulta para agregar datos en un intervalo de tiempo, ordenar los resultados por marcas de tiempo descendentes y limitar la cantidad de filas en los resultados. Puedes usar la cláusula LIMIT o el selector de período para limitar la cantidad de filas en el resultado de la consulta.

    Datos de registros

    Por ejemplo, la siguiente consulta una vista de registro y agrega datos por hora, aplica un límite y ordena los resultados:

    SELECT TIMESTAMP_TRUNC(timestamp, HOUR) AS hour, severity, COUNT(*) AS count
    FROM `PROJECT_ID.LOCATION.BUCKET_ID.LOG_VIEW_ID`
    WHERE severity IS NOT NULL AND severity = "DEFAULT"
    GROUP BY hour,severity
    ORDER BY hour DESC
    LIMIT 10
    

    A continuación, se describe el significado de los campos en la expresión anterior:

    • PROJECT_ID: Es el identificador del proyecto.
    • LOCATION: Es la ubicación de la vista de registros o la vista de estadísticas.
    • BUCKET_ID: Es el nombre o el ID del bucket de registros.
    • LOG_VIEW_ID: Es el identificador de la vista de registros, que se limita a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

    Datos de seguimiento

    Versión preliminar

    Este producto o función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

    Por ejemplo, la siguiente consulta tus datos de seguimiento y los agrega en intervalos de una hora, aplica un límite y ordena los resultados:

    SELECT TIMESTAMP_TRUNC(start_time, HOUR) AS hour,
       COALESCE(
          JSON_VALUE(resource.attributes, '$."service.name"'),
          JSON_VALUE(attributes, '$."service.name"'),
          JSON_VALUE(attributes, '$."g.co/gae/app/module"')) AS service_name,
       status.code AS status,
       COUNT(*) AS count
    FROM `PROJECT_ID.LOCATION._Trace.Spans._AllSpans`
    GROUP BY hour, service_name, status
    ORDER BY hour DESC
    LIMIT 1000
    

    A continuación, se describe el significado de los campos en la expresión anterior:

    • PROJECT_ID: Es el identificador del proyecto.
    • LOCATION: Es la ubicación del bucket de observabilidad.

    La consulta anterior se usó para generar la figura que se muestra al comienzo de este documento. En esa figura, también se muestra la configuración del gráfico.

  • Establece la Dimensión para que coincida con la columna que informa la unidad de tiempo. Por ejemplo, si tu consulta agrega datos por hora y crea una columna llamada hour, establece el menú Dimensión en hour.

  • Selecciona Inhabilitar intervalo porque tu búsqueda ya especifica el intervalo de agregación. En el ejemplo, este intervalo es de una hora.

  • Establece la medida en la columna numérica y la función en none.

    Nota: Si tu consulta realiza una agregación basada en el tiempo, asegúrate de seguir la orientación anterior. Otros parámetros de configuración hacen que tanto tu consulta como Log Analytics realicen operaciones de agregación, lo que genera que el medidor o el cuadro de evaluación muestren valores inesperados.

  Si deseas confiar en el Análisis de registros para que realice la agregación basada en el tiempo, haz lo siguiente:

  • Configura el selector de intervalo de tiempo, que afecta la cantidad de filas en el resultado de la consulta.
  • Establece la Dimensión para que coincida con la columna que informa la unidad de tiempo. Por ejemplo, puedes configurar este menú como timestamp.
  • Establece el menú Interval en el intervalo de agregación a un intervalo específico. Por ejemplo, establece el valor de este campo en 1 hour. No selecciones Intervalo automático.
  • Establece la Medida en la columna numérica y selecciona una función, como suma.

Cambia la dimensión y la métrica

Puedes elegir qué filas y columnas se incluirán en el gráfico seleccionando los campos de dimensión y medición.

Nota: Si los resultados de tu consulta contienen una columna con cadenas largas, como mensajes de error, y seleccionas esa columna para que sea la dimensión o el desglose, es posible que tu gráfico tenga errores o valores inesperados.

• Dimensión

  La dimensión debe ser una columna de marca de tiempo, numérica o de cadena. De forma predeterminada, la dimensión se establece en la primera columna basada en la marca de tiempo del esquema. Si no hay ninguna marca de tiempo en la consulta, se selecciona la primera columna de cadena como dimensión. También puedes personalizar la dimensión en el panel Visualización del gráfico. Cuando se selecciona una columna de marcas de tiempo como dimensión, el gráfico muestra cómo cambian los datos con el tiempo. Cuando se selecciona una columna de cadena como la dimensión de un gráfico de barras, puedes ordenar los datos de forma ascendente o descendente, lo que ordena la dimensión por orden léxico. También puedes mantener el orden de clasificación "predeterminado", que ordena la dimensión según los valores de la métrica correspondiente en orden descendente.

  De forma predeterminada, el intervalo para las marcas de tiempo se establece automáticamente, pero también puedes seleccionar un intervalo personalizado. Los intervalos automáticos cambian los valores según el selector de períodos para mantener grupos de tamaño similar.

  También puedes inhabilitar el intervalo, lo que te permite especificar tus propias agregaciones y períodos dentro de la consulta para realizar análisis más complejos. Si se inhabilita el intervalo, se establece la función de agregación de las medidas en none. Solo se permiten las medidas numéricas cuando el intervalo de dimensiones está inhabilitado.

  Nota: Solo la columna TIMESTAMP se puede usar como dimensión de marca de tiempo. Para usar DATE y DATETIME, debes usar la función CAST() para convertir los tipos de datos a TIMESTAMP.

• Medir

  Puedes seleccionar varias medidas en el panel Visualización del gráfico. Cuando seleccionas una métrica, también debes seleccionar la función de agregación que se realizará en sus valores agrupados, como count, sum, average y percentile-99. Por ejemplo, count-distinct devuelve la cantidad de valores únicos en una columna determinada.

  Si seleccionas la casilla de verificación Inhabilitar intervalo para la dimensión, estará disponible la opción de función de agregación none. Si la dimensión es un valor de cadena, no se muestra la casilla de verificación Inhabilitar intervalo. Sin embargo, si estableces las funciones de agregación de una métrica en none, también se inhabilita el intervalo.

Agregar un desglose

Nota: Si tu gráfico contiene más de una métrica, no podrás agregar un desglose.

Para dividir una sola serie de datos en varias series de datos según otra columna, agrega un desglose.

Cuando selecciones un desglose, elige columnas que contengan una pequeña cantidad de etiquetas cortas y significativas, como region_name, en lugar de campos que puedan contener una gran cantidad de cadenas o cadenas largas, como textPayload.

Datos de registros

Por ejemplo, consulta la siguiente configuración del gráfico, en la que el campo Dimensión está establecido en type, el campo Medida está establecido en Contar filas y el campo Desglose está establecido en gravedad:

En la captura de pantalla anterior, se muestra una serie de datos apilados, en la que el tipo de recurso k8s_container se divide en diferentes tipos de severity. Esto te permite identificar cuántos registros de cada tipo de gravedad generó un recurso determinado.

Datos de seguimiento

Versión preliminar

Este producto o función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Por ejemplo, el siguiente gráfico muestra la cantidad de tramos creados por cada servicio, junto con los datos desglosados por el nombre del tramo:

Cómo guardar un gráfico en un panel personalizado

Después de que se genere un gráfico a partir de tu consulta, puedes guardarlo en un panel personalizado. Los paneles personalizados te permiten mostrar y organizar información que te resulte útil con una variedad de tipos de widgets. Estos paneles también te permiten definir variables, que son filtros a nivel del panel que se aplican solo a widgets específicos. Para aplicar una variable a un widget, debes modificar la consulta. Para obtener más información, consulta Cómo aplicar una variable a un widget.

Un panel muestra un mensaje de advertencia para un widget que contiene una consulta en SQL cuando la consulta se ejecuta en el motor de BigQuery y los recursos consultados no se encuentran en el mismo límite de propiedad. Los límites de propiedad se determinan según varios factores, uno de los cuales es la jerarquía de los recursos que usa la búsqueda. Para evitar estas advertencias, configura un perímetro de servicio.

Para guardar el gráfico en un panel, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Análisis de registros:

   Ir a Análisis de registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

2. Ejecuta una consulta para generar un gráfico y, luego, haz clic en Guardar gráfico en la pestaña Gráfico.

3. En el cuadro de diálogo Guardar en el panel, ingresa un título para el gráfico y selecciona el panel en el que deseas guardarlo.

4. Opcional: Para ver el panel personalizado, haz clic en Ver panel en la notificación.

Para ver una lista de los paneles personalizados que contienen gráficos generados por consultas en SQL, ve al botón Guardar gráfico y haz clic en Menú.

Cómo editar un gráfico guardado en un panel personalizado

Puedes modificar un gráfico después de guardarlo en un panel. Para obtener más información, consulta Cómo modificar la configuración de un widget. En el diálogo Configurar widget, puedes hacer lo siguiente:

• Cambia los datos que consultas.
• Edita la consulta que se usa para generar un gráfico.
• Personaliza la configuración del gráfico para visualizar diferentes datos.

Limitaciones

• Si tu proyecto Google Cloud se encuentra en una carpeta que usa Assured Workloads, los gráficos que generes no se podrán mostrar en un panel personalizado.

• Los filtros a nivel del panel no se aplican a los gráficos generados a partir de una consulta en SQL.

• Las columnas seleccionadas deben tener al menos una fila con un valor no nulo.

• Si guardas una consulta y personalizas la configuración del gráfico, no se guardará la configuración personalizada del gráfico.

• Si tu consulta ya contiene agregaciones, es posible que el gráfico generado sea diferente debido a la agregación adicional que aplica automáticamente el Análisis de registros.

• Las rutas de acceso JSON se deben convertir en cadenas o números para poder generar gráficos.

¿Qué sigue?

• Guarda y comparte consultas.
• Consultas en SQL de muestra