Build Logs
Rogue Architect provides two levels of logging during a build: a high-level event feed and detailed per-plugin Ansible output.
Event Log
Section titled “Event Log”Open the Build Logs panel from the left sidebar (or click the Logs icon in the dock) to see a real-time feed of build lifecycle events. Events are color-coded by type:
- Green — Successful events (deployed, completed)
- Red — Errors and failures
- Yellow/Warning — Status changes and transitions
Filtering
Section titled “Filtering”Click the settings gear icon to filter which event categories appear in the log. Available filters include:
- Deploying / Deployed
- Errored
- Machine Ready
- Snapshotting Build
- Plugin Started / Completed
- And more
Smart Highlighting
Section titled “Smart Highlighting”The log automatically highlights machine names and plugin names with colored badges, making it easy to scan for specific machines or plugins in a busy log stream.
The event log updates via WebSocket — new events appear automatically without refreshing.
Per-Plugin Ansible Logs
Section titled “Per-Plugin Ansible Logs”For detailed Ansible playbook output, click any machine on the canvas to open the Machine Build Progress panel, then click the log button on a specific plugin.
This opens a full code viewer (powered by Monaco, the VS Code engine) with custom Ansible syntax highlighting:
- PLAY and TASK headers are highlighted
- Status markers (
ok,changed,failed,FATAL,skipping) are color-coded - SSH connection lines and key-value pairs are parsed and formatted
Multi-Run Tabs
Section titled “Multi-Run Tabs”If a plugin has been executed multiple times (e.g., after a redeploy), each run appears as a separate tab. Color dots on each tab indicate that run’s status, so you can compare runs side by side.
Copy to Clipboard
Section titled “Copy to Clipboard”A floating copy button in the top-right corner of the log viewer lets you copy the entire log output for sharing or pasting into support requests.
Verbose Logging
Section titled “Verbose Logging”If you enabled Verbose Logging in the build configuration, Ansible runs with maximum verbosity (-vvvv). This produces significantly more output, including:
- Variable values at each task
- Connection details
- Module arguments
- Full error tracebacks
Verbose logs are essential for debugging complex plugin failures but produce much larger log volumes during normal builds.