Crea, consulta y administra vistas de análisis

Vista previa

Este producto o función está sujeto a las "Condiciones de la oferta 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 “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.

Las vistas de análisis en Estadísticas de observabilidad te permiten definir una consulta en SQL con un esquema personalizado en tus datos de Cloud Logging para que puedas simplificar y reutilizar transformaciones complejas. Después de crear una vista de análisis, puedes consultar sus resultados en la cláusula FROM de otras consultas en SQL, tal como consultas las vistas de registros.

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

Antes de comenzar

1. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

2. 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 en tu proyecto:

   • Usuario de Estadísticas de observabilidad (roles/observability.analyticsUser)
   • Descriptor de acceso de vista de registros (roles/logging.viewAccessor)

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

3. Asegúrate de tener un bucket de registros actualizado para usar Estadísticas de observabilidad. Para obtener información sobre este paso, consulta Configura buckets de registros.

Crea una vista de análisis

Nota: Una vista de análisis puede consultar vistas de registro. Si una vista de análisis 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 análisis que consulte las vistas de registros en esos dos buckets de registros.

Para crear una vista de análisis, haz lo siguiente:

1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

   Ir a Estadísticas de observabilidad

   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:
   1. Asegúrate de que en la barra de herramientas se muestre Ejecutar consulta. Si en la barra de herramientas se muestra Ejecutar en BigQuery, 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 quieres guardar como una vista de análisis.

   Es posible que desees cargar y editar la consulta predeterminada para la vista de registro 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 Registros del segmento, busca y, luego, selecciona la vista de registro que deseas consultar.

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

      El panel Consulta se actualiza con una consulta en SQL.

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

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 enumera en el panel Vistas, en la sección Vistas de análisis de data_table.

Consulta una vista de análisis

Puedes consultar una vista de análisis de manera similar a como consultas las vistas de registro. Para consultar las 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 estadísticas, que está limitado a 100 caracteres y solo puede incluir letras, dígitos, guiones bajos y guiones.

Para obtener más información, consulta Descripción general de consultas y análisis de registros.

Enumera vistas de análisis

Para enumerar las vistas de análisis en tu proyecto de Google Cloud , haz lo siguiente:

1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

   Ir a Estadísticas de observabilidad

   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:
   1. Asegúrate de que en la barra de herramientas se muestre Ejecutar consulta. Si en la barra de herramientas se muestra Ejecutar en BigQuery, 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 Analytics.

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 de tu proyecto y, luego, haz lo siguiente:

1. Selecciona la vista de análisis cuya información deseas ver.
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 estadísticas, haz lo siguiente:

1. En la Google Cloud consola, ve a la página Estadísticas de observabilidad:

   Ir a Estadísticas de observabilidad

   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:
   1. Asegúrate de que en la barra de herramientas se muestre Ejecutar consulta. Si en la barra de herramientas se muestra Ejecutar en BigQuery, 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 Vistas de Analytics de data_table y selecciona la vista de Analytics 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 Reemplazar 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, ve a la página Estadísticas de observabilidad:

   Ir a Estadísticas de observabilidad

   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:
   1. Asegúrate de que en la barra de herramientas se muestre Ejecutar consulta. Si en la barra de herramientas se muestra Ejecutar en BigQuery, 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 Vistas de Analytics de data_table y selecciona la vista de Analytics que quieres 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 registro.
• El recurso superior de una vista de análisis debe ser un proyecto de Google Cloud .
• Solo puedes consultar una vista de análisis con la página Estadísticas de observabilidad y solo cuando usas el motor de consultas de 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 consola de Google Cloud para crear o administrar tus vistas de análisis.
• Puedes crear un máximo de 100 vistas de análisis por proyecto de Google Cloud .
• Puedes crear un máximo de 50 vistas de análisis por región.
• Por Google Cloud proyecto, un máximo de 10 regiones pueden contener una vista de análisis.

¿Qué sigue?

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