System Logs¶
The Logs page provides a real-time viewer for platform service logs. Unlike Audit Logs which track user actions, system logs capture application-level output from MAGK services — useful for debugging, monitoring, and troubleshooting.
Log Viewer¶
The log viewer displays service log entries in reverse chronological order with color-coded log levels.
| Column | Description |
|---|---|
| Timestamp | Log entry timestamp (UTC) |
| Service | The service that produced the log (e.g., web, tak-service, ws-gateway) |
| Level | Log severity level |
| Message | Log message content |
Log Levels¶
| Level | Color | Description |
|---|---|---|
| ERROR | Red | Failures requiring attention |
| WARN | Yellow | Potential issues or degraded behavior |
| INFO | Blue | Normal operational messages |
| DEBUG | Gray | Verbose diagnostic output (only visible when debug logging is enabled) |
Filtering¶
Use the filter controls to focus on relevant log entries.
| Filter | Description |
|---|---|
| Service | Filter by service name |
| Level | Minimum log level to display (e.g., WARN shows WARN and ERROR only) |
| Date Range | Start and end date/time |
| Search | Full-text search within log messages |
Live Tail¶
Toggle Live Tail to stream new log entries in real time. New entries appear at the top of the viewer as they are produced. Disable live tail to freeze the view for analysis.
Services¶
The log viewer aggregates logs from all platform services:
| Service | Description |
|---|---|
| web | TanStack Start application server |
| tak-service | Python TAK protocol service |
| ws-gateway | WebSocket gateway for real-time data |
| mediamtx | MediaMTX media streaming server |
| rabbitmq | RabbitMQ message broker |
| postgres | PostgreSQL database |
| nginx | Nginx reverse proxy (TAK mTLS) |
| traefik | Traefik reverse proxy (web traffic) |
Log Configuration¶
Logging behavior is controlled by environment variables. See the Configuration Reference for full details.
| Variable | Description |
|---|---|
LOG_LEVEL | Global log level (debug, info, warn, error) |
LOG_RETENTION_DAYS | Number of days to retain log entries |
LOG_BATCH_SIZE | Number of log entries per batch write |
LOG_FLUSH_INTERVAL_MS | Interval between batch flushes in milliseconds |
Log Retention¶
Logs are retained according to the LOG_RETENTION_DAYS setting. Expired log entries are automatically purged. Docker container logs are separately managed by the Docker logging driver configuration (JSON file driver with max-size and max-file limits).
Export¶
Click Export to download the current filtered log view as a text file for offline analysis or sharing with support.
Related Pages¶
- Audit Logs — User action audit trail (separate from system logs)
- Infrastructure — Service health and metrics
- Settings — Log level and retention configuration