Logs & Diagnostics¶
Access and interpret system logs for troubleshooting.
Log Levels¶
| Level | Description | When to Use |
|---|---|---|
| ERROR | Errors only | Production |
| WARN | Warnings + Errors | Production |
| INFO | General information | Normal operation |
| DEBUG | Detailed debugging | Troubleshooting |
| TRACE | Very detailed | Development |
Viewing Logs¶
Via UI¶
Screenshot placeholder: Logs viewer interface
- Navigate to Admin → Logs
- Filter by:
- Level
- Time range
- Device
- Component
Via Command Line¶
# View recent logs
tail -f /var/log/intellija-gateway/gateway.log
# Search for errors
grep "ERROR" /var/log/intellija-gateway/gateway.log
# Filter by device
grep "device_id=123" /var/log/intellija-gateway/gateway.log
Log Categories¶
Connection Logs¶
- Device connect/disconnect
- MQTT connect/disconnect
- Network errors
Poll Logs¶
- Poll cycles
- Tag read attempts
- Batch reads
Command Logs¶
- DCMD received
- Write operations
- Command results
Error Logs¶
- Connection failures
- Read errors
- Configuration errors
Diagnostics¶
Connection Test¶
Test device connectivity: 1. Navigate to device 2. Click Test Connection 3. Review result
Poll Once¶
Single poll for testing: 1. Navigate to device 2. Click Poll Once 3. View tag values in result
Validate Tags¶
Check tag configuration: 1. Navigate to device 2. Click Validate Tags 3. Review validation results
Statistics Reset¶
Clear statistics to start fresh: 1. Navigate to device 2. Click Reset Statistics 3. Confirm reset
Export Logs¶
Export logs for support: 1. Navigate to Admin → Logs 2. Set filters for relevant timeframe 3. Click Export 4. Save file