Crea, consulta y administra vistas de estadísticas

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

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

Antes de comenzar

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

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

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

  Este rol predefinido contiene los permisos necesarios para crear, administrar y usar vistas de estadísticas. 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 estadísticas:

  • 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 registro 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 registro de un proyecto, usa el Descriptor de acceso de vista de registros (roles/logging.viewAccessor).

  Puedes restringir un principal a una vista de registro específica agregando una condición de IAM al otorgamiento 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 registros.

  Si deseas obtener información sobre los roles adicionales que necesitas para consultar vistas en buckets definidos por el usuario o consultar la vista _AllLogs del bucket de registro _Default, consulta Roles de Cloud Logging.

Crea una vista de estadísticas

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

Para crear una vista de estadísticas, 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ú Views, ve a la sección segment Logs y, luego, selecciona la vista de registro que deseas consultar.

   Para encontrar una vista de registro, puedes usar la barra 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 registro y la vista de registro.

3. En la barra de herramientas Esquema, haz clic en Consulta.

   El panel Consulta se actualiza con una consulta de SQL.

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

   Si la barra de herramientas muestra Run in BigQuery, haz clic en Settings y selecciona Log Analytics (default).

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

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

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

   El nombre está limitado a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

   Nota: No puedes cambiar el nombre de una vista de estadísticas después de crearla. Puedes modificar la descripción y la consulta.

   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 estadísticas. Por ejemplo, si creaste una vista de Analytics con el nombre my-analytic-view que consulta una vista de registro cuyo bucket de registro se encuentra en la región global, esta sección mostrará global.my-analytic-view.

Cómo consultar una vista de Analytics

Una vez que existe una vista de estadísticas, puedes consultarla de manera similar a como lo haces con una vista de registro. Para obtener una lista de documentos que describen cómo usar la página Log Analytics, consulta la sección Próximos pasos de este documento.

Para ejecutar la consulta predeterminada de una vista de estadísticas, 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 consulta o carga la consulta predeterminada para la vista de estadísticas. La cláusula FROM de tu consulta 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 estadísticas. La ubicación de una vista de estadísticas se hereda del recurso que consulta. Por ejemplo, si una vista de estadísticas consulta una vista de registro que se encuentra en la ubicación global, la ubicación de la vista de estadísticas también es global.
   • ANALYTICS_VIEW_ID: Es el ID de la vista de estadísticas, 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 data_table Vistas de Analytics y selecciona la vista de Analytics que deseas consultar.

      Para encontrar una vista de estadísticas, puedes usar la barra Filtro o desplazarte por la lista de vistas de estadísticas. 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 estadísticas.

   2. En la barra de herramientas Esquema, haz clic en Consulta.

      El panel Consulta se actualiza con una consulta de SQL que consulta la vista de estadísticas que seleccionaste.

3. Haz clic en Ejecutar consulta.

   Si la barra de herramientas muestra Run in BigQuery, haz clic en Settings y selecciona Log Analytics (default).

Cómo enumerar las vistas de estadísticas

Para enumerar las vistas de estadísticas en tu proyecto de 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ú Views, ve a la sección Analytics Views de data_table.

   Se muestra una lista de vistas de estadísticas. 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 estadísticas. Por ejemplo, si creaste una vista de Analytics con el nombre my-analytic-view que consulta una vista de registro cuyo bucket de registro se encuentra en la región global, esta sección mostrará global.my-analytic-view.

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

   1. Selecciona la vista de estadísticas.

      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.

      El diálogo muestra información sobre la vista de Analytics, como la fecha en que se creó, el esquema y la consulta.

Cómo modificar una vista de estadísticas

Para modificar una vista de estadísticas, 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 y selecciona la vista de Analytics que deseas consultar.

3. En la barra de herramientas Schema, haz clic en View analytics view options y selecciona Edit view.

   Se abrirá un diálogo que muestra información sobre la vista de estadísticas. Puedes modificar la descripción y la consulta.

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

Cómo borrar una vista de estadísticas

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

Para borrar una vista de estadísticas, 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 y selecciona la vista de Analytics que deseas consultar.
3. En la barra de herramientas Esquema, haz clic en Ver opciones de vista de estadísticas, selecciona Borrar vista y completa el diálogo.

Limitaciones

Las siguientes limitaciones se aplican a las vistas de estadísticas:

• Una vista de Analytics no puede consultar otra vista de Analytics.
• Una vista de estadísticas puede consultar varias vistas de registro. Sin embargo, los buckets de registro que alojan las vistas de registro consultadas deben estar en una 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 estadísticas que consulte vistas de registro en esos buckets de registro.
• El recurso superior de una vista de estadísticas debe ser un proyecto de Google Cloud. No puedes crear una vista de estadísticas 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 estadísticas 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 estadísticas.

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

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

¿Qué sigue?

• Descripción general de consultas y análisis de registros
• Guarda y comparte una consulta en SQL
• Grafica los resultados de las consultas de SQL
• Consultas en SQL de muestra