Configuración de la observabilidad

Importante

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administrar versiones preliminares de Azure Databricks.

Una configuración de observabilidad captura la telemetría profunda de Lakebase Postgres como tablas Delta en el Unity Catalog. Insights, Genie y los paneles de control funcionan todos con estos datos; un proyecto no tiene ninguno de ellos hasta que se adjunta una configuración.

Una configuración es un solo objeto que puede cubrir uno o varios proyectos. Hay dos formas de asociarle una identidad, y coexisten por diseño:

  • Un administrador de espacio de trabajo establece una configuración de principal de servicio como predeterminada del espacio, de modo que cada nuevo proyecto obtiene observabilidad automáticamente.
  • Un propietario individual del proyecto configura su propio proyecto con credenciales de identidad de usuario.

Un espacio de trabajo suele acabar con una mezcla: la mayoría de los proyectos en el estándar compartido, algunos con sus propias configuraciones. Esta página cubre toda la configuración para cualquiera de los dos caminos. Para configurar un único proyecto que poseas, consulta el inicio rápido.

Prerequisites

  • Se ha habilitado la versión preliminar de Lakebase Advanced Postgres Telemetry para su área de trabajo. Un administrador del área de trabajo lo activa desde la página Vistas previas.
  • Un proyecto de escalado automático de Lakebase en AWS o Azure. Consulte Obtención de una base de datos de Postgres.
  • Un catálogo y un esquema de Unity Catalog para recibir datos de telemetría. El esquema ya debe existir y el catálogo no puede usar almacenamiento predeterminado.

Configurar la configuración

Elige una identidad. La configuración escribe la telemetría en el Catálogo de Unity como una identidad que seleccionas en el asistente. Esa elección determina hasta dónde llega la configuración y cuánto dura:

  • Elige un principal de servicio para una configuración duradera que no esté vinculada a la cuenta de ninguna persona. Esto es el ajuste adecuado para estandarizar la observabilidad: configúralo como el espacio de trabajo por defecto y asignarlo a proyectos existentes. Seleccionar un principal de servicio es solo administrador de espacio de trabajo, y primero lo provisionas (paso 1 más abajo).
  • Elige credenciales a nivel de usuario para configurar un proyecto bajo tu propio acceso, sin nada que aprovisionar. Esto se adapta a un proyecto individual que poseas. Está ajustado a tus permisos, así que salta el paso de aprovisionamiento del principal de servicio y empieza en Abrir el asistente de configuración.

Proporcionar el principal de servicio

Si usas credenciales a nivel de usuario, salta a abrir el asistente de configuración.

Concede al principal de servicio los cuatro permisos que aparecen antes de crear la configuración, para que esté listo para seleccionar en el asistente. Son independientes y cada uno se concede en un lugar diferente. Si falta alguna, la configuración sigue guardando, pero la telemetría nunca llega silenciosamente y no se genera ningún conocimiento, sin error que te indique la causa. Si una configuración no produce telemetría, comprueba primero estos.

Grant Dónde configurarlo Por qué es necesario
Acceso al área de trabajo La pestaña de Configuraciones del director, en Derechos Permite que el principal de servicio actúe en el espacio de trabajo en absoluto. Sin ella, Lakebase escribe la telemetría como una identidad que no puede hacer nada, así que todas las tablas de telemetría quedan vacías.
Administrador del área de trabajo Escenarios > Grupos de identidad y acceso>: abre el grupo de administradores y añade el principal Actualmente, el agente en segundo plano requiere acceso de administrador para escribir telemetría y generar información.
PUEDE USAR La pestaña de Permisos del director Te permite seleccionar el director en el mago. Crear un principal de servicio otorga PUEDE GESTIONAR, que no incluye PUEDE USAR, así que lo concedes explícitamente. Consulte Roles para administrar entidades de servicio.
Privilegios del catálogo de Unity El catálogo de destino y el esquema (ver el SQL más abajo) Permite que el principal cree y escriba las tablas de telemetría: USE CATALOG en el catálogo USE SCHEMA y CREATE TABLE en el esquema.

Concede acceso al espacio de trabajo y PUEDE USAR en los principales de Identidad y acceso > de Configuración > del servicio. Concede privilegios al Catálogo de Unity en el Explorador de Catálogos o con SQL:

GRANT USE CATALOG ON CATALOG <catalog> TO `<service-principal-id>`;
GRANT USE SCHEMA ON SCHEMA <catalog>.<schema> TO `<service-principal-id>`;
GRANT CREATE TABLE ON SCHEMA <catalog>.<schema> TO `<service-principal-id>`;

Note

Exigir la administración del espacio de trabajo es una restricción actual de la Beta y puede reducirse en una versión posterior. Concédelo de momento para que la telemetría y los datos analíticos funcionen.

Abre el asistente de configuración

Abre el mago desde cualquiera de los dos sitios. Ambos abren el mismo mago:

  • Desde Lakebase>Insights>Administrar configuraciones>, agregue una nueva configuración.
  • Desde la propia Configuración> de un proyectoconfiguración de observabilidad>Crear nueva configuración

Completa los tres pasos de mago que siguen en orden, haciendo clic en Siguiente entre ellos.

Configurar

Asigne un nombre a la configuración y seleccione dónde se almacena su telemetría. Hay dos opciones aquí en las que vale la pena detenerse:

  • Si esto es una configuración predeterminada para nuevos proyectos , este será el espacio de trabajo por defecto: cada nuevo proyecto creado en el espacio de trabajo se asigna automáticamente a esta configuración, sin que su creador actúe. Activa esto para estandarizar la observabilidad en todo el espacio de trabajo. Un espacio de trabajo tiene como máximo un valor por defecto, y el valor predeterminado solo se aplica a proyectos creados después, así que también lo asignas a proyectos existentes en el paso Asignar a proyectos . Déjalo fuera si quieres que esta configuración se aplique a proyectos específicos en lugar de a todo el espacio de trabajo.
  • Identidad (bajo Autorizar Lakebase para escribir tus datos) es la cuenta que Lakebase escribe telemetría, siguiendo la elección que hiciste en Elige una identidad. Selecciona Usar principal de servicio y elige el principal que has aprovisionado, o selecciona Usar credenciales a nivel de usuario para ejecutarlo tú mismo. Solo los administradores del área de trabajo pueden seleccionar una entidad de servicio.

En Enviar telemetría a Unity Catalog, elija el Catálogo y el Esquema en los que se almacenarán las tablas y, opcionalmente, un prefijo para las tablas. Estás eligiendo un destino, no diseñando uno: Lakebase crea las tablas listadas en Qué se captura la primera vez que escribe telemetría. El esquema ya debe existir y el catálogo no puede usar almacenamiento predeterminado. Como Use default storage (Usar almacenamiento predeterminado ) está seleccionado de forma predeterminada al crear un catálogo en el Explorador de catálogos, asegúrese de borrarlo para el catálogo que use aquí.

Habilitación de conclusiones

Asegúrese de que Enable insights (Habilitar conclusiones ) está activado. Es lo que ejecuta el agente de Insights en segundo plano. Sin ella, una configuración envía telemetría a Unity Catalog, pero no muestra nada de forma proactiva. Aparecen dos campos relacionados:

  • Las instrucciones son texto libre que el agente lee antes de cada paso de análisis, por ejemplo, "No generar información sobre el tamaño de la tabla". Tratarlo como guía, no un filtro garantizado: como cualquier instrucción dada a un LLM, normalmente se sigue, no se aplica estrictamente.
  • La frecuencia de análisis controla con qué frecuencia Insights evalúa tu telemetría (por ejemplo, cada hora). Esto es independiente de la rapidez con la que la telemetría bruta llega a Unity Catalog, algo que ocurre continuamente en cualquier caso.

Insights guarda sus resultados en una ubicación del espacio de trabajo, distinta del destino de Unity Catalog indicado anteriormente: la telemetría sin procesar se almacena en tablas Delta, pero los propios resultados son archivos en su propio espacio de trabajo de Azure Databricks.

Asignar a proyectos

Selecciona los proyectos Lakebase existentes a los que se aplica esta configuración y luego guarda. Establecerlo como el espacio de trabajo por defecto en el paso anterior cubre los proyectos creados a partir de ahora; Asignarlo aquí pone tus proyectos existentes bajo la misma configuración.

Después de guardar:

  • Confirma que el cálculo está en marcha.
  • Si ha habilitado la observabilidad en una instancia que ya se estaba ejecutando, reinicie la instancia para que el cambio surta efecto. Durante la versión beta, la telemetría no comienza a fluir en una instancia ya en ejecución hasta que se reinicia.

Pasos siguientes

  • Last updated on