Real-time monitoring and visualization of Ixia/Keysight IxOS chassis port utilization with parallel polling, time-series storage, and interactive dashboards.
Monitor multiple IxOS chassis simultaneously with real-time visibility into:
- Port Ownership - Track which user/session owns each port
- Link Status - Monitor port connectivity (up/down)
- Transmit State - Track traffic state (active/idle)
- Resource Utilization - View total, owned, and free ports
Key Benefits:
- ⚡ Parallel polling - Monitor 10+ chassis in ~2 seconds
- 📊 Time-series visualization - Historical analysis with Grafana
- 🐳 One-command deployment - Docker Compose for quick setup
- 🔄 Synchronized timestamps - Aligned data across all chassis
┌─────────────────────────────────────────────────────────────────────┐
│ IxOS CHASSIS FLEET │
│ [Chassis 1] ─── [Chassis 2] ─── ... ─── [Chassis N] │
│ :8443 :8443 :8443 │
└──────────────────────────────┬──────────────────────────────────────┘
│ REST API (Parallel Polling)
│
┌──────────────────────────────▼──────────────────────────────────────┐
│ HOST MACHINE │
│ ┌────────────────────────────────────────────────────────────┐ │
│ │ IxOS Poller (Python) │ │
│ │ • portInfoPoller.py → Port metrics (InfluxDB) │ │
│ │ • perfMetricsPoller.py → Performance metrics (Prometheus)│ │
│ │ • Parallel polling with ThreadPoolExecutor │ │
│ └────────────────────┬───────────────────┬────────────────────┘ │
└───────────────────────┼───────────────────┼─────────────────────────┘
│ │
HTTP :8086 │ │ HTTP :9001
│ │
┌───────────────────────▼───────────────────▼─────────────────────────┐
│ DOCKER COMPOSE STACK │
│ │
│ ┌──────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │
│ │ InfluxDB │ │ Prometheus │ │ Grafana │ │
│ │ :8086 │ │ :9090 │ │ :3000 │ │
│ │ │ │ │ │ │ │
│ │ • Port metrics │ │ • Perf metrics │ │ • Dashboards │ │
│ │ • Time-series DB │ │ • System health │ │ • Visualization │ │
│ │ • Infinite store │ │ • 15d retention │ │ • Multi-source │ │
│ └──────────────────┘ └──────────────────┘ └─────────────────┘ │
│ │
│ 📦 Persistent Volumes: influxdb-data, prometheus-data, grafana-data │
└─────────────────────────────────────────────────────────────────────┘
Data Flow:
- Python poller queries all chassis in parallel (2-3s for 10+ chassis)
- Port metrics → InfluxDB | Performance metrics → Prometheus
- Grafana visualizes both data sources with synchronized timestamps
- ⚡ Parallel Polling - ThreadPoolExecutor for simultaneous chassis queries
- 🔄 Synchronized Timestamps - Aligned data across all chassis
- 📊 Dual Storage - InfluxDB (port data) + Prometheus (system metrics)
- 🎨 Interactive Dashboards - State Timeline, Time Series, Gauges
- 🐳 Docker Compose - One-command infrastructure deployment
- 🛡️ Health Monitoring - Automatic service health checks
- 💾 Persistent Storage - Data survives container restarts
- 🔧 Configurable - Environment-based configuration
- Docker 20.10+ & Docker Compose 2.0+
- Python 3.7+ with pip
- Network access to IxOS chassis (REST API enabled)
- 2GB free disk space
git clone https://github.com/yourusername/IxPortUtilizationPlotter.git
cd IxPortUtilizationPlotter
cp env.example .env.env file (TO start Docker services):
INFLUXDB_PORT=8086
PROMETHEUS_PORT=9090
GRAFANA_PORT=3000
# InfluxDB Configuration
INFLUXDB_ADMIN_USER=admin
INFLUXDB_ADMIN_PASSWORD=admin
INFLUXDB_ORG=keysight
INFLUXDB_BUCKET=ixosChassisStatistics
INFLUXDB_TOKEN='eegHpR9kkgxg5KG7rklj2zQI86-5z7yNETx0P0qQpSnw1owDxSL5IF-uQruOP-J8M_xmrhT3KWECh-QGbsdyYA=='
INFLUXDB_RETENTION=0 # 0 = infinite retention, or specify in seconds
# Grafana Configuration
GRAFANA_ADMIN_USER=admin
GRAFANA_ADMIN_PASSWORD=admin
INFLUXDB_TOKEN=<your-super-secret-token-change-me># Start Docker infrastructure (InfluxDB, Prometheus, Grafana)
docker compose up -d# Polling interval in seconds - This is for my influxDB to select metrics push intevals
POLLING_INTERVAL=120
# Polling interval in seconds - This is for my prometheus to select metrics push intevals
POLLING_INTERVAL_PERF_METRICS=110
CHASSIS_LIST = [
{"ip": "10.36.75.205", "username": "admin", "password": "admin"},
]
# Install Python dependencies
pip install -r requirements.txt
# Start pollers on host
chmod +x run_pollers.sh stop_pollers.sh
./run_pollers.sh| Service | URL | Credentials |
|---|---|---|
| Grafana | http://localhost:3000 | admin / admin |
| InfluxDB | http://localhost:8086 | admin / keysight12345 |
| Prometheus | http://localhost:9090 | No auth |
# View logs
docker compose logs -f # All services
docker compose logs -f influxdb # Specific service
tail -f portInfoPoller.log # Poller logs
# Control services
docker compose stop # Stop all
docker compose restart # Restart all
./stop_pollers.sh # Stop pollers
# Health checks
docker compose ps # Service status
curl http://localhost:8086/health # InfluxDB health
curl http://localhost:9090/-/healthy # Prometheus health| Document | Description |
|---|---|
| SOLUTION_DEPLOYMENT.md | Complete deployment guide with troubleshooting |
| ENVIRONMENT_VARIABLES.md | All environment variables reference |
| config.py | Chassis list and poller configuration |
| prometheus.yml | Prometheus scrape configuration |
| Issue | Solution |
|---|---|
| No data in Grafana | Verify INFLUXDB_TOKEN matches in .env and config.py |
| Connection timeout | Check chassis is reachable: ping <chassis_ip> |
| Port already in use | Customize ports in .env: INFLUXDB_PORT=8087 |
| Poller not starting | Check logs: tail -f portInfoPoller.log |
| Stale data in timeline | Add elapsed() filter to Flux query (see Common Queries) |
Detailed troubleshooting: See SOLUTION_DEPLOYMENT.md
Measurement: portUtilization
| Type | Name | Description | Example |
|---|---|---|---|
| Tags | chassis |
Chassis IP | 10.36.75.205 |
card |
Card number | 1 |
|
port |
Port number | 5 |
|
| Fields | owner |
Port owner | Free or user/session |
linkState |
Link status | linkUp, linkDown |
|
transmitState |
Traffic state | active, idle |
|
totalPorts |
Total ports | 48 |
|
ownedPorts |
Owned ports | 12 |
|
freePorts |
Available ports | 36 |
Parallel vs Sequential Polling:
| Chassis Count | Sequential | Parallel | Improvement |
|---|---|---|---|
| 1 chassis | 2s | 2s | 0% |
| 5 chassis | 10s | 2-3s | 70-80% |
| 10 chassis | 20s | 2-3s | 85-90% |
| 20 chassis | 40s | 3-4s | 90-92% |
IxPortUtilizationPlotter/
├── 🐳 Docker Infrastructure
│ ├── docker-compose.yml # Service orchestration
│ ├── prometheus.yml # Prometheus config
│ └── grafana/provisioning/ # Auto-configured data sources
│
├── 🐍 Python Pollers
│ ├── portInfoPoller.py # Port metrics (InfluxDB)
│ ├── perfMetricsPoller.py # Performance metrics (Prometheus)
│ ├── influxDBclient.py # InfluxDB operations
│ ├── IxOSRestAPICaller.py # IxOS REST API client
│ └── RestApi/ # Low-level REST interface
│
├── ⚙️ Configuration
│ ├── .env # Docker environment vars
│ ├── config.py # Chassis list & settings
│ └── requirements.txt # Python dependencies
│
├── 🚀 Management Scripts
│ ├── run_pollers.sh # Start pollers
│ └── stop_pollers.sh # Stop pollers
│
└── 📚 Documentation
├── README.md # This file
├── SOLUTION_DEPLOYMENT.md # Detailed deployment guide
└── ENVIRONMENT_VARIABLES.md # Configuration reference
.png)
Features:
- 🟢 Green = Free ports (available)
- 🔴 Red = Owned ports (user/session)
- 🕐 Synchronized timestamps across all chassis
- 📊 Real-time updates with historical view
.png)
Visualization: Multiple chassis monitored simultaneously with instant visibility into port transitions and resource utilization.
Contributions welcome! Open an issue or submit a pull request.
Open source project for Keysight/Ixia IxOS chassis monitoring.
Built with ❤️ for network test automation teams
📊 Happy Monitoring!