documentos añadidos

docs/DEPLOYMENT.md

@@ -0,0 +1,110 @@
+# Configuración de Despliegue Automático
+
+Este documento explica cómo configurar el despliegue automático desde Gitea a Coolify.
+
+## Pasos de Configuración
+
+### 1. En Gitea
+
+1. Ve a tu repositorio en Gitea
+2. Habilita Gitea Actions si no está habilitado
+3. Configura los siguientes secrets en Settings → Secrets:
+   - `COOLIFY_TOKEN`: Token de API de Coolify
+   - `COOLIFY_WEBHOOK_URL`: URL del webhook de Coolify
+   - `COOLIFY_DEPLOYMENT_UUID`: UUID del deployment en Coolify
+
+### 2. En Coolify
+
+1. **Crear nuevo proyecto:**
+   - Nombre: `suite-logs`
+   - Tipo: Docker Compose
+   - Repositorio: URL de tu repositorio en Gitea
+
+2. **Configurar Source:**
+   - Branch: `master` (o `main`)
+   - Auto Deploy: Habilitado
+   - Dockerfile/Compose path: `docker-compose.yml`
+
+3. **Variables de entorno:**
+   ```env
+   COMPOSE_PROJECT_NAME=suite-logs
+   ```
+
+4. **Configurar dominios/puertos:**
+   - Grafana: puerto 3500
+   - Prometheus: puerto 9090
+   - Loki: puerto 3100
+   - Tempo: puerto 3200
+   - Alloy: puerto 12345
+
+5. **Obtener webhook URL:**
+   - Ve a la configuración del proyecto
+   - Copia la URL del webhook
+   - Úsala como `COOLIFY_WEBHOOK_URL` en Gitea
+
+### 3. Configuración de Red
+
+Asegúrate de que Coolify tenga acceso a:
+- Puerto 3500 (Grafana)
+- Puerto 9090 (Prometheus)
+- Puerto 3100 (Loki)
+- Puerto 3200 (Tempo)
+- Puerto 12345 (Alloy)
+
+### 4. Monitoreo de Despliegues
+
+El pipeline de Gitea Actions:
+- Se ejecuta automáticamente en push a master/main
+- Envía webhook a Coolify para iniciar despliegue
+- Reporta estado del despliegue
+
+## Troubleshooting
+
+### Pipeline falla
+1. Verifica que los secrets estén configurados correctamente
+2. Revisa logs en Gitea Actions
+3. Verifica conectividad entre Gitea y Coolify
+
+### Despliegue falla en Coolify
+1. Revisa logs en Coolify dashboard
+2. Verifica que docker-compose.yml sea válido
+3. Asegúrate de que los volúmenes tengan permisos correctos
+
+### Servicios no se conectan
+1. Verifica configuración de red en docker-compose.yml
+2. Revisa logs de cada servicio
+3. Verifica que los archivos de configuración existan
+
+## Comandos Útiles
+
+```bash
+# Verificar estado local
+docker-compose ps
+
+# Ver logs de todos los servicios
+docker-compose logs -f
+
+# Reiniciar servicios específicos
+docker-compose restart grafana
+
+# Limpiar y reiniciar todo
+docker-compose down && docker-compose up -d
+```
+
+## URLs de Acceso Post-Despliegue
+
+Una vez desplegado en Coolify:
+- **Grafana**: https://tu-dominio.com/grafana (o puerto configurado)
+- **Prometheus**: https://tu-dominio.com/prometheus
+- **Loki**: https://tu-dominio.com/loki
+- **Tempo**: https://tu-dominio.com/tempo
+- **Alloy**: https://tu-dominio.com/alloy
+
+## Secrets Necesarios en Gitea
+
+```yaml
+# En Settings → Secrets de tu repositorio
+COOLIFY_TOKEN: "tu_token_de_coolify_api"
+COOLIFY_WEBHOOK_URL: "https://coolify.tudominio.com/webhooks/deploy/uuid"
+COOLIFY_DEPLOYMENT_UUID: "uuid-de-tu-deployment"
+```

docs/README-DASHBOARDS.md

@@ -0,0 +1,34 @@
+# 📊 Dashboards Automáticos
+
+## Uso Simple
+
+```bash
+docker-compose up
+```
+
+¡Y listo! Los dashboards se cargan automáticamente.
+
+## Dashboards Incluidos
+
+Todos en la carpeta **"Observability Stack"** en Grafana:
+
+- **Alloy Monitoring Dashboard** - Monitoreo del agente Alloy
+- **Prometheus Monitoring Dashboard** - Métricas de Prometheus
+- **Grafana Monitoring Dashboard** - Estado de Grafana
+- **Loki Monitoring Dashboard** - Logs y rendimiento de Loki
+- **Tempo Monitoring Dashboard** - Trazas y rendimiento de Tempo
+- **Observability Stack Overview** - Vista general del stack completo
+
+## Agregar Más Dashboards
+
+1. Agrega tus archivos `.json` en: `config/grafana/provisioning/dashboards/`
+2. Reinicia Grafana: `docker-compose restart grafana`
+3. ¡Listo!
+
+## Acceso
+
+- URL: http://localhost:3500
+- Usuario: Ver `GRAFANA_ADMIN_USER` en `.env`
+- Contraseña: Ver `GRAFANA_ADMIN_PASSWORD` en `.env`
+
+Los dashboards se actualizan automáticamente cada 10 segundos si modificas los archivos JSON.