INDEX.md

BuildXL eXecution LoG Debugger

XLG Debugger is a Visual Studio Code debugger extension for viewing/exploring/diagnosing/debugging BuildXL binary log files.

The extension is primarily focused on providing a comprehensive, post-mortem view of a build, as captured in the BuildXL execution log. This information is presented in two forms:

1. in a tree view widget, and
2. via a domain-specific query language.

The front end (the debugger extension) is distributed with the existing DScript VSCode plugin; the back end (the component feeding the information to the visual debugger) comes with the BuildXL Execution Analyzer.

Installation

• Installing DScript VSCode Extension
• Configuring XLG Debugger
• Running
• Optional Command-Line Switches
• Commands

Object Model

• Root Object
• All Pips
• Process Pips
• File Artifacts
• Directory Artifacts

Examples

• Find pips with highest memory consumption
• Find pips that produce shared opaque directories
• Find all the places the same output file is copied to

Query Language

• Key Concepts
• Evaluation Environment
• Literals
• Properties
• Variables
• Root and This Expressions
• Map Expression
• Filter Expression
• Range Expression
• Cardinality Expression
• Function Application
• Output Redirection
• Let Binding
• Assign Statement
• Match Operator
• Binary Operators
• Operator Precedence
• Library Functions