---
title: "Logs"
description: "Stream real-time service logs and browse archived log files"
source_url: https://ai-ops.com/docs/system/logs
---

# Logs

Navigate to **System > Logs** to stream real-time output from any Koios service or browse archived log files. The page has two tabs — **Live Logs** and **Log Files**.

---

## 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.

> [!TIP] 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 — 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 a log file is permanent and requires confirmation.

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. |

> [!NOTE] 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 Timer** — configure how long debug-level logging stays active before automatically reverting to the previous log level. 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.
- **Active Debug Services** — lists all services currently running with debug-level logging enabled, along with how much time remains before each reverts.

---

## What's Next

- [Services](https://ai-ops.com/docs/system/services.md) — view service status, restart services, and check diagnostics
- [System Health](https://ai-ops.com/docs/system/performance.md) — monitor CPU, memory, network, and disk usage