Crea, consulta y administra vistas de análisis

Versión preliminar

Este producto o función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos 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 y administrar vistas de Analytics. Después de crear una vista de Analytics, puedes consultarla de manera similar a como consultas las vistas de registros y las vistas de observabilidad.

Para obtener una descripción general de las vistas de Analytics, consulta Acerca de las vistas de Analytics.

Antes de comenzar

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

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Habilita la API de Observability.

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

Habilitar la API

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Habilita la API de Observability.

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

Habilitar la API

1. Para obtener los permisos que necesitas para crear, administrar y usar vistas de Analytics, 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. Las vistas de observabilidad están disponibles en versión preliminar pública.
   • Usuario de Observability Analytics (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.
   • Descriptor de acceso de vista de registros (roles/logging.viewAccessor) en el proyecto que almacena las vistas de registros que deseas consultar. Puedes restringir el otorgamiento de este rol a una vista específica agregando una condición de IAM.

   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.

2. Asegúrate de tener al menos uno de los siguientes elementos:
   • Es un bucket de registros que se actualizó para usar el Análisis de registros. Para obtener más información, consulta Configura buckets de registros.
   • Es una vista de observabilidad. Para obtener más información, consulta el modelo de almacenamiento de Cloud Trace.

Crea una vista de Analytics

Nota: Una vista de Analytics puede consultar vistas de registros y vistas de observabilidad. Cuando una vista de Analytics consulta varias vistas, estas deben estar en la misma 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 dos 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. Configura la página Análisis de registros de la siguiente manera:
   1. 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 Análisis de registros (predeterminado).
   2. Si no se muestra el menú Vistas, ve al panel de navegación y haz clic en Vistas y esquema.

3. Ingresa y valida la consulta que deseas guardar como una vista de análisis.

   Es posible que desees cargar y editar la consulta predeterminada para la vista de registros o la vista de observabilidad que consultará tu vista de Analytics. Para cargar la consulta predeterminada, haz lo siguiente:

   1. En el menú Vistas, realiza una de las siguientes acciones:

      • Ve a la sección segment Registros y selecciona una vista de registros.
      • Ve a la sección Registros y selecciona _Trace.Spans._AllSpans.

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

      El panel Consulta se actualiza con una consulta en SQL.

   3. Actualiza la consulta hasta que estés conforme con los resultados.

4. Sigue estos pasos para crear una vista de Analytics:

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

   2. Ingresa un nombre y una descripción para la vista de Analytics.

      El nombre se limita a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones. No puedes cambiar el nombre después de crear la vista de Analytics.

   3. Haz clic en Guardar.

   El sistema crea tu vista de Analytics y la muestra en el panel Vistas, en la sección Vistas de Analytics de data_table.

Cómo consultar una vista de Analytics

Puedes consultar una vista de Analytics de manera análoga a la consulta de vistas de registros y vistas de observabilidad. Para consultar vistas de Analytics, usa el siguiente formato para la cláusula FROM:

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

Los campos de las expresiones anteriores tienen el siguiente significado:

• PROJECT_ID: Es el identificador del proyecto.
• LOCATION: Es la ubicación de la vista de Analytics.
• 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 obtener más información, consulta Análisis de registros.

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. Configura la página Análisis de registros de la siguiente manera:
   1. 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 Análisis de registros (predeterminado).
   2. Si no se muestra el menú Vistas, ve al panel de navegación y haz clic en Vistas y esquema.

3. En el menú Vistas, ve a la sección Vistas de Analytics data_table.

Obtén detalles sobre una vista de Analytics

Puedes usar las opciones del panel Esquema para mostrar la siguiente información sobre una vista de Analytics:

• Nombre.
• Fecha de creación
• Última actualización.
• Esquema.
• Consulta.

Para ver los detalles de una vista de Analytics, enumera las vistas de Analytics de tu proyecto y, luego, haz lo siguiente:

1. Selecciona la vista de estadísticas cuya información deseas consultar.
2. En la barra de herramientas Esquema, haz clic en Ver opciones de vista de análisis y selecciona Ver detalles.

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. Configura la página Análisis de registros de la siguiente manera:
   1. 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 Análisis de registros (predeterminado).
   2. Si no se muestra el menú Vistas, ve al panel de navegación y haz clic en Vistas y esquema.

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

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

5. Después de completar 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. Configura la página Análisis de registros de la siguiente manera:
   1. 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 Análisis de registros (predeterminado).
   2. Si no se muestra el menú Vistas, ve al panel de navegación y haz clic en Vistas y esquema.

3. En el menú Vistas, ve a la sección Vistas de Analytics data_table y selecciona la vista de Analytics que deseas borrar.
4. 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 solo puede consultar vistas de registros y vistas de observabilidad.
• El recurso principal de una vista de Analytics debe ser un proyecto de Google Cloud .
• Solo puedes consultar una vista de Analytics con la página Análisis de registros y solo cuando usas el motor de consultas Análisis de registros (predeterminado).
• Todas las vistas que consulta una vista de Analytics deben estar en la misma ubicación.
• Debes usar la consola de Google Cloud para crear o administrar tus vistas de Analytics.
• Puedes crear como máximo 100 vistas de Analytics por proyecto de Google Cloud .
• Puedes crear un máximo de 50 vistas de Analytics por región.
• Por Google Cloud proyecto, como máximo 10 regiones pueden contener una vista de Analytics.

¿Qué sigue?

• Consulta y analiza datos de telemetría con el Análisis de registros.
• Resultados de la consulta en SQL del gráfico
• Guarda y comparte consultas.
• Consultas en SQL de muestra