BokehTV — Infrastructure & Observability

This repository handles the containerized local development stack and the cross-platform monitoring ecosystem for the BokehTV project.

---

🏗 Docker Compose Ecosystem

BokehTV relies on Docker Compose to orchestrate local development tools.

• postgres — Relational storage for the Express API.
• redis — High-performance cache-aside for TMDB search results.
• prometheus — Scrapes real-time metrics (latency, error rates) from the backend.
• grafana — Visual dashboard with pre-configured observability for "BokehTV Core Metrics".

---

📈 Observability Setup

1. Prometheus Scraping

The backend exposes metrics via express-prom-bundle. These are automatically scraped by the local Prometheus instance defined in prometheus/prometheus.yml.

2. Grafana Dashboards

Grafana is pre-baked with data sources and a "BokehTV Core Dashboard" that visualizes:

• API Latency (95th & 99th percentile)
• 4xx/5xx Error Rates
• Watchlist Operation Volume
• Redis Cache Hit/Miss ratios

3. Usage

docker-compose up -d

• Grafana: Available at http://localhost:3001 (Default: admin/admin).
• Prometheus: Available at http://localhost:9090.

---

🚀 Monitoring (Local vs Prod)

We employ a Hybrid Strategy. Prometheus/Grafana run locally under Docker and can scrape either:

1. Local Backend: Default dev setup.
2. Production Backend: Point Prometheus to your live Railway instance to monitor production traffic from a local dashboard.

---

🛡 License

MIT