Crea, consulta y administra vistas de análisis

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” 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 análisis. Después de crear una vista de análisis, puedes consultarla de manera similar a como consultas las vistas de observabilidad.

Para obtener una descripción general de las vistas de análisis, consulta Acerca de las vistas de análisis.

Antes de comenzar

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.

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.

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

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.

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

1. Para obtener los permisos que necesitas para crear, administrar y usar vistas de análisis, 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 en versión preliminar pública.
   • Usuario de Estadísticas 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.

2. Asegúrate de tener una vista de observabilidad. Para obtener más información, consulta Modelo de almacenamiento de Cloud Trace.

Crea una vista de análisis

Nota: Una vista de análisis puede consultar vistas de observabilidad. Cuando una vista de análisis consulta varias vistas, estas deben estar en la misma ubicación.

Para crear una vista de análisis, 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. Configura la página Estadísticas de observabilidad de la siguiente manera:
   1. Asegúrate de que la barra de herramientas muestre Ejecutar consulta. Si la barra de herramientas muestra Ejecutar en BigQuery, entonces haz clic en Configuración y selecciona Estadísticas de observabilidad (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 observabilidad que consultará tu vista de análisis. Para cargar la consulta predeterminada, haz lo siguiente:

   1. En el menú Vistas, ve a la sección Seguimientos y, luego, selecciona _Trace.Spans._AllSpans.

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

      El panel Consulta se actualiza con una consulta en SQL.

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

4. Crea una vista de análisis:

   1. En la barra de herramientas, haz clic en guardar Guardar y, luego, selecciona Guardar como vista de análisis.

   2. Ingresa un nombre y una descripción para la vista de análisis.

      El nombre está limitado 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 análisis.

   3. Haz clic en Guardar.

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

Consulta una vista de análisis

Consultas una vista de análisis de manera análoga a la consulta de vistas de observabilidad. Para consultar vistas de análisis, 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 análisis.
• ANALYTICS_VIEW_ID: Es el ID de la vista de análisis, que está limitado a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

Para obtener más información, consulta Consulta y analiza seguimientos.

Enumera vistas de análisis

Para enumerar las vistas de análisis en tu Google Cloud proyecto, 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. Configura la página Estadísticas de observabilidad de la siguiente manera:
   1. Asegúrate de que la barra de herramientas muestre Ejecutar consulta. Si la barra de herramientas muestra Ejecutar en BigQuery, entonces haz clic en Configuración y selecciona Estadísticas de observabilidad (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 data_table Vistas de análisis.

Obtén detalles sobre una vista de análisis

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

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

Para ver los detalles de una vista de análisis, enumera las vistas de análisis en tu proyecto y, luego, haz lo siguiente:

1. Selecciona la vista de análisis de la que deseas ver la información.
2. En la barra de herramientas Esquema haz clic en Ver opciones de vista de análisis, y selecciona Ver detalles.

Modifica una vista de análisis

Para modificar una vista de análisis, 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. Configura la página Estadísticas de observabilidad de la siguiente manera:
   1. Asegúrate de que la barra de herramientas muestre Ejecutar consulta. Si la barra de herramientas muestra Ejecutar en BigQuery, entonces haz clic en Configuración y selecciona Estadísticas de observabilidad (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 data_table Vistas de análisis sección y selecciona la vista de análisis que deseas modificar.

4. En la barra de herramientas Esquema, 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 análisis. Puedes modificar la descripción y la consulta.

5. Después de completar las modificaciones, haz clic en Anular vista guardada.

Borra una vista de análisis

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

Para borrar una vista de análisis, 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. Configura la página Estadísticas de observabilidad de la siguiente manera:
   1. Asegúrate de que la barra de herramientas muestre Ejecutar consulta. Si la barra de herramientas muestra Ejecutar en BigQuery, entonces haz clic en Configuración y selecciona Estadísticas de observabilidad (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 data_table Vistas de análisis sección, y selecciona la vista de análisis que deseas borrar.
4. En la barra de herramientas Esquema, haz clic en Ver opciones de vista de análisis, selecciona Borrar vista y completa el diálogo.

Limitaciones

Se aplican las siguientes limitaciones a las vistas de análisis:

• Una vista de análisis solo puede consultar vistas de observabilidad.
• El recurso superior de una vista de análisis debe ser un Google Cloud proyecto.
• Solo puedes consultar una vista de análisis con la página Estadísticas de observabilidad y solo cuando usas el motor de consultas Estadísticas de observabilidad (predeterminado).
• Todas las vistas que consulta una vista de análisis deben estar en la misma ubicación.
• Debes usar la Google Cloud consola para crear o administrar tus vistas de análisis.
• Puedes crear como máximo 100 vistas de análisis por Google Cloud proyecto.
• Puedes crear como máximo 50 vistas de análisis por región.
• Por Google Cloud proyecto, como máximo 10 regiones pueden contener una vista de análisis.

¿Qué sigue?

• Consulta y analiza seguimientos.
• Representa los resultados de la consulta en SQL en un gráfico.
• Guarda y comparte consultas.
• Consultas de SQL de muestra.