Configuración de la observabilidad

Una configuración de observabilidad captura la telemetría detallada de Lakebase Postgres como tablas Delta en 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 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 Unity Catalog con la identidad que selecciones 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 solo puede hacerlo un administrador del espacio de trabajo, y primero debe aprovisionarse (paso 1 a continuación).
• 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. Se limita a tus permisos, así que omite el paso de aprovisionamiento del principal de servicio y comienza en Abrir el asistente de configuración.

Aprovisionar la entidad de servicio

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

Otorga al principal de servicio los cuatro permisos indicados a continuación antes de crear la configuración, para que esté listo para seleccionarlo en el asistente. Son independientes y cada uno se concede en un lugar diferente. Si falta alguno, la configuración se guarda igualmente, pero la telemetría simplemente nunca llega y no se genera ninguna información útil, sin ningún error que indique la causa. Si una configuración no produce telemetría, comprueba primero estos.

Conceda acceso al área de trabajo y PUEDE USAR en Configuración > Identidad y acceso > Entidades de 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>`;

Abre el asistente de configuración

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

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

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 (en Autorizar a Lakebase para escribir tus datos) es la cuenta con la que Lakebase escribe la telemetría, según la opción que elegiste en Elige una identidad. Selecciona Usar una entidad de servicio y elige la entidad de servicio que has aprovisionado, o selecciona Usar credenciales de usuario para ejecutarlo como 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 fase beta, la telemetría no comienza a transmitirse en una instancia que ya se está ejecutando hasta que esta se reinicia.

Pasos siguientes

• Encuentra y resuelve problemas con Insights: activa la monitorización proactiva y aprende a leer lo que encuentra.
• Diagnostica y soluciona problemas con Genie: investiga un problema de forma conversacional y recorre una recuperación de principio a fin.