Crea, consulta y administra vistas de estadísticas

Vista previa

Este producto o función se encuentra sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas 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.

En este documento, se describe cómo crear, administrar y consultar vistas de Analytics. Para obtener una descripción general conceptual, consulta Acerca de las vistas de Analytics.

Antes de comenzar

Nota: No hay roles predefinidos de Cloud Logging Identity and Access Management (IAM) que contengan los permisos necesarios para crear o consultar una vista de Analytics.

Dado que las vistas de Analytics consultan vistas de registros, para crear y consultar vistas de Analytics, tus roles de IAM también deben permitirte consultar vistas de registros y usar el Análisis de registros. En esta sección, se enumeran los roles de IAM necesarios para crear vistas de análisis y los que se requieren para consultar vistas de registros y usar el Análisis de registros:

• Para obtener los permisos que necesitas para crear, administrar y usar vistas de Analytics, pídele a tu administrador que te otorgue el rol de IAM de Usuario de Observability Analytics (roles/observability.analyticsUser) en tu proyecto.

  Este rol predefinido contiene los permisos necesarios para crear, administrar y usar vistas de Analytics. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

  Permisos necesarios

  Se requieren los siguientes permisos para crear, administrar y usar vistas de Analytics:

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• Para obtener los permisos que necesitas para consultar una vista de registros y usar Log Analytics, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

  • Para consultar los buckets de registros _Required y _Default, usa el Visualizador de registros (roles/logging.viewer).
  • Para consultar todas las vistas de registros de un proyecto, usa el Descriptor de acceso de vista de registros (roles/logging.viewAccessor).

  Puedes restringir un principal a una vista de registros específica agregando una condición de IAM al otorgamiento del rol de Acceso a la vista de registros realizado a nivel del proyecto o agregando una vinculación de IAM al archivo de política de la vista de registros. Para obtener más información, consulta Controla el acceso a una vista 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 registros _Default, consulta Roles de Cloud Logging.

Crea una vista de Analytics

Nota: Una vista de Analytics solo puede consultar vistas de registros. Cuando se consultan varias vistas de registros, los buckets de registros que alojan estas vistas deben estar en una sola ubicación. Por ejemplo, si tienes dos buckets de registros en la ubicación us-east1, puedes crear una vista de Analytics que consulte las vistas de registros en esos buckets.

Para crear una vista de Analytics, sigue estos pasos:

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 menú Views, ve a la sección segment Logs y, luego, selecciona la vista de registro para consultar.

   Para encontrar una vista de registro, puedes usar la barra de filtro o desplazarte por la lista de vistas de registro. Cada entrada de la lista tiene el siguiente formato BUCKET_ID.LOG_VIEW_ID, en el que estos campos hacen referencia a los IDs del bucket de registros y la vista de registros.

3. En la barra de herramientas Schema, haz clic en Query.

   El panel Consulta se actualiza con una consulta en SQL.

4. Asegúrate de que en la barra de herramientas se muestre Ejecutar consulta.

   Si la barra de herramientas muestra Ejecutar en BigQuery, haz clic en Configuración y selecciona Log Analytics (predeterminado).

5. Actualiza la consulta en SQL en el panel Consulta hasta que estés conforme con los resultados.

6. En la barra de herramientas, haz clic en Guardar Guardar y, luego, selecciona Guardar como vista de Analytics.

7. Ingresa un nombre y una descripción para la vista de Analytics y, luego, haz clic en Guardar.

   El nombre se limita a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

   Nota: No puedes cambiar el nombre de una vista de análisis después de crearla. Puedes modificar la descripción y la búsqueda.

   Se creará tu vista de Analytics y aparecerá en el panel Vistas, en la sección titulada data_table Vistas de Analytics. Cada entrada de la lista tiene el siguiente formato: LOCATION.ANALYTICS_VIEW_ID, en el que estos campos hacen referencia a la ubicación y el ID de una vista de Analytics. Por ejemplo, si creaste una vista de Analytics con el nombre my-analytic-view que consulta una vista de registros cuyo bucket de registros se encuentra en la región global, en esta sección se mostrará global.my-analytic-view.

Cómo consultar una vista de análisis

Una vez que existe una vista de Analytics, puedes consultarla de manera similar a como consultas una vista de registros. Para obtener una lista de los documentos que describen cómo usar la página Análisis de registros, consulta la sección Próximos pasos de este documento.

Para ejecutar la consulta predeterminada de una vista de Analytics, 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. Ingresa una búsqueda o carga la búsqueda predeterminada para la vista de Analytics. La cláusula FROM de tu búsqueda debe tener el siguiente formato:

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   En la expresión anterior, los campos tienen el siguiente significado:

   • PROJECT_ID: Es el identificador del proyecto.
   • LOCATION: Es la ubicación de la vista de Analytics. La ubicación de una vista de Analytics se hereda del recurso que consulta. Por ejemplo, si una vista de Analytics consulta una vista de registro que se encuentra en la ubicación global, la ubicación de la vista de Analytics también será global.
   • ANALYTICS_VIEW_ID: Es el ID de la vista de Analytics, que se limita a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

   Para ejecutar la consulta predeterminada, haz lo siguiente:

   1. En el menú Vistas, ve a la sección Vistas de Analytics de data_table y selecciona la vista de Analytics que deseas consultar.

      Para encontrar una vista de Analytics, puedes usar la barra de filtro o desplazarte por la lista de vistas de Analytics. Cada entrada de la lista tiene el siguiente formato: LOCATION.ANALYTICS_VIEW_ID, en el que estos campos hacen referencia a la ubicación y el ID de una vista de Analytics.

   2. En la barra de herramientas Schema, haz clic en Query.

      El panel Query se actualiza con una consulta en SQL que consulta la vista de Analytics que seleccionaste.

3. Haz clic en Ejecutar consulta.

   Si la barra de herramientas muestra Ejecutar en BigQuery, haz clic en Configuración y selecciona Log Analytics (predeterminado).

Enumera las vistas de Analytics

Para enumerar las vistas de Analytics en tu proyecto Google Cloud , 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. En el menú Vistas, ve a la sección data_table Vistas de Analytics.

   Se muestra una lista de vistas de Analytics. Cada entrada de la lista tiene el siguiente formato: LOCATION.ANALYTICS_VIEW_ID, en el que estos campos hacen referencia a la ubicación y el ID de una vista de Analytics. Por ejemplo, si creaste una vista de Analytics con el nombre my-analytic-view que consulta una vista de registros cuyo bucket de registros se encuentra en la región global, en esta sección se mostrará global.my-analytic-view.

3. Para ver los detalles de una vista de Analytics específica, haz lo siguiente:

   1. Selecciona la vista de Analytics.

      El esquema de la vista de Analytics se muestra en la sección Esquema.

   2. En la barra de herramientas Esquema, haz clic en Ver opciones de vista de análisis y selecciona Ver detalles.

      En el diálogo, se muestra información sobre la vista de Analytics, como la fecha de creación, el esquema y la consulta.

Cómo modificar una vista de Analytics

Para modificar una vista de Analytics, 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. En el menú Vistas, ve a la sección Vistas de Analytics de data_table y selecciona la vista de Analytics que deseas consultar.

3. En la barra de herramientas Schema, haz clic en Ver opciones de vista de análisis y selecciona Editar vista.

   Se abrirá un diálogo que muestra información sobre la vista de Analytics. Puedes modificar la descripción y la búsqueda.

4. Después de realizar las modificaciones, haz clic en Sobrescribir vista guardada.

Cómo borrar una vista de Analytics

Nota: Si escribiste consultas en una vista de Analytics y borras la vista de Analytics, esas consultas fallarán.

Para borrar una vista de Analytics, 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. En el menú Vistas, ve a la sección Vistas de Analytics de data_table y selecciona la vista de Analytics que deseas consultar.
3. En la barra de herramientas Esquema, haz clic en Ver opciones de vista de Analytics, selecciona Borrar vista y completa el diálogo.

Limitaciones

Se aplican las siguientes limitaciones a las vistas de Analytics:

• Una vista de Analytics no puede consultar otra vista de Analytics.
• Una vista de Analytics puede consultar varias vistas de registros. Sin embargo, los buckets de registros que alojan las vistas de registros consultadas deben estar en una sola ubicación. Por ejemplo, supongamos que tienes dos buckets de registros, uno en us-east1 y el otro en asia-east1. No puedes crear una vista de Analytics que consulte vistas de registros en esos buckets de registros.
• El recurso principal de una vista de Analytics debe ser un proyecto de Google Cloud . No puedes crear una vista de Analytics en carpetas ni organizaciones.
• Los conjuntos de datos vinculados no son compatibles con las vistas de Analytics. Por lo tanto, solo puedes consultar las vistas de Analytics con la página Análisis de registros. Además, debes ejecutar esas consultas en el servicio predeterminado de Cloud Logging.
• No hay compatibilidad con la API para crear o administrar vistas de Analytics.

• Se aplican los siguientes límites a las vistas de Analytics:

  • Cantidad máxima de vistas de Analytics por proyecto Google Cloud : 100
  • Por Google Cloud proyecto, la cantidad máxima de vistas de Analytics por región es de 50.
  • Por proyecto Google Cloud , la cantidad máxima de regiones que pueden almacenar vistas de Analytics es de 10.

¿Qué sigue?

• Descripción general de las consultas y el análisis de registros
• Cómo guardar y compartir una consulta en SQL
• Cómo generar gráficos con los resultados de las consulta en SQL SQL
• Consultas en SQL de muestra