Guarda y comparte consultas de SQL

En este documento, se describe cómo guardar y compartir las consultas que creas en Análisis de registros.

En este documento, se supone que estás familiarizado con el Análisis de registros y cómo usar la página Análisis de registros para consultar tus datos de registro. Si no eres Si estás familiarizado con estos temas, ve a Consulta y analiza registros.

Para aprender a graficar los resultados de tu consulta y cómo guardar esos gráficos a un panel personalizado, consulta Gráficos de consulta en SQL SQL.

Antes de comenzar

Antes de usar Log Analytics, haz lo siguiente:

  • Para obtener los permisos que necesitas para usar el Análisis de registros, solicita a tu administrador que te otorgue el los siguientes roles de IAM en tu proyecto:

    Puedes restringir un principal a una vista de registro específica agregando una condición de IAM a la concesión de rol de acceso a la vista de registros que se realiza a nivel del proyecto o agregando una vinculación de IAM al archivo de política de la vista de registro. Para obtener más información, consulta Controla el acceso a una vista de registro.

    Estos son los mismos permisos que necesitas para ver las entradas de registro en la página Explorador de registros. Para obtener información sobre los roles adicionales que necesitas para consultar vistas en buckets definidos por el usuario o para consultar la vista _AllLogs del bucket de registro _Default, consulta Roles de Cloud Logging.

  • Asegúrate de que tus buckets de registros se hayan actualizado para usar el Análisis de registros:

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

      Ir al Almacenamiento de registros

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

    2. Para cada bucket de registros que tenga una vista de registros que deseas consultar, asegúrate de que la columna Log Analytics disponible muestre Abierto. Si aparece Upgrade, haz clic en Upgrade y completa el diálogo.

Guarda una consulta

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

Si quieres mantener una consulta disponible para usarla en el futuro, hazle anotaciones con información que te resulte útil o permite que tus compañeros de equipo la vean y la ejecuten, y, luego, guárdala. Puedes buscar y ordenar tus consultas guardadas por su del nombre, la descripción y la etiqueta de visibilidad. También puedes editar y borrar estas consultas. Las consultas que guardes se conservarán hasta que las borres. de ellos.

Puedes guardar 10,000 consultas por proyecto de Google Cloud.

Console

Para guardar una consulta, 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. Propaga el panel Consulta con una consulta.

    Para propagar el panel Consulta, ingresa una consulta nueva, selecciona una de la pestaña Recientes o selecciona una de la pestaña Guardadas.

    Cuando la consulta en el panel Consulta es válida, el Guardar está habilitado.

  3. Haz clic en Guardar y completa los campos Nombre y Descripción. Los valores que establezcas para estos campos se mostrarán en la pestaña Guardado.

  4. Opcional: Permitir que todos los usuarios con acceso al Análisis de registros para la vista de proyectos de Google Cloud y ejecutar 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 se restringe a ti.

  5. Haz clic en Guardar consulta.

  6. Opcional: Para ver, ordenar y ejecutar consultas guardadas que puedes ver, selecciona la pestaña Guardados.

    Puedes ordenar y filtrar tus búsquedas guardadas por 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 Guardadas:

  • Para editar una consulta, haz clic en Más opciones y selecciona Editar. Puedes modificar los valores del Campos Name y Description Sin embargo, la consulta en sí no puede modificados.

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

API

Para guardar una consulta con la API de Logging, usa el método savedQueries.create. Para obtener más información sobre este método, consulta parámetros y datos de respuesta, consulta la página de referencia para savedQueries.create

Puedes ejecutar el método savedQueries.create con el widget del Explorador de APIs en la página de referencia del método. Para Para las consultas del Análisis de registros, debes especificar el campo opsAnalyticsQuery. En el siguiente ejemplo, se ilustra 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
           `TABLE_NAME_OF_LOG_VIEW`
           WHERE
           timestamp > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 HOUR)
           ORDER BY timestamp ASC
           LIMIT 100"
     }
     "visibility": "PRIVATE"
  }
}

Compartir una consulta

Console

Al solucionar un problema o cuando veas resultados anómalos, es posible que compartir una consulta y sus resultados con un compañero de equipo. Cuando estás viendo los resultados de la consulta en la página Análisis de registros, 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 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. Propaga el panel Consulta con una consulta y, luego, haz clic en Ejecutar consulta.

    Puedes propagar el panel Consulta si ingresas una consulta nueva. Para ello, selecciona una consulta de la pestaña Recientes o selecciona selecciona una consulta de la pestaña Guardado.

  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 abra el vínculo, se abrirá la página Log Analytics. En esta página, se muestran la consulta que ejecutaste y los resultados.

    Para abrir la URL correctamente, el rol de Identity and Access Management de tu compañero de equipo en el proyecto de Google Cloud debe incluir los permisos necesarios para ver las páginas de Logging.

API

Puedes usar la API de Logging para crear una búsqueda 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.

Cómo ver y ejecutar consultas recientes o guardadas

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

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

Para ver, editar o ejecutar una consulta guardada, selecciona la pestaña Guardadas en la página Log Analytics 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?