Console Logs

Console Logs streams real-time system debug messages from a Director or Cluster instance. Use it to observe internal component activity, diagnose connectivity issues, and verify operational status without accessing server-side log files.

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

Accessing Console Logs

Navigate to Fleet Management > Directors, select a Director (or expand a Cluster), and open the Console Logs tab in the detail view.

Using Console Logs

The Console Logs panel provides a streaming text display with transport controls:

1. Configure capture parameters using the Filter button before starting
2. Click Capture to begin streaming — the button changes to Stop
3. Messages appear in the output area in monospace format with automatic scrolling
4. Use the query input field to filter messages by substring while streaming
5. Click Stop to end capture, or wait for the capture time to elapse
6. Click the Copy button to copy all captured output to the clipboard
7. Click Clean to clear the output and reset to idle state

Capture stops automatically when either the capture time or the capture count limit is reached, whichever occurs first.

Filter Options

Click the Filter button to open the filter popover. Configure these parameters before starting a capture:

Option	Type	Range	Default	Description
Severity	Multiselect	Error, Warning, Info, Debug	All selected	Log severity levels to include
Capture time	Number	5–60 seconds	10	Maximum duration of the capture session
Capture count	Number	100–5,000 events	1,000	Maximum number of messages to capture

Click Apply to save filter settings, or Cancel to discard changes. Filter settings persist for the duration of the browser session.

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/response traces, internal state changes, processing steps

Prerequisites

Console Logs requires the Director or Cluster to be both enabled and connected. When either condition is not met, the panel displays an alert explaining the issue:

• Director/Cluster is disabled — Enable the component from the Directors management page
• Director/Cluster is not connected — Verify the Director service is running and network connectivity is available

---