Console Logs

Console Logs captures internal debug messages from a Director or Cluster. Use it to observe component activity, diagnose connectivity, and verify operational status without reaching for server-side log files.

Like Live Data, a capture is a bounded session rather than a continuous tail: you set a duration, an event limit, and the severities you care about, then read the results as a searchable table.

Console Logs is available on Director and Cluster detail pages only.

Accessing Console Logs

Navigate to Fleet Management > Directors and select a Director to open its detail view, then open the Console Logs tab. For Clusters, select a Cluster from the Clusters tab of the same page; the Cluster detail view offers the same tab.

Running a Capture

With nothing captured yet, the tab shows an empty state and a Capture console logs button. Clicking it opens the Capture console logs dialog:

Setting	Notes
Severity Level	Which severities to collect — at least one is required
Capture time in seconds	5 to 60; defaults to 60
Capture up to N events	100 to 5,000; defaults to 1,000
Filters (Optional)	Restricts the capture to messages containing this text

Click Start capture. While the session runs, a status bar reports that it is capturing and breaks the running total down by severity; Capture Settings in that bar shows the configuration in use.

A capture stops when its time elapses, when it reaches its event limit, or when you stop it — whichever comes first.

Two marker rows record when the capture started and completed. They are not counted in the event totals.

If the connection drops or the server fails the capture, the status bar says so and asks you to start a new one.

Severity Levels

Level	Description
Error	Failures requiring attention — connection errors, authentication failures, service exceptions
Warning	Conditions that may indicate problems — resource thresholds, deprecated configurations, retry attempts
Info	Normal operational messages — service startup, configuration loaded, connections established
Debug	Detailed diagnostic output — request and response traces, internal state changes, processing steps
Verbose	The most detailed output the component emits

note

A capture starts with Error, Warning, and Info selected. Debug and Verbose are deselected deliberately: both are high-volume on a busy Director, and a capture that opened with them enabled would spend its event budget before you had a chance to narrow it.

The Results Table

Captured messages appear as a table:

Column	Contents
Date	When the message was emitted
Entry Type	Its severity
Source	The component that produced it
Message	The message text

Source falls back through what the record actually carries: the producing component if named, otherwise the Director, otherwise the Director's identifier, otherwise the subsystem. This is what attributes a line in a cluster capture, where messages arrive from several Directors at once.

Searching and Exporting

Search logs filters the captured rows as you type — over what has already been captured, not over what the running session collects. The capture dialog's Filters field does the latter.

Control	Effect
Copy	Copies the captured output to the clipboard
Download	Saves the capture as CSV, JSON, or ZIP
Clean	Clears the results and returns the tab to its empty state

An exported file carries both the displayed date and the original wire timestamp. If a search term or a severity selection was active when you exported, the file records it along with the filtered and total counts, so a partial export cannot be mistaken for a complete one.

Prerequisites

Console Logs requires the Director or Cluster to be both enabled and connected. When either condition is not met, the tab explains which:

• Director or Cluster is disabled — enable the component from the Directors management page
• Director or Cluster is not connected — verify the Director service is running and reachable

Permissions

Viewing the Console Logs tab requires the console-log read permission. See Roles.

---