feat: add comprehensive observability stack with metrics, logging, and monitoring

## Major Features Added:
- 🔍 Prometheus metrics collection for all API endpoints
- 📊 Grafana dashboards with weather service monitoring
- 📝 Structured logging with correlation IDs and JSON format
- 🚨 AlertManager with pre-configured alert rules
- 📈 Loki log aggregation and analysis
- 🏥 Health check endpoints (/health, /health/ready, /health/live)
- 🐳 Complete Docker Compose observability stack

## New Components:
- weather_mcp/observability.py - Core observability infrastructure
- weather_mcp/health.py - Health check endpoints
- monitoring/ - Complete monitoring configuration
- docker-compose.observability.yml - Full stack deployment
- scripts/start-observability.sh - Easy startup script
- OBSERVABILITY.md - Comprehensive documentation

## Enhanced Services:
- Added @track_api_request decorators to all service methods
- Structured logging with correlation IDs
- Prometheus metrics for API performance, cache hit rates, SSE connections
- Error tracking and external API monitoring

## New Make Commands:
- make start-observability - Start full monitoring stack
- make docker-dev-run - Renamed from run-docker-dev
- make observability-up/down/logs/restart
- make health-check, metrics-check, observability-status

## Access Points:
- Weather MCP: http://localhost:8000
- Grafana: http://localhost:3000 (admin/admin)
- Prometheus: http://localhost:9091
- AlertManager: http://localhost:9093

This provides production-ready observability for the Weather MCP server.

Author: T-rav

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help install install-dev test test-unit test-integration coverage lint format format-check type-check clean dev-setup pre-commit run run-test docker-build docker-run run-docker-dev docker-logs docker-stop
+.PHONY: help install install-dev test test-unit test-integration coverage lint format format-check type-check clean dev-setup pre-commit run run-test docker-build docker-run docker-dev-run docker-logs docker-stop
 
 # Default target
 help:
@@ -19,7 +19,7 @@ help:
 	@echo "  run           Run weather API server"
 	@echo "  docker-build  Build Docker image"
 	@echo "  docker-run    Start Docker container with docker-compose"
-	@echo "  run-docker-dev Start Docker container in development mode"
+	@echo "  docker-dev-run Start Docker container in development mode"
 	@echo "  docker-logs   View Docker container logs"
 	@echo "  docker-stop   Stop Docker containers"
 
@@ -91,11 +91,54 @@ docker-build:
 docker-run:
 	docker-compose up -d clima-mcp
 
-run-docker-dev:
+docker-dev-run:
 	docker-compose --profile dev up clima-mcp-dev
 
 docker-logs:
 	docker-compose logs -f clima-mcp
 
 docker-stop:
 	docker-compose down
+
+# =============================================================================
+# OBSERVABILITY
+# =============================================================================
+
+start-observability:
+	@echo "🔍 Starting full observability stack..."
+	./scripts/start-observability.sh
+
+observability-up:
+	docker-compose -f docker-compose.observability.yml up -d
+
+observability-down:
+	docker-compose -f docker-compose.observability.yml down
+
+observability-logs:
+	docker-compose -f docker-compose.observability.yml logs -f
+
+observability-restart:
+	docker-compose -f docker-compose.observability.yml restart
+
+grafana-open:
+	@echo "Opening Grafana dashboard..."
+	@open http://localhost:3000 || echo "Visit http://localhost:3000 (admin/admin)"
+
+prometheus-open:
+	@echo "Opening Prometheus..."
+	@open http://localhost:9091 || echo "Visit http://localhost:9091"
+
+health-check:
+	@echo "🏥 Checking service health..."
+	@curl -s http://localhost:8000/health | jq . || echo "Service not responding"
+
+metrics-check:
+	@echo "📊 Checking metrics..."
+	@curl -s http://localhost:8000/metrics | head -20
+
+observability-status:
+	@echo "📊 Observability Stack Status:"
+	@echo "Weather MCP: $$(curl -s -o /dev/null -w "%%{http_code}" http://localhost:8000/health || echo "DOWN")"
+	@echo "Prometheus: $$(curl -s -o /dev/null -w "%%{http_code}" http://localhost:9091/-/healthy || echo "DOWN")"
+	@echo "Grafana: $$(curl -s -o /dev/null -w "%%{http_code}" http://localhost:3000/api/health || echo "DOWN")"
+	@echo "Loki: $$(curl -s -o /dev/null -w "%%{http_code}" http://localhost:3100/ready || echo "DOWN")"