Guarda y comparte consultas

En este documento, se describe cómo guardar y compartir las consultas que creas en Análisis de observabilidad. Si no estás familiarizado con Análisis de observabilidad, consulta Cómo consultar y analizar seguimientos.

Para obtener información sobre cómo graficar tus consultas o cómo consultar tus datos de seguimiento en BigQuery, consulta los documentos que se enumeran en la sección ¿Qué sigue? de este documento.

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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

  8. Para obtener los permisos que necesitas para cargar la página Análisis de observabilidad , escribir, ejecutar y guardar consultas privadas en 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 puede acceder a todas las vistas de observabilidad.
    • Usuario de Análisis 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.
    • Visor de registros (roles/logging.viewer) 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 a través de roles personalizados o cualquier otro rol predefinido.

Guarda una consulta

Todas las consultas que ejecutas se guardan automáticamente durante 30 días y se puede acceder a ellas seleccionando la pestaña Recientes en la página Análisis de observabilidad. Puedes buscar, ver, ejecutar y compartir las consultas que aparecen en la pestaña Recientes.

Si deseas mantener una consulta disponible para usarla en el futuro, anótala con información que te sea útil o permite que los miembros del equipo vean y ejecuten tu consulta, luego guárdala. Puedes buscar y ordenar tus consultas guardadas por su nombre, su descripción y su etiqueta de visibilidad. También puedes editar y borrar estas consultas. Las consultas que guardas se conservan hasta que las borras.

Puedes guardar 10,000 consultas por Google Cloud proyecto.

Console

Para guardar una consulta, haz lo siguiente:

  1. En la Google Cloud consola de, 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. Propaga el panel Consulta con una consulta.

    Puedes propagar el panel Consulta ingresando una consulta nueva, seleccionando una consulta de la pestaña Recientes o seleccionando una consulta de la pestaña Guardados.

    Tu consulta puede incluir cualquier vista válida, varias vistas y vistas de análisis.

    Cuando la consulta en el panel Consulta es válida, se habilita la opción Guardar.

  3. Haz clic en Guardar, selecciona Guardar consulta, y completa los campos Nombre y Descripción. Los valores que establezcas para estos campos se muestran en la pestaña Guardados.

  4. Opcional: Para permitir que todos los usuarios con acceso a la página Análisis de observabilidad del Google Cloud proyecto vean y ejecuten tu consulta guardada, habilita el botón de activación Compartir con el proyecto.

    De forma predeterminada, este botón de activación está inhabilitado y la visibilidad está restringida a ti.

  5. Haz clic en Guardar consulta.

  6. Opcional: Para ver, ordenar y ejecutar consultas guardadas que sean visibles para ti, selecciona la pestaña Guardados.

    Puedes ordenar y filtrar tus consultas guardadas por su nombre, descripción y etiqueta de visibilidad. También puedes filtrar por el contenido de la consulta.

Puedes editar y borrar las consultas que creaste con las opciones de la pestaña Guardados:

  • Para editar una consulta, haz clic en Más opciones y selecciona Editar. Puedes modificar los valores de los campos Nombre y Descripción; sin embargo, la consulta en sí no se puede modificar.

  • Para borrar una consulta guardada, haz clic en Más opciones y selecciona Borrar.

REST

Puedes guardar una consulta con la API de Cloud Logging. Para guardar una consulta, usa el savedQueries.create método.

Para ejecutar este método, haz lo siguiente:

  1. Selecciona savedQueries.create.
  2. En la página de referencia, usa el Explorador de APIs para emitir un comando. Debes especificar el campo opsAnalyticsQuery.

En el siguiente ejemplo, se muestra un cuerpo de solicitud de muestra, que contiene una instancia de SavedQuery:

{
   "parent": "projects/my-project/locations/global"
   "saved_query":
   {
      "ops_analytics_query":
      {
         "sql_query_text" :
            "SELECT
            timestamp, log_name, severity, json_payload, resource, labels
            FROM
            `VIEW`
            WHERE
            timestamp > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 HOUR)
            ORDER BY timestamp ASC
            LIMIT 100"
      }
   "visibility": "PRIVATE"
   }
}

Comparte una consulta

Puedes compartir una consulta guardada con todos los usuarios que tengan acceso a tu Google Cloud proyecto. Sin embargo, los roles de IAM de la principal determinan si se puede ejecutar la consulta y los datos que devuelve.

Console

Cuando solucionas un problema o ves resultados anómalos, es posible que desees compartir una consulta y sus resultados con un compañero de equipo. Cuando ves los resultados de la consulta en la página Análisis de observabilidad, puedes copiar una URL que, cuando se abre, muestra la consulta que ejecutaste y sus resultados.

Para compartir una consulta y los resultados con un compañero de equipo, haz lo siguiente:

  1. En la Google Cloud consola de, 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. Propaga el panel Consulta con una consulta y, luego, haz clic en Ejecutar consulta.

    Puedes propagar el panel Consulta ingresando una consulta nueva, seleccionando una consulta de la pestaña Recientes o seleccionando una consulta de la pestaña Guardados.

  3. Haz clic en Compartir vínculo.

  4. Envía el vínculo a tu compañero de equipo.

    Cuando tu compañero de equipo abre el vínculo, se abre la página Análisis de observabilidad y se muestra la consulta, pero no se ejecuta. Tu compañero de equipo debe ejecutar la consulta de forma manual.

    La página Análisis de observabilidad muestra un diálogo de advertencia cuando la consulta se ejecuta en el motor de BigQuery y los recursos consultados no están 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 consulta.

    Para abrir la URL correctamente, el rol de IAM de tu compañero de equipo en el Google Cloud proyecto debe incluir los permisos necesarios para ver la página Análisis de observabilidad.

REST

Puedes usar la API de Logging para crear una consulta compartida con el método savedQueries.Create y especificar un valor de SHARED en el campo visibility. Para obtener más información, consulta la página de referencia de savedQueries.create.

Consulta y ejecuta consultas recientes o guardadas

Para ver o volver a ejecutar una consulta, selecciona la pestaña Recientes en la página Análisis de observabilidad y busca la consulta:

  • Para ejecutar la consulta, haz clic en Ejecutar.
  • Para ver la consulta, usa las opciones del menú Más opciones.

Para ver, editar o ejecutar una consulta guardada, selecciona la pestaña Guardados en la página Análisis de observabilidad y busca la consulta:

  • Para ejecutar la consulta, haz clic en Ejecutar.
  • Para editar, ver o borrar la consulta, usa las opciones del menú Más opciones.

¿Qué sigue?