Is this page helpful?

Log Viewer#

Log Viewer provides a browser-based dashboard for real-time analysis of HOISA software logs. It is packaged as a self-contained binary with all runtime dependencies included.

1. Overview#

Log Viewer streams HOISA software logs to a browser-based dashboard. It auto-detects components, parses multiple log formats, and reflects new log entries in near real-time.

Property

Details

Deployment

Self-contained binary with all runtime dependencies bundled

Live updates

Near real-time via Linux inotify

Max log files

Up to 2 files merged into one dashboard

Default port

8080 (configurable via --port)

2. Features#

  • Dashboard — per-component tabs with stats, error counts, and timeline charts.

  • Filtering — severity, free-text search, and timestamp range filters per tab.

  • Live tailing — new log entries are reflected in near real-time with smart auto-scroll.

  • Export — HTML, PDF, Excel, and CSV; respects active filters.

  • AI Debug — ask natural-language questions against the live log state; export chat as HTML/PDF.

3. Launching the Tool#

Note

pss_log_viewer is distributed separately and is not part of the HOISA Debian packages or the Safety Core container image. The commands below assume you have already obtained the binary and are running it from its own directory.

# Single log file (default port 8080)
./pss_log_viewer /path/to/pss.log

# Two log files merged
./pss_log_viewer /path/to/pss.log /path/to/atl_sdm.log

# Custom port
./pss_log_viewer /path/to/pss.log --port 9090

# Large files — load only last N lines on startup
./pss_log_viewer /path/to/pss.log --last 50000

Tip

The tool prints the full network URL on startup (e.g. http://192.168.1.42:8080). Open it from any browser on the same network.

4. Launching with AI Debug#

The AI Debug tab is an optional feature that enables natural-language querying of the live log state. It supports any LLM inference endpoint that implements the standard Chat Completions API, giving users the flexibility to connect their preferred model and service.

Set the following environment variables before launching:

export PSS_AI_BASE_URL=<your-llm-endpoint-url>
export PSS_AI_MODEL=<your-model-name>
export PSS_AI_API_KEY=<your-api-key>
./pss_log_viewer /path/to/pss.log

Note

All other dashboard features — log viewing, filtering, and export — are available without configuring the AI Debug tab.

5. CLI Reference#

Usage: pss_log_viewer [logfile1] [logfile2] [options]

Positional Arguments:
  logfiles          Path(s) to log file(s). Up to 2 files supported.

Options:
  --port, -p        Dashboard port (default: 8080)
  --last, -n        Read only last N lines on startup
  -h, --help        Show this help message

Environment Variables:
  PSS_AI_API_KEY    LLM API key — required for AI debug tab
  PSS_AI_BASE_URL   LLM endpoint URL
  PSS_AI_MODEL      LLM model name