System Logs

System logs provide the primary operational record for startup, requests, background jobs, worker connectivity, and failures.

Polygent ships with a built-in log viewer for diagnosing operational behavior without leaving the browser. Logs are also written to disk under StoragePath/logs/. Permission settings.view is required to use the viewer. Log level is restart-time configuration; local retention is fixed.

Where to Find It

Sidebar → Settings → System Logs.

Log Levels

Polygent uses standard .NET logging levels, in order of severity:

Level	Use
Verbose	Trace-level diagnostics — extremely chatty; use temporarily during support investigation
Debug	Useful diagnostics during development and bug reproduction
Information	Normal operational events (default)
Warning	Recoverable issues, slow operations, non-fatal hook failures
Error	Operations that failed and require attention
Fatal	Process-stopping errors

Filter the log viewer by minimum level — selecting Warning shows Warning, Error, and Fatal entries.

Time Filters

Filter	Range
Last Hour	Past 60 minutes
Last 5 Hours	Past 5 hours
Today	Since midnight (server local time)
Last 5 Days	Past 5 days
All	No time bound (paginated)

Search and Pagination

• Free-text search runs over the rendered message and structured properties
• Results are paginated; older entries fetch on demand as you scroll or page
• Combining a level filter, a time filter, and a search term is the fastest path to a needle-in-the-haystack lookup

Log Sources

The viewer aggregates entries from:

• System process — web requests, live updates, and background work
• Workers — session execution, slot deployment, and host connectivity
• Hooks — task output from every session lifecycle event, also visible in the session sidebar
• Workflow steps — task script output
• Model runs — execution output attributed to the originating session, with common secret-shaped values redacted where supported

File Layout

Logs on disk live under StoragePath/logs/ as structured JSON-lines files, written by two sinks:

• A main sink capturing every event at or above the configured level
• A separate error sink capturing only Error and Fatal events, for fast triage

Each sink rolls daily. Standalone workers write logs from their own process and configured storage context. Collect control-plane and worker logs centrally when troubleshooting distributed execution.

Configuring Log Levels

The runtime minimum level is controlled by a single setting, Logging:LogLevel:Default. It defaults to Information:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information"
    }
  }
}

Set it to Debug or Verbose for deep diagnostics, or Warning to quiet the logs, then restart Polygent to apply the change. Only the Default value needs adjusting for normal operations.

You can also set the level via an environment variable instead of editing the file:

Logging__LogLevel__Default="Debug"

note

Only the Default level is applied to the log files and viewer. Additional category-specific entries are ignored by the runtime, so changing them has no effect.

Retention

Daily-rolling files are kept for 30 days and capped at 100 MB per file; older files are pruned automatically. Retention is fixed rather than operator-configurable. For longer-term retention or compliance archival, ship the logs/ directory to your own log store (e.g. a SIEM or object storage) before the 30-day window elapses.

See Also

• Storage — StoragePath layout
• Session Hooks — hook execution logs surface here too