dennisleetw/pandora-monitoring repository overview

⁠pandora-monitoring

⁠Short Description

Pandora Box Monitoring Stack - All-in-one monitoring solution with Prometheus, Loki, Grafana, and AlertManager

⁠Full Description

# Pandora Box Monitoring Stack

A comprehensive, production-ready monitoring and observability stack combining Prometheus (metrics), Loki (logs), Grafana (visualization), and AlertManager (alerting) in a single container. Perfect for centralized monitoring of the Pandora Box Console IDS-IPS ecosystem.

## Components

### Prometheus 2.47.0
- Time-series metrics database
- Service discovery and scraping
- PromQL query language
- Alert rule evaluation

### Loki 2.9.2
- Log aggregation system
- Label-based indexing
- LogQL query language
- Compatible with Prometheus labels

### Grafana 10.2.0
- Metrics and logs visualization
- Pre-configured dashboards for Pandora Box
- Alerting rules visualization
- Multi-datasource support

### AlertManager 0.26.0
- Alert routing and grouping
- Deduplication and inhibition
- Multiple notification channels
- Silence management

## Features

- **All-in-One**: Single container with all monitoring components
- **Supervisor Management**: All services managed by supervisord
- **Nginx Reverse Proxy**: Unified access point for all services
- **Pre-configured**: Ready-to-use dashboards and alert rules
- **Health Monitoring**: Comprehensive health checks for all components
- **Persistent Storage**: Configurable data directories for metrics and logs

## Quick Start

```bash
docker run -d \
  --name pandora-monitoring \
  -p 80:80 \
  -p 3000:3000 \
  -p 9090:9090 \
  -p 3100:3100 \
  -p 9093:9093 \
  -v prometheus_data:/data/prometheus \
  -v loki_data:/data/loki \
  -v grafana_data:/data/grafana \
  -v alertmanager_data:/data/alertmanager \
  your-username/pandora-monitoring:latest

⁠Access Points

• Nginx (Unified Access): http://localhost:80⁠
• Grafana: http://localhost:3000⁠ (default: admin/admin)
• Prometheus: http://localhost:9090⁠
• Loki: http://localhost:3100⁠
• AlertManager: http://localhost:9093⁠

⁠Configuration

Configuration files are included in the image:

• /etc/prometheus/prometheus.yml - Prometheus configuration
• /etc/prometheus/rules/ - Alert rules
• /etc/loki/loki.yaml - Loki configuration
• /etc/grafana/grafana.ini - Grafana configuration
• /etc/grafana/provisioning/ - Datasource and dashboard provisioning
• /etc/alertmanager/alertmanager.yml - AlertManager configuration
• /etc/nginx/nginx.conf - Nginx reverse proxy configuration

⁠Data Persistence

Mount volumes for data persistence:

• /data/prometheus - Prometheus time-series data
• /data/loki - Loki log data
• /data/grafana - Grafana database and dashboards
• /data/alertmanager - AlertManager state

⁠Health Check

The container includes comprehensive health checks:

• Prometheus: http://localhost:9090/-/healthy
• Loki: http://localhost:3100/ready
• Grafana: http://localhost:3000/api/health
• AlertManager: http://localhost:9093/-/healthy

⁠Architecture

• Base Image: Alpine Linux 3.19
• Services: Managed via supervisord
• Reverse Proxy: Nginx for unified access
• Size: ~500MB compressed

⁠Default Credentials

Grafana:

• Username: admin
• Password: admin (change on first login)

Note: Change default credentials in production environments.

⁠Pre-configured Dashboards

The image includes pre-configured dashboards for:

• Pandora Box Console metrics
• Agent performance monitoring
• System resource usage
• Alert overview
• Log analysis

⁠Documentation

• Monitoring Setup Guide⁠
• Grafana Dashboards⁠
• Alert Rules⁠
• Configuration Reference⁠

⁠License

Proprietary - All rights reserved

⁠Support

For issues and questions, please open an issue on GitHub.