egutierrez
9966851e75
- Create .gitignore to exclude Python-generated files and virtual environments - Add .python-version for Python version management - Initialize README.md with project description and usage instructions - Implement alloy.river configuration for Grafana Alloy observability - Set up grafana.ini for Grafana configuration - Configure dashboards.yml for automatic dashboard loading in Grafana - Define datasources.yml for connecting Grafana to Prometheus, Loki, and Tempo - Establish loki.yaml configuration for Loki logging - Set up prometheus.yml for Prometheus metrics collection - Configure tempo.yaml for Tempo tracing - Create docker-compose.yml for orchestrating services - Develop init.sh script for initializing project directories and services - Implement main.py as the entry point for the application - Define pyproject.toml for project metadata and dependencies - Update uv.lock for dependency management
Suite de Monitoreo con Grafana, Prometheus y Mimir
Esta configuraci�n incluye un stack completo de monitoreo con:
- Prometheus: Recolecci�n de m�tricas
- Mimir: Almacenamiento de m�tricas a largo plazo
- Grafana: Visualizaci�n y dashboards
Estructura de Archivos
Uso
Iniciar los servicios
docker-compose up -d
Verificar estado
docker-compose ps
Ver logs
# Todos los servicios
docker-compose logs -f
# Servicio espec�fico
docker-compose logs -f grafana
docker-compose logs -f prometheus
docker-compose logs -f mimir
Detener los servicios
docker-compose down
Acceso a los Servicios
-
Grafana: http://localhost:3000
- Usuario:
admin - Contrase�a:
admin
- Usuario:
-
Prometheus: http://localhost:9090
-
Mimir: http://localhost:9009
Configuraci�n
Modificar Configuraciones
Todos los archivos de configuraci�n est�n en la carpeta config/ y pueden editarse directamente:
-
Prometheus (
config/prometheus/prometheus.yml):- Agregar nuevos targets de scraping
- Configurar reglas de alertas
- Modificar intervalos de recolecci�n
-
Mimir (
config/mimir/mimir.yml):- Ajustar l�mites de series
- Configurar almacenamiento
- Modificar configuraci�n de cluster
-
Grafana (
config/grafana/grafana.ini):- Cambiar configuraci�n de seguridad
- Configurar autenticaci�n
- Ajustar configuraci�n de la base de datos
Aplicar Cambios
Despu�s de modificar las configuraciones:
# Reiniciar servicios espec�ficos
docker-compose restart prometheus
docker-compose restart mimir
docker-compose restart grafana
# O reiniciar todo
docker-compose restart
Agregar Fuentes de Datos
Edita config/grafana/provisioning/datasources/datasources.yml para agregar nuevas fuentes de datos autom�ticamente.
Cargar Dashboards
Coloca archivos JSON de dashboards en data/grafana/dashboards/ y se cargar�n autom�ticamente.
Flujo de Datos
- Prometheus recolecta m�tricas de los targets configurados
- Prometheus env�a las m�tricas a Mimir via remote_write
- Grafana consulta tanto Prometheus (datos recientes) como Mimir (datos hist�ricos)
Personalizaci�n
Agregar Node Exporter
Descomenta las l�neas en config/prometheus/prometheus.yml y agrega al docker-compose:
node-exporter:
image: prom/node-exporter:latest
container_name: node-exporter
ports:
- "9100:9100"
networks:
- monitoring
Agregar Alertmanager
Descomenta las l�neas en config/prometheus/prometheus.yml y agrega al docker-compose:
alertmanager:
image: prom/alertmanager:latest
container_name: alertmanager
ports:
- "9093:9093"
networks:
- monitoring
Troubleshooting
Verificar conectividad
# Ping entre contenedores
docker exec prometheus ping mimir
docker exec grafana ping prometheus
Verificar configuraci�n de Prometheus
# Verificar sintaxis de configuraci�n
docker exec prometheus promtool check config /etc/prometheus/prometheus.yml
Verificar configuraci�n de Mimir
# Ver configuraci�n activa
curl http://localhost:9009/config