Cómo consultar y analizar registros

Puedes consultar y analizar tus datos de seguimiento con SQL en Estadísticas de observabilidad para descubrir tendencias de rendimiento, generar estadísticas agregadas y mostrar resultados en gráficos y tablas. Consultas la vista predeterminada, que se llama _AllSpans y que incluye todos los datos de seguimiento almacenados por tu proyecto. También puedes guardar los resultados de las consultas en tus paneles personalizados.

Si deseas inspeccionar seguimientos o intervalos individuales, o atributos de intervalos, usa la página Explorador de Trace. Para obtener más información, consulta Busca y explora seguimientos.

Acerca de los conjuntos de datos vinculados de BigQuery

No necesitas un conjunto de datos vinculado de BigQuery para consultar tus datos de seguimiento ni para consultar tus datos de seguimiento y registro. Para esas situaciones, puedes usar la página Estadísticas de observabilidad. Para obtener información sobre cómo consultar datos de registro, consulta Consulta y analiza registros con Estadísticas de observabilidad.

Necesitas un conjunto de datos vinculado de BigQuery cuando deseas realizar cualquiera de las siguientes acciones:

En este documento, no se describe cómo crear un conjunto de datos vinculado de BigQuery ni cómo configurar Estadísticas de observabilidad para ejecutar consultas en ranuras reservadas. Para obtener información sobre estos temas, consulta Crea un conjunto de datos vinculado de BigQuery.

Antes de comenzar

  1. Accede a tu Google Cloud cuenta de. 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.

  2. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  5. 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

  8. Para obtener los permisos que necesitas para cargar la página Estadísticas de observabilidad, escribir, ejecutar y guardar consultas privadas sobre tus datos de seguimiento, pídele a tu administrador que te otorgue los siguientes roles de IAM:

    • 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.
    • Usuario de Estadísticas de observabilidad (roles/observability.analyticsUser) en tu proyecto. Este rol contiene los permisos necesarios para guardar y ejecutar consultas privadas, y para ejecutar consultas compartidas.

    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.

Muestra el esquema

El esquema define cómo se almacenan los datos, lo que incluye los campos y sus tipos de datos. Esta información es importante para ti porque el esquema determina los campos que consultas y si necesitas convertir campos a diferentes tipos de datos. Por ejemplo, para escribir una consulta que calcule la latencia promedio de las solicitudes HTTP , debes saber cómo acceder al campo de latencia y si se almacena como un número entero, como 100, o como una cadena, como "100". Si los datos de latencia se almacenan como una cadena, la consulta debe convertir el valor a un valor numérico antes de calcular un promedio.

Para identificar el esquema, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

    Ir a Estadísticas de observabilidad

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

  2. En el menú Vistas, ve a la sección Seguimientos y, luego, selecciona _Trace.Spans._AllSpans.

    Se actualiza el panel Esquema. Estadísticas de observabilidad infiere automáticamente los campos de una columna cuando el tipo de datos es JSON. Para ver con qué frecuencia aparecen estos campos inferidos en tus datos, haz clic en Opciones y selecciona Ver información y descripción.

    Para obtener información sobre el esquema, consulta Esquema de almacenamiento para datos de seguimiento.

    Si no ves una vista llamada _Trace.Spans._AllSpans, significa que tu Google Cloud proyecto no contiene un bucket de observabilidad llamado _Trace. Para obtener información sobre cómo resolver esta falla, consulta No se puede inicializar el almacenamiento de Trace.

Consulta datos de seguimiento

En esta sección, se describen los enfoques que puedes usar para consultar tus datos de seguimiento:

  • Carga una consulta definida por el sistema, edítala y, luego, ejecútala.
  • Ingresa y ejecuta una consulta personalizada. Por ejemplo, puedes pegar una consulta que tengas o escribir una. Las consultas personalizadas pueden incluir uniones, consultas anidadas y otras instrucciones complejas de SQL. Para ver ejemplos, consulta Consultas en SQL de muestra.
  • Compila una consulta haciendo selecciones de menú y, luego, ejecuta esa consulta. Estadísticas de observabilidad convierte tus selecciones en una consulta en SQL, que puedes ver y editar.

Carga, edita y ejecuta la consulta definida por el sistema

  1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

    Ir a Estadísticas de observabilidad

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

  2. En el menú Vistas, ve a la sección Seguimientos y, luego, selecciona _Trace.Spans._AllSpans.

    Si no ves una vista llamada _Trace.Spans._AllSpans, significa que tu Google Cloud proyecto no contiene un bucket de observabilidad llamado _Trace. Para obtener información sobre cómo resolver esta falla, consulta No se puede inicializar el almacenamiento de Trace.

  3. Realiza una de las siguientes acciones:

    • Para cargar una consulta definida por el sistema que se basa en el Compilador de consultas, que te permite definir la consulta con selecciones de menú, asegúrate de que el panel Consulta muestre Compilador de consultas. Si se muestra un editor de SQL, entonces haz clic en  Compilador.

    • Para cargar una consulta definida por el sistema que extrae valores JSON, asegúrate de que el panel Consulta muestre el editor de SQL. Si este panel muestra Compilador de consultas, haz clic en  SQL.

  4. En el panel Esquema, selecciona Consulta y, luego, haz clic en Anular.

    El panel Consulta muestra una consulta definida por el sistema. Si seleccionaste el Compilador de consultas modo pero deseas ver la consulta en SQL, haz clic en  SQL.

  5. Opcional: Modifica la consulta.

  6. Para ejecutar la consulta, ve a la barra de herramientas y selecciona Ejecutar consulta.

    Estadísticas de observabilidad presenta los resultados de la consulta en una tabla. Sin embargo, puedes crear un gráfico y también guardar la tabla o el gráfico en un panel personalizado. Para obtener más información, consulta Grafica consulta en SQL SQL.

    Si la barra de herramientas muestra Ejecutar en BigQuery, debes cambiar Estadísticas de observabilidad para que use el motor de consultas predeterminado. Para realizar este cambio, en la barra de herramientas del panel Consulta, haz clic en Configuración y, luego, selecciona Analytics (predeterminado).

Ingresa y ejecuta una consulta personalizada

Para ingresar una consulta en SQL, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

    Ir a Estadísticas de observabilidad

    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, haz clic en  SQL.

    • Para especificar un período, te recomendamos que uses el selector de período. Si agregas una cláusula WHERE que especifica el campo timestamp, ese valor anula la configuración en el selector de período y ese selector se inhabilita.

    • Para ver ejemplos, consulta Consultas en SQL de muestra.

    • El editor de SQL muestra el nombre completamente calificado para la vista _Trace.Spans._AllSpans, que tiene el siguiente formato:

      FROM `PROJECT_ID.LOCATION._Trace.Spans._AllSpans`

      Los campos de la expresión anterior tienen el siguiente significado:

      Si el panel de consultas muestra un mensaje de error que hace referencia a la instrucción FROM, no se puede encontrar la vista. Para obtener información sobre cómo resolver esta falla, consulta Mensaje de error que indica que no existe una vista.

  3. Para ejecutar la consulta, ve a la barra de herramientas y selecciona Ejecutar consulta.

    Estadísticas de observabilidad presenta los resultados de la consulta en una tabla. Sin embargo, puedes crear un gráfico y también guardar la tabla o el gráfico en un panel personalizado. Para obtener más información, consulta Grafica consulta en SQL SQL.

    Si la barra de herramientas muestra Ejecutar en BigQuery, debes cambiar Estadísticas de observabilidad para que use el motor de consultas predeterminado. Para realizar este cambio, en la barra de herramientas del panel Consulta, haz clic en Configuración y, luego, selecciona Analytics (predeterminado).

Compila, edita y ejecuta una consulta

La interfaz del Compilador de consultas te permite compilar una consulta haciendo selecciones de los menús. Estadísticas de observabilidad convierte tus selecciones en una consulta en SQL, que puedes ver y editar. Por ejemplo, puedes comenzar usando la interfaz del Compilador de consultas y, luego, cambiar al editor de SQL para refinar tu consulta.

Estadísticas de observabilidad siempre puede convertir las selecciones de menú de la interfaz del Compilador de consultas en una consulta en SQL. Sin embargo, no todas las consultas en SQL pueden representarse con la interfaz del Compilador de consultas. Por ejemplo, las consultas con uniones no pueden representarse con esta interfaz.