Diagnóstico y corrección de problemas con Genie

En la interfaz de usuario de Lakebase, Genie diagnostica y corrige la base de datos. Planteas un problema específico con tus propias palabras, y este lo investiga utilizando la misma telemetría que Insights: el estado de Postgres en tiempo real, los planes de consulta, los eventos de espera y el historial de DDL y de cambios de esquema. Este es el mismo Genie que usas en Lakehouse y Apps; aquí funciona en el proyecto de Lakebase.

Genie funciona como una conversación paso a paso: muestra su razonamiento y le pide que apruebe cada acción, incluidas las consultas que realiza mientras investiga. Cualquier corrección, incluido un cambio de base de datos, necesita la confirmación explícita antes de aplicarla.

Esta página recorre un incidente de producción común (un despliegue que elimina una columna que la aplicación sigue consultando) para mostrar cómo es, de principio a fin, pedir ayuda a Genie.

Prerequisites

• Un proyecto Lakebase en AWS o Azure, con observabilidad configurada. Ver Configurar observabilidad.

El escenario

Un cambio de esquema se ejecuta ALTER TABLE users DROP COLUMN bio como parte de una implementación rutinaria. La aplicación sigue leyendo esa columna en su página de perfil. En cuestión de minutos, las solicitudes de página de perfil comienzan a producir errores con column "bio" does not existy la tasa de errores de la aplicación sube.

Cómo fluye una investigación de Genie

Lo que Genie encuentra y recomienda depende de los datos y del problema subyacente, por lo que trata esto como ilustrativo, no un script que verá textualmente. Abrir Genie desde tu proyecto (detecta automáticamente el contexto de tu proyecto, rama y endpoint) y describe el síntoma. Desde allí, una investigación típica se mueve a través de cuatro fases:

Describes el síntoma

Pregunta en un lenguaje sencillo, como se lo dirías a un compañero: "¿Por qué ha aumentado la tasa de errores?" No necesitas conocer la causa, la consulta que falla ni qué tabla está implicada.

El genio correlaciona y lee la historia

Vincula el error a la consulta que falló y, a continuación, comprueba el historial de DDL para ver qué ha cambiado. El historial de DDL no captura todos los cambios (puede pasarse por alto uno realizado justo cuando se reanuda el cálculo tras una reducción a cero), por lo que, cuando falta un registro, Genie lo indica y recurre a comparar las columnas actuales de la tabla con lo que espera la consulta. En cualquier caso, identifica bio como la columna eliminada. Se trata del mismo historial que lee Insights, por lo que Genie puede retomar el análisis donde lo dejó un análisis en segundo plano.

El genio propone una recuperación, basada en lo que encontró

Normalmente, comienza con una rama en un momento concreto creada justo antes del cambio: un clon instantáneo de copia al escribir que comparte almacenamiento con el entorno de producción, por lo que resulta lo suficientemente económico como para activarlo con cualquier corrección. A partir de ahí, la recuperación se convierte en una conversación: Genie podría volver a copiar los datos que faltan en tu tabla actual o cambiar tu aplicación a la rama restaurada. Algunas rutas necesitan que les proporcione algún dato durante el proceso, como una cadena de conexión que Genie no puede descubrir por sí mismo.

Confirmas antes de que se aplique nada

Genie nunca restaura, modifica o aplica una corrección por sí sola. Informa de las acciones que realiza, pero comprueba las resultantes (un punto de restauración, una rama eliminada) en la interfaz de usuario de Lakebase antes de confiar en ellas.

Limitaciones que se deben tener en cuenta

• Algunos elementos genéricos de la interfaz de usuario de Genie (como personalizaciones, automatizaciones, espacios y agregar contexto) aparecen actualmente en Genie, pero aún no son funcionales.
• Una conversación de Genie continuó desde fuera de la interfaz de usuario de Lakebase (por ejemplo, desde un cuaderno) mantiene el historial de conversaciones, pero pierde las herramientas y el contexto de la página original. Inicie nuevas investigaciones desde el proyecto Lakebase para obtener los resultados más confiables.
• Las ramas y los puntos de conexión se muestran mediante su identificador interno, no por un nombre para mostrar como "producción". Si la respuesta de Genie es ambigua sobre a qué rama o punto de conexión se refiere, compárala con el identificador en la interfaz de usuario de Lakebase. Para más información, consulta las limitaciones de telemetría.

Pasos siguientes

• Encuentra y resuelve problemas con Insights: activa la monitorización proactiva para que problemas como este surjan antes de que tengas que preguntar.
• Referencia de la tabla de telemetría: las tablas que lee Genie y las limitaciones actuales.
• Restaurar un proyecto: Más información sobre la recuperación en un momento concreto fuera de Genie. Consulte Restauración a un momento dado.