docs(readme): add observability launch instructions

Document --profile observe, Grafana/Prometheus URLs, and fix README
layout (description at top, consolidated local runtime section).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: ManuelLerchner

README.md

@@ -1,8 +1,8 @@
 # DevOps Project 2026
 
-Repository for team Panic! At the Console
+Lightweight incident management system — detect, track, and resolve incidents with an immutable event log and AI-assisted analysis.
 
-> TUM DevOps Project — Spring 2026
+> TUM DevOps Project — Spring 2026 · Team Panic! At the Console
 
 ## Quick Start
 
@@ -15,13 +15,6 @@ pixi run pre-commit-install
 pixi run lint
 ```
 
-Run local service scaffold with Docker Compose:
-
-```bash
-cp .env.example .env
-docker compose up --build
-```
-
 Equivalent Pixi tasks:
 
 ```bash
@@ -30,8 +23,6 @@ pixi run compose-down
 pixi run compose-validate
 ```
 
-Lightweight incident management system — detect, track, and resolve incidents with an immutable event log and AI-assisted analysis.
-
 ## Installation
 
 Prerequisites:
@@ -78,7 +69,8 @@ pixi run pre-commit-install
 ├── infra/
 │   ├── helm/
 │   ├── k8s/
-│   └── monitoring/
+│   ├── monitoring/             # Prometheus + Grafana config
+│   └── postgres/               # Dev DB init scripts
 ├── docs/
 │   ├── adr/
 │   ├── architecture/
@@ -121,9 +113,32 @@ pixi run lint
 
 ## Local Runtime
 
-- Local compose file: `docker-compose.yml`
-- Production-oriented compose with Traefik + TLS: `docker-compose.prod.yml`
-- Images default to GHCR tag `main` and can be overridden with `IMAGE_TAG`.
+```bash
+cp .env.example .env
+docker compose up --build
+```
+
+Starts all services plus shared infrastructure (Postgres, NATS). Service env vars (`DATABASE_URL`, `NATS_URL`) are pre-wired.
+
+### Observability
+
+```bash
+docker compose --profile observe up --build
+```
+
+Adds Prometheus and Grafana to the stack:
+
+| Service    | URL                   | Credentials          |
+| ---------- | --------------------- | -------------------- |
+| Grafana    | http://localhost:3001 | admin / admin        |
+| Prometheus | http://localhost:9090 | —                    |
+
+Grafana auto-provisions Prometheus as its default datasource — no manual setup needed. Once your services expose `/metrics`, they appear in Prometheus and can be graphed in Grafana immediately.
+
+### Other options
+
+- Production compose with Traefik + TLS: `docker-compose.prod.yml`
+- Override the image tag: `IMAGE_TAG=v0.1.0 docker compose up`
 
 ## Student Responsibilities