Appearance
Monitoring & Dashboard
ioBufferPro provides two web-based portals for monitoring and managing your message channels.
Operations Portal (Port 8080)
The Operations Portal is your real-time window into message flow. Access it at http://localhost:8080.
Live View
The Live View displays real-time message flow for each channel pair. You can watch messages as they are received, buffered, and delivered.
- Source View — Shows incoming messages from the source side of each channel
- Destination View — Shows outgoing messages to the destination side of each channel
Toggle between Source View and Destination View to inspect either end of a channel pair.
Channel Overview
For each channel pair, the Operations Portal displays:
- Connection status — Whether the source and destination are connected
- Buffer state — Current state of the message buffer
- Message counts — Number of messages received, sent, and pending
Management Dashboard (Port 8081)
The Management Dashboard provides system-level configuration and administration. Access it at http://localhost:8081.
System Configuration
Manage global settings for your ioBufferPro installation, including buffer capacity, logging preferences, and network configuration.
User Management
Control access to ioBufferPro with role-based permissions:
| Role | Permissions |
|---|---|
| Admin | Full access to all settings, user management, and channel configuration |
| Operator | Can create, edit, start, and stop channels. Cannot manage users or system settings |
| Viewer | Read-only access to monitoring dashboards and logs |
System Health Overview
A high-level summary of the entire ioBufferPro installation, including active channels, overall message throughput, and system resource usage.
Status Indicators
Both portals display status indicators across three categories:
Connection Status
| Color | Meaning |
|---|---|
| Green | Connected and healthy |
| Yellow | Connecting or reconnecting |
| Red | Disconnected or error |
| White | Stopped or inactive |
Buffer Status
| Status | Meaning |
|---|---|
| Active | Buffer is actively processing messages |
| Stale | Buffer has not received new messages recently |
| Waiting | Waiting for the destination to become available |
| Queued | Messages are queued and ready for delivery |
Message Status
| Status | Meaning |
|---|---|
| Received | Message arrived from the source |
| Sent | Message delivered to the destination |
| Failed | Delivery failed (will be retried automatically) |
Performance Metrics
The Operations Portal tracks key performance metrics with threshold-based alerts:
| Metric | Normal | Warning | Critical |
|---|---|---|---|
| DB Write Time | < 1 ms | 10 - 50 ms | > 100 ms |
| Message Rate | 0 - 40/sec | 40 - 100/sec | > 100/sec |
| Queue Depth | 0 - 10 | 10 - 100 | > 100 |
| CPU Usage | < 20% | 20 - 60% | > 80% |
| Memory | < 500 MB | 500 MB - 1 GB | > 1 GB |
WARNING
If any metric enters the Critical range, investigate immediately. Sustained critical values may indicate a configuration issue, an overwhelmed destination, or insufficient system resources.
Historical Logs
ioBufferPro maintains detailed logs for auditing and troubleshooting:
System Logs
- Location:
logs/system/YYYYMMDD.log - Contains application-level events, startup/shutdown records, errors, and warnings
Channel Activity Logs
- Location:
logs/channels/<channel>/activity-YYYY-MM-DD.jsonl.gz - Contains per-channel message activity in compressed JSON Lines format
- One file per channel per day for easy archival and analysis
Filtering and Export
Both log types support:
- Date-based filtering — View logs for a specific date or date range
- Export — Download logs for offline analysis or compliance reporting
TIP
Channel activity logs are stored in compressed .jsonl.gz format, making them efficient to store and easy to process with standard tools like jq or zcat.
Health Check
To verify that your ioBufferPro installation is healthy, run the built-in diagnostic:
bash
ioBufferPro.exe --health-checkThis performs a comprehensive check including:
- Application connectivity and responsiveness
- Database integrity verification
- Channel status validation
- System resource availability
INFO
Run the health check after installation, after upgrades, or whenever you suspect an issue. It provides a quick pass/fail summary along with detailed diagnostic output.