Fix: Agrega logs para las operaciones en la base de datos #4

A8080816 · 2026-02-24T18:35:30Z

A8080816 commented

2026-02-24 18:35:30 +00:00

PR para #2

Resumen

Este PR refuerza la estabilidad y observabilidad del agente: endurece validaciones, amplía el manejo de errores y actualiza todo el stack de logging sin interrumpir la ejecución del servicio.

Cambios principales

✨ Nuevo logger centralizado con soporte para log_structured_entry en formato JSON.
🛡️ Validaciones adicionales para la conexión a la base de datos y manejo robusto de excepciones en puntos críticos.
📝 Refactor de importaciones y adición de logs de arranque para depurar flujos con mayor precisión.
💾 Persistencia de errores sin cerrar la app, permitiendo investigar fallos post‑ejecución.
✅ Ajustes finales para que ruff y ty pasen al 100 %.

Características destacadas

Logging estructurado listo para integrarse con el stack de observabilidad actual.
Evita cierres inesperados: las excepciones se capturan, se registran y se conservan para análisis.
Validaciones “fail fast” al abrir conexiones, con mensajes accionables.
Instrumentación adicional que deja trazabilidad completa del ciclo de vida del agente.
Estilo y tipado alineados con las herramientas (uv run ruff check, uv run ty check).

> PR para #2 ## Resumen Este PR refuerza la estabilidad y observabilidad del agente: endurece validaciones, amplía el manejo de errores y actualiza todo el stack de logging sin interrumpir la ejecución del servicio. ### Cambios principales ✨ Nuevo logger centralizado con soporte para `log_structured_entry` en formato JSON. 🛡️ Validaciones adicionales para la conexión a la base de datos y manejo robusto de excepciones en puntos críticos. 📝 Refactor de importaciones y adición de logs de arranque para depurar flujos con mayor precisión. 💾 Persistencia de errores sin cerrar la app, permitiendo investigar fallos post‑ejecución. ✅ Ajustes finales para que `ruff` y `ty` pasen al 100 %. ### Características destacadas - Logging estructurado listo para integrarse con el stack de observabilidad actual. - Evita cierres inesperados: las excepciones se capturan, se registran y se conservan para análisis. - Validaciones “fail fast” al abrir conexiones, con mensajes accionables. - Instrumentación adicional que deja trazabilidad completa del ciclo de vida del agente. - Estilo y tipado alineados con las herramientas (`uv run ruff check`, `uv run ty check`).

A8080816 added 7 commits 2026-02-24 18:35:31 +00:00

feat: add 'log_structured_entry' for JSON structured logs 3b7dd91a71

Move config into own file

feat: use a new logger 6feeeff4f3

fix: refactor correct import and add more logs 753b5c7871

fix: add more validations for bd connection 13c8e122de

feat: do not exit app and save errors a8c611fbec

fix: add robust handling for exceptions 0fd97a31a5

fix: pass all checks for ruff and ty a3ba340224

A8080816 requested review from A8065384 2026-02-24 18:35:31 +00:00

A8080816 added this to the Vaia v1.0 project 2026-02-24 18:35:31 +00:00

A8080816 changed title from ~~Fix: Agrega logs par alas operaciones en la Base de Datos~~ to Fix: Agrega logs para las operaciones en la base de datos

2026-02-24 19:42:38 +00:00

A8065384 requested changes 2026-02-24 21:56:39 +00:00

utils/logging_setup.py Outdated

						
				@@ -0,0 +14,4 @@

				def _setup_logger() -> logging.Logger:

				    """Create or return the singleton evaluation logger."""

				    log_name = "va_agent-evaluation-logs"

A8065384 commented

2026-02-24 21:53:26 +00:00

Convertir en parametro dentro de Settings

Convertir en parametro dentro de `Settings`

A8080816 marked this conversation as resolved

utils/logging_setup.py

						
				@@ -0,0 +16,4 @@

				    """Create or return the singleton evaluation logger."""

				    log_name = "va_agent-evaluation-logs"

				    logger = logging.getLogger(log_name)

				    cfg = Settings.model_validate({})

A8065384 commented

2026-02-24 21:56:29 +00:00

Se instancia Settings dos veces, podemos centralizarlo en config

Se instancia `Settings` dos veces, podemos centralizarlo en `config`

A8080816 marked this conversation as resolved

utils/logging_setup.py

						
				@@ -0,0 +24,4 @@

				        client = google.cloud.logging.Client(project=cfg.project_id)

				        handler = CloudLoggingHandler(client, name=log_name)  # async transport

				        logger.addHandler(handler)

				        logger.setLevel(logging.INFO)