Crear, consultar y gestionar vistas de analíticas

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En este documento se describe cómo crear, gestionar y consultar vistas de analíticas. Para obtener una descripción general, consulta Acerca de las vistas de analíticas.

Antes de empezar

Nota: No hay roles predefinidos de Gestión de Identidades y Accesos (IAM) de Cloud Logging que contengan los permisos necesarios para crear o consultar una vista de analíticas.

Como las vistas de analíticas consultan vistas de registro, para crear y consultar vistas de analíticas, tus roles de gestión de identidades y accesos también deben permitirte consultar vistas de registro y usar Analíticas de registros. En esta sección se indican los roles de gestión de identidades y accesos necesarios para crear vistas de analíticas, así como los que se requieren para consultar vistas de registro y usar Log Analytics:

• Para obtener los permisos que necesita para crear, gestionar y usar vistas de analíticas, pida a su administrador que le conceda el rol de gestión de identidades y accesos Usuario de Observability Analytics (roles/observability.analyticsUser) en su proyecto.

  Este rol predefinido contiene los permisos necesarios para crear, gestionar y usar vistas de analíticas. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

  Permisos obligatorios

  Para crear, gestionar y usar vistas de analíticas, se necesitan los siguientes permisos:

  • 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 Analíticas de registros, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:

  • Para consultar los segmentos de registros _Required y _Default, sigue estos pasos: Visualizador de registros (roles/logging.viewer)
  • Para consultar todas las vistas de registro de un proyecto, sigue estos pasos: Usuario con permiso para ver registros (roles/logging.viewAccessor)

  Para restringir un principal a una vista de registro específica, puede añadir una condición de IAM a la concesión del rol de acceso a la vista de registros que se haya hecho a nivel de proyecto o añadir un enlace de IAM al archivo de política de la vista de registro. Para obtener más información, consulta Controlar el acceso a una vista de registro.

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

Crear una vista de analíticas

Nota: Una vista de analíticas solo puede consultar vistas de registro. Cuando se consultan varias vistas de registros, los contenedores de registros que las alojan deben estar en una misma ubicación. Por ejemplo, si tiene dos segmentos de registro en la ubicación us-east1, puede crear una vista de Analytics que consulte las vistas de registro de esos segmentos.

Para crear una vista de analíticas, siga estos pasos:

1. En la Google Cloud consola, ve a la página Analíticas de registros:

   Vaya a Analíticas de registros.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

2. En el menú Vistas, vaya a la sección segmento Registros y, a continuación, seleccione la vista de registro que quiera consultar.

   Para encontrar una vista de registro, puede usar la barra Filtrar o desplazarse por la lista de vistas de registro. Cada entrada de la lista tiene el siguiente formato: BUCKET_ID.LOG_VIEW_ID, donde estos campos hacen referencia a los IDs del contenedor de registro y de la vista de registro.

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

   El panel Consulta se actualiza con una consulta de SQL.

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

   Si en la barra de herramientas aparece Ejecutar en BigQuery, haz clic en Configuración y selecciona Analíticas de registros (predeterminado).

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

6. En la barra de herramientas, haga clic en Guardar Guardar y, a continuación, seleccione Guardar como vista de analíticas.

7. Escriba un nombre y una descripción para la vista de analíticas y, a continuación, haga clic en Guardar.

   El nombre tiene un límite de 100 caracteres y solo puede incluir letras, números, guiones bajos y guiones.

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

   La vista de analíticas se crea y se muestra en el panel Vistas, en la sección data_table Vistas de analíticas. Cada entrada de la lista tiene el siguiente formato: LOCATION.ANALYTICS_VIEW_ID, donde estos campos hacen referencia a la ubicación y al ID de una vista de analíticas. Por ejemplo, si ha creado una vista de analíticas con el nombre my-analytic-view que consulta una vista de registro cuyo segmento de registro está en la región global, en esta sección se mostrará global.my-analytic-view.

Consultar una vista de estadísticas

Una vez que se ha creado una vista de analíticas, puedes consultarla de forma similar a como consultarías una vista de registro. Para ver una lista de documentos que describen cómo usar la página Log Analytics, consulta la sección Pasos siguientes de este documento.

Para ejecutar la consulta predeterminada de una vista de analíticas, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Analíticas de registros:

   Vaya a Analíticas de registros.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

2. Introduce una consulta o carga la consulta predeterminada de la vista de analíticas. 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: identificador del proyecto.
   • LOCATION: la ubicación de la vista de analíticas. La ubicación de una vista de Analytics se hereda del recurso al 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: ID de la vista de analíticas, que tiene un límite de 100 caracteres y solo puede incluir letras, números, guiones bajos y guiones.

   Para ejecutar la consulta predeterminada, haz lo siguiente:

   1. En el menú Vistas, vaya a la sección data_table Vistas de Analytics y seleccione la vista de Analytics que quiera consultar.

      Para encontrar una vista de analíticas, puede usar la barra de Filtro o desplazarse por la lista de vistas de analíticas. Cada entrada de la lista tiene el siguiente formato: LOCATION.ANALYTICS_VIEW_ID, donde estos campos hacen referencia a la ubicación y al ID de una vista de analíticas.

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

      El panel Consulta se actualiza con una consulta de SQL que consulta la vista de analíticas que has seleccionado.

3. Haz clic en Realizar una consulta.

   Si en la barra de herramientas aparece Ejecutar en BigQuery, haz clic en Configuración y selecciona Analíticas de registros (predeterminado).

Mostrar vistas de Analytics

Para ver una lista de las vistas de analíticas de tu Google Cloud proyecto, haz lo siguiente:

1. En la Google Cloud consola, ve a la página Analíticas de registros:

   Vaya a Analíticas de registros.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

2. En el menú Vistas, vaya a la sección data_table Vistas de Analytics.

   Se muestra una lista de vistas de analíticas. Cada entrada de la lista tiene el siguiente formato: LOCATION.ANALYTICS_VIEW_ID, donde estos campos hacen referencia a la ubicación y al ID de una vista de Analytics. Por ejemplo, si ha creado una vista de analíticas con el nombre my-analytic-view que consulta una vista de registro cuyo segmento de registro está en la región global, en esta sección se mostrará global.my-analytic-view.

3. Para ver los detalles de una vista de analíticas específica, siga estos pasos:

   1. Seleccione la vista de analíticas.

      El esquema de la vista de analíticas se muestra en la sección Esquema.

   2. En la barra de herramientas Esquema, haga clic en Ver opciones de vista de analíticas y seleccione Ver detalles.

      El cuadro de diálogo muestra información sobre la vista de analíticas, como cuándo se creó, el esquema y la consulta.

Modificar una vista de analíticas

Para modificar una vista de analíticas, siga estos pasos:

1. En la Google Cloud consola, ve a la página Analíticas de registros:

   Vaya a Analíticas de registros.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

2. En el menú Vistas, vaya a la sección data_table Vistas de Analytics y seleccione la vista de Analytics que quiera consultar.

3. En la barra de herramientas Esquema, haga clic en Ver opciones de vista de analíticas y seleccione Editar vista.

   Se abrirá un cuadro de diálogo con información sobre la vista de analíticas. Puedes modificar la descripción y la consulta.

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

Eliminar una vista de Analytics

Nota: Si has escrito consultas en una vista de analíticas y la eliminas, esas consultas no se podrán procesar.

Para eliminar una vista de Analytics, siga estos pasos:

1. En la Google Cloud consola, ve a la página Analíticas de registros:

   Vaya a Analíticas de registros.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

2. En el menú Vistas, vaya a la sección data_table Vistas de Analytics y seleccione la vista de Analytics que quiera consultar.
3. En la barra de herramientas Esquema, haga clic en Ver opciones de vista de analíticas, seleccione Eliminar vista y complete el cuadro de diálogo.

Limitaciones

Se aplican las siguientes limitaciones a las vistas de analíticas:

• Una vista de Analytics no puede consultar otra vista de Analytics.
• Una vista de analíticas puede consultar varias vistas de registro. Sin embargo, los contenedores de registros que alojan las vistas de registros consultadas deben estar en una misma ubicación. Por ejemplo, supongamos que tiene dos cubos de registro, uno en us-east1 y otro en asia-east1. No puedes crear una vista de analíticas que consulte vistas de registro en esos contenedores de registro.
• El recurso principal de una vista de Analytics debe ser un Google Cloud proyecto. No puede crear una vista de analíticas en carpetas ni organizaciones.
• Los conjuntos de datos vinculados no se admiten en las vistas de analíticas. Por lo tanto, solo puede consultar vistas de analíticas mediante la página Analíticas de registros. Además, debes ejecutar esas consultas en el servicio predeterminado de Cloud Logging.
• No hay ninguna API para crear ni gestionar vistas de analíticas.

• Los siguientes límites se aplican a las vistas de analíticas:

  • Número máximo de vistas de analíticas por Google Cloud proyecto: 100
  • Por Google Cloud proyecto, el número máximo de vistas de analíticas por región es 50.
  • Por proyecto de Google Cloud , el número máximo de regiones que pueden almacenar vistas de analíticas es 10.

Siguientes pasos

• Información general sobre consultas y análisis de registros
• Guardar y compartir una consulta de SQL
• Crear gráficos con los resultados de consultas SQL
• Consultas de SQL de ejemplo