monitoring/README.md

@@ -0,0 +1,111 @@
+# Monitoring Stack Configuration
+# gnmic -> Prometheus -> Grafana Network Weathermap
+#
+# This directory contains all configurations for monitoring
+# the EVPN-VXLAN fabric using gNMI streaming telemetry
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    ContainerLab Fabric                      │
+│  ┌─────────┐ ┌─────────┐                                   │
+│  │ spine1  │ │ spine2  │     gNMI port 6030                │
+│  │ .0.1    │ │ .0.2    │                                   │
+│  └────┬────┘ └────┬────┘                                   │
+│       │           │                                         │
+│  ┌────┴───┬───────┴────┬──────────┐                        │
+│  │        │            │          │                         │
+│  ▼        ▼            ▼          ▼                         │
+│ leaf1-2  leaf3-4    leaf5-6    leaf7-8                     │
+│ (VTEP1)  (VTEP2)    (VTEP3)    (VTEP4)                     │
+└─────────────────────────────────────────────────────────────┘
+       │ gNMI Streaming Telemetry (port 6030)
+       ▼
+┌─────────────────┐      ┌──────────────┐      ┌─────────────┐
+│     gnmic       │─────▶│  Prometheus  │─────▶│   Grafana   │
+│  (port 9804)    │      │  (port 9090) │      │ (port 3000) │
+└─────────────────┘      └──────────────┘      └─────────────┘
+```
+
+## Quick Start
+
+1. **Start the monitoring stack:**
+   ```bash
+   cd monitoring
+   docker-compose up -d
+   ```
+
+2. **Access the dashboards:**
+   - Grafana: http://localhost:3000 (admin/admin)
+   - Prometheus: http://localhost:9090
+
+3. **Verify gnmic targets:**
+   ```bash
+   curl -s http://localhost:9804/metrics | grep gnmic_target
+   ```
+
+## Components
+
+| Component   | Port  | Description                           |
+|-------------|-------|---------------------------------------|
+| gnmic       | 9804  | gNMI collector with Prometheus output |
+| Prometheus  | 9090  | Time-series database                  |
+| Grafana     | 3000  | Visualization (weathermap + dashboards) |
+
+## Device Management IPs
+
+| Device  | Management IP  | gNMI Port | Role           |
+|---------|----------------|-----------|----------------|
+| spine1  | 172.16.0.1     | 6030      | Spine (AS65000)|
+| spine2  | 172.16.0.2     | 6030      | Spine (AS65000)|
+| leaf1   | 172.16.0.25    | 6030      | Leaf VTEP1     |
+| leaf2   | 172.16.0.50    | 6030      | Leaf VTEP1     |
+| leaf3   | 172.16.0.27    | 6030      | Leaf VTEP2     |
+| leaf4   | 172.16.0.28    | 6030      | Leaf VTEP2     |
+| leaf5   | 172.16.0.29    | 6030      | Leaf VTEP3     |
+| leaf6   | 172.16.0.30    | 6030      | Leaf VTEP3     |
+| leaf7   | 172.16.0.31    | 6030      | Leaf VTEP4     |
+| leaf8   | 172.16.0.32    | 6030      | Leaf VTEP4     |
+
+## Collected Metrics
+
+### Interface Statistics
+- In/Out octets, packets, errors
+- Interface operational status
+- Interface speed/duplex
+
+### BGP State
+- Neighbor state (Established, Active, etc.)
+- Prefixes received/sent
+- Session uptime
+
+### EVPN/VXLAN
+- VXLAN tunnel status
+- VNI statistics
+- EVPN route counts
+
+## Grafana Weathermap
+
+The weathermap visualization shows:
+- Spine-leaf topology with live bandwidth colors
+- Link utilization percentages
+- BGP session states
+- MLAG peer-link status
+
+## Troubleshooting
+
+**gnmic not connecting:**
+```bash
+# Test gNMI connectivity manually
+gnmic -a 172.16.0.1:6030 -u admin -p admin --insecure capabilities
+```
+
+**No metrics in Prometheus:**
+```bash
+# Check gnmic logs
+docker logs gnmic
+
+# Verify Prometheus targets
+curl http://localhost:9090/api/v1/targets
+```