DocsServer Managementserver_read_logs

server_read_logs

Server Read Logs

Read log entries from either the browser process or HTTP server. By default reads from browser logs which contain detailed IPC commands, rendering events, and page interactions. Use source='server' for HTTP server logs. Supports head (first N lines), tail (last N lines), or range (specific line range) modes. Can filter logs by level (DEBUG, INFO, WARN, ERROR) and by pattern matching (regex or substring).

Usage Example

1234567891011
import asyncio
from owl_browser import OwlBrowser, RemoteConfig
# Async usage
async with OwlBrowser(config) as browser:
context = await browser.create_context()
context_id = context["context_id"]
await browser.server_read_logs(
)

Parameters

Optional

sourceenum
browserserver

Log source to read from: 'browser' (browser process logs with detailed IPC, rendering, and page events) or 'server' (HTTP server logs). Default: 'browser'

modeenum
headtailrange

Read mode: 'head' (first N lines), 'tail' (last N lines), 'range' (specific line range). Default: 'tail'

linesstring

Number of lines to return for head/tail mode. Default: 100

start_linestring

Starting line number for range mode (1-indexed). Default: 1

end_linestring

Ending line number for range mode (1-indexed). Default: start_line + 100

filterstring

Filter pattern to match log lines. Supports regex or simple substring matching.

levelenum
DEBUGINFOWARNERROR

Filter by log level: 'DEBUG', 'INFO', 'WARN', 'ERROR'. Only lines with this level are returned.

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}