Monitoring Setup

PATAS Monitoring Setup

Complete guide for setting up monitoring with Grafana and Prometheus.

Quick Start

Option 1: Docker Compose (Recommended)

1. Start monitoring stack:

docker-compose -f docker-compose.monitoring.yml up -d

2. Wait for services to start (30-60 seconds)

3. Access Grafana:

   • URL: http://localhost:3000
   • Username: admin
   • Password: admin

4. Dashboard is automatically provisioned from grafana/provisioning/dashboards/patas-dashboard.json

Option 2: Manual Setup

1. Install and start Grafana and Prometheus

2. Run setup script:

./scripts/setup_monitoring.sh

The script will:

• Create Prometheus datasource in Grafana
• Import PATAS dashboard (if found)
• Configure monitoring

Dashboard Provisioning

Grafana automatically provisions:

• Datasource: Prometheus (configured in grafana/provisioning/datasources/prometheus.yml)
• Dashboard: PATAS Dashboard (from grafana/provisioning/dashboards/patas-dashboard.json)

Dashboard is automatically imported when Grafana starts with docker-compose.

Manual Dashboard Import

If you need to import dashboard manually:

1. Access Grafana UI: http://localhost:3000
2. Go to Dashboards → Import
3. Upload grafana/provisioning/dashboards/patas-dashboard.json

Or use the setup script:

./scripts/setup_monitoring.sh grafana/provisioning/dashboards/patas-dashboard.json

Configuration

Environment Variables

• GRAFANA_URL - Grafana URL (default: http://localhost:3000)
• GRAFANA_USER - Grafana username (default: admin)
• GRAFANA_PASSWORD - Grafana password (default: admin)
• PROMETHEUS_URL - Prometheus URL (default: http://localhost:9090)

Docker Compose

Edit docker-compose.monitoring.yml to customize:

• Ports
• Credentials
• Volume mounts
• Network configuration

Troubleshooting

Dashboard not appearing

1. Check Grafana logs:

docker logs patas-grafana

2. Verify dashboard file exists:

ls -la grafana/provisioning/dashboards/patas-dashboard.json

3. Check provisioning configuration:

cat grafana/provisioning/dashboards/default.yml

Prometheus datasource not found

1. Check datasource provisioning:

cat grafana/provisioning/datasources/prometheus.yml

2. Verify Prometheus is accessible from Grafana container:

docker exec patas-grafana curl -s http://prometheus:9090/api/v1/status/config

Files

• docker-compose.monitoring.yml - Complete monitoring stack
• prometheus.yml - Prometheus configuration
• alerts.yml - AlertManager rules
• scripts/setup_monitoring.sh - Automated setup script
• grafana/provisioning/datasources/prometheus.yml - Datasource provisioning
• grafana/provisioning/dashboards/default.yml - Dashboard provisioning config
• grafana/provisioning/dashboards/patas-dashboard.json - PATAS dashboard

Documentation

• Monitoring Guide - Complete monitoring documentation
• Alerting Guide - Alert rules and configuration