System

System logs and monitoring

System logs

The System Logs tab shows application logs stored in the database. Logs are automatically cleaned up after one week.

Log levels

• error – Failures that need attention (failed API calls, database errors, unhandled exceptions)
• warn – Issues that didn’t cause a failure but might indicate problems (deprecation warnings, slow queries)
• info – Normal operational events (user logins, snapshot publishes, import completions)
• debug – Detailed diagnostic info (request payloads, query timing, cache hits/misses)

Filtering

Filter logs by:

• Level – Show only errors, warnings, or a specific level
• Date range – Narrow to a specific time window
• Search – Free-text search across log messages
• Service – Filter by service name (default is admin-backend)
• Trace ID – Find all logs from a specific request using the trace ID from error responses

Log details

Each log entry shows:

• Timestamp
• Level (color-coded)
• Message
• Service name
• Optional context data (JSON) with request details, user info, etc.
• Trace ID for correlating related log entries

Cleanup

Logs older than 7 days are automatically purged. For persistent monitoring, consider exporting important log patterns to external monitoring tools.

API key management

Admins can view all API keys across all users from the Administration tab. For managing your own API keys, use Account > API Keys in the sidebar. See the API Integration docs in the Developers section for details on creating and using API keys.