Logs

Navigate to System > Service Logs to stream real-time output from any Koios service or browse archived log files. The page has three tabs: Live Logs, Log Files, and Settings.

Live Logs

The Live Logs tab streams log output from a selected service in real time using server-sent events (SSE).

Selecting a Service

The left panel lists all available services. Each entry shows the service name, a brief description, and a badge indicating its current log level. Click a service to begin streaming its logs in the terminal on the right.

Use the search bar at the top of the list to filter services by name or description.

Log Terminal

Once a service is selected, its log output streams into a terminal-style viewer.

Control	Description
Log level	Dropdown to change the service's verbosity (Debug, Info, Warning, Error, Critical). Takes effect immediately.
Search	Text filter that hides lines not matching your query. The footer shows how many lines match (e.g., "50 of 200 lines").
Auto-scroll	The terminal follows new output automatically. Scroll up to pause auto-scroll; scroll back to the bottom to resume. A floating jump-to-bottom button appears when scrolled up.
Pause / Resume	Pauses incoming lines without disconnecting. Buffered lines are shown in the footer and flush to the terminal when you resume.
Clear	Removes all lines from the terminal.

Log Level Colors

Lines are color-coded by severity:

Level	Color
Critical	Red (bold)
Error	Red
Warning	Yellow
Info	Cyan
Debug	Gray

Connection Status

A badge in the terminal footer shows the current streaming state: Connecting, Connected, Error, or Disconnected. The connection automatically attempts to reconnect on error.

Adjust log level for troubleshooting

Set a service to Debug for maximum detail when investigating an issue, then return it to Info or Warning afterward to reduce noise. The change applies immediately, with no service restart required.

Log Files

The Log Files tab lets you browse, search, and download archived log files stored on the server.

File List

The left panel lists all log files with their filename, associated service, file size, and last-modified date. Click a file to open it in the viewer on the right.

Each file has a context menu (three-dot icon) with options to View, Download, or Delete the file. Deleting is permanent and requires confirmation.

Deleting the file a service is currently writing to empties it and leaves the service logging into it, so new lines appear straight away. Deleting an archived copy removes it outright.

Use the search bar to filter files by name or service.

File Viewer

The file viewer displays the selected log file with line numbers, color-coded by log level (same colors as the live terminal).

Control	Description
Search	Text search within the file. Filters to lines containing your query and resets to page 1.
Level filter	Dropdown to show only lines at a specific severity (Debug, Info, Warning, Error, Critical) or all levels.
Pagination	Files are displayed 500 lines per page. Use the Previous / Next buttons to navigate. The footer shows the current page, total pages, and total line count.
Refresh	Re-fetches the current page to pick up newly written lines.
Download	Downloads the full log file to your computer.

Server-side filtering

Search and level filters are applied on the server, so only matching lines count toward pagination. This makes it efficient to find specific entries in large log files.

Settings

The Settings tab provides configuration options for log-related behavior:

Debug Log Timeout: the Auto-revert duration, in minutes, that a service stays on Debug before returning to the platform's default level. Accepts 0–1440 minutes; set it to 0 to disable auto-revert and leave Debug on until you change it back. This prevents accidentally leaving services in verbose debug mode.
Log File Retention: set how long archived log files are kept before automatic cleanup. Older files are removed to manage disk usage.
Services in Debug Mode: lists every service currently running at Debug, with a countdown showing how long each has left before it reverts.

Auto-revert returns to the default level

A service reverting from Debug goes to the platform's default log level (Info), not to whatever level it was on beforehand. A service you had set to Warning comes back as Info, so re-apply the level you want after debugging.

What's Next

Services: view service status, restart services, and check diagnostics
System Health: monitor CPU, memory, network, and disk usage

Services Troubleshooting Koios