Informes
Informes
El sistema de Reports de Workspace genera informes automaticos sobre el estado del proyecto, la infraestructura y la actividad del equipo. Los informes combinan datos reales con analisis de inteligencia artificial para ofrecer una vision contextualizada y accionable.
Que son los informes
Un informe es un documento generado periodicamente que resume:
- Estado de la infraestructura (servidores, servicios, uptime)
- Actividad del equipo (commits, tareas completadas, despliegues)
- Metricas del proyecto (endpoints, tests, cobertura)
- Incidencias y alertas del periodo
Cada informe incluye datos crudos y un analisis generado por IA que interpreta los datos, detecta tendencias y sugiere acciones.
Acceder a los informes
- Ve a Reports en el menu lateral
- Veras la lista de informes generados, ordenados por fecha
- Haz clic en cualquier informe para ver su contenido completo
Estructura de un informe
Cada informe tiene estas secciones:
Resumen ejecutivo
Parrafo breve con las conclusiones principales. Ideal para una lectura rapida de 30 segundos.
Estado de infraestructura
- Uptime de servidores en el periodo
- Incidencias detectadas y su duracion
- Uso de recursos (CPU, memoria, disco)
- Estado de los contenedores Docker
Actividad del equipo
- Commits realizados por cada miembro del equipo
- Tareas creadas y completadas
- Pull requests mergeados
- Despliegues a produccion
Metricas del proyecto
- Numero de endpoints API
- Estado de la suite de tests
- Version actual desplegada
- Cambios significativos en el codebase
Analisis IA
La inteligencia artificial analiza los datos del informe y proporciona:
- Interpretacion: Que significan los numeros en contexto
- Tendencias: Si las cosas van mejor o peor que en periodos anteriores
- Sugerencias: Acciones recomendadas basadas en los datos
Generacion automatica
Los informes se generan automaticamente mediante cron jobs (tareas programadas):
| Tipo | Frecuencia | Contenido |
|---|---|---|
| Diario | Cada dia a las 7:00 | Resumen de las ultimas 24 horas |
| Semanal | Cada lunes a las 8:00 | Resumen de la semana anterior |
| Mensual | Primer dia del mes | Resumen del mes anterior |
Los scripts de generacion recopilan datos de todas las fuentes (GitHub, servidores, Workspace) y los envian al modelo de IA para el analisis.
Analisis con Gemini
El analisis de IA utiliza Google Gemini para interpretar los datos:
Tono del analisis
Puedes configurar el tono del analisis segun tu preferencia:
| Tono | Estilo | Uso |
|---|---|---|
| Profesional | Formal, objetivo, orientado a datos | Informes para compartir externamente |
| Casual | Directo, coloquial, con opiniones | Informes internos del equipo |
El toggle de tono se configura en los ajustes del informe. Cambia como la IA redacta el analisis pero no afecta a los datos subyacentes.
Que analiza la IA
- Compara metricas actuales con periodos anteriores
- Identifica anomalias (picos de errores, caidas de uptime)
- Correlaciona eventos (ej. “tras el despliegue del jueves, los errores 500 aumentaron un 15%”)
- Sugiere acciones priorizadas
Almacenamiento
Los informes se almacenan en la base de datos D1 de Cloudflare:
- Cada informe es un registro con metadatos (fecha, tipo, periodo) y contenido (HTML/Markdown)
- Los informes se conservan indefinidamente
- Puedes buscar informes anteriores por fecha o tipo
Crear un informe manual
Ademas de la generacion automatica, puedes crear un informe bajo demanda:
- Ve a Reports
- Pulsa Generar informe
- Selecciona el periodo y tipo de informe
- El sistema recopila los datos y genera el analisis
- El informe estara disponible en unos segundos
Compartir informes
Los informes estan disponibles para todos los miembros del equipo con acceso al Workspace. Al ser documentos HTML, puedes:
- Leerlos directamente en el navegador
- Copiar secciones para enviar por email
- Referenciarlos en notas o tareas del Workspace
Buenas practicas
- Revisar el informe diario cada manana como parte de tu rutina
- Usar el analisis IA como punto de partida, no como conclusion final — la IA da contexto pero tu conoces los detalles
- Crear informes manuales antes de reuniones importantes para tener datos frescos
- Comparar informes semanales para detectar tendencias que no se ven dia a dia
- Actuar sobre las sugerencias de la IA — si no las vas a usar, ajusta los parametros para que sean mas relevantes
Véase también
- [[workspace—dashboard]] — dashboard
- [[workspace—que-es-workspace]] — qué es Workspace
- [[crearack-tech—architecture—auto-reports-plan]] — plan de auto-reports
- [[workspace-tech—tecnico—ai-workflow]] — AI workflow
- [[workspace—noticias-alertas]] — noticias y alertas