Add Prometheus/Grafana observability for DynamoDB and Raft and normal…

README.md

@@ -30,6 +30,31 @@ Deployment/runbook documents:
 
 - `docs/docker_multinode_manual_run.md` (manual `docker run`, 4-5 node cluster on multiple VMs, no docker compose)
 
+## Metrics and Grafana
+
+Elastickv now exposes Prometheus metrics on `--metricsAddress` (default: `localhost:9090` in `main.go`, `:9090` in `cmd/server/demo.go`).
+
+The exported metrics cover:
+
+- DynamoDB-compatible API request rate, success/error split, latency, request/response size, and per-table read/write item counts
+- Raft local state, leader identity, current members, commit/applied index, and leader contact lag
+
+Provisioned monitoring assets live under:
+
+- `monitoring/prometheus/prometheus.yml`
+- `monitoring/grafana/dashboards/elastickv-cluster-overview.json`
+- `monitoring/grafana/provisioning/`
+- `monitoring/docker-compose.yml`
+
+To scrape a multi-node deployment, bind `--metricsAddress` to each node's private IP, for example `--metricsAddress "10.0.0.11:9090"`.
+
+For the local 3-node demo, start Grafana and Prometheus with:
+
+```bash
+cd monitoring
+docker compose up -d
+```
+
 
 ## Example Usage
 
@@ -41,6 +66,16 @@ To start the server, use the following command:
 go run cmd/server/demo.go
 ```
 
+To expose metrics on a dedicated port:
+```bash
+go run . \
+  --address "127.0.0.1:50051" \
+  --redisAddress "127.0.0.1:6379" \
+  --dynamoAddress "127.0.0.1:8000" \
+  --metricsAddress "127.0.0.1:9090" \
+  --raftId "n1"
+```
+
 ### Starting the Client
 
 To start the client, use this command: