Browse documentation

GliderTrace tool reference

Technical reference for agents and client integrators. GliderTrace 1.0.0 uses compact JSON with result fields beside success. Check count certainty, capture coverage, and source identity separately. Choose a task

Status

trace_status
Reports workspace roots, runner policies, session settings, and optional diagnostics capabilities.
trace_add_workspace
Adds a trusted workspace root when runtime workspace changes are enabled.
trace_remove_workspace
Removes a workspace root that was registered at runtime via trace_add_workspace. Admin-configured --workspace roots cannot be removed.

Run, Test & Sessions

trace_run
Runs a command under the workspace, captures stdout/stderr evidence, and stores a GliderTrace runtime session.
trace_build
Builds a .NET project or solution and stores diagnostics with a sensitive MSBuild binary log.
trace_restore
Restores .NET packages and stores warnings, failures, and project outcomes.
trace_pipeline
Runs restore, build, and test as one ordered GliderTrace session. It stops at the first stage that fails. The verdict names that stage, its first cause, and the Glider symbolKey the cause maps to.
trace_run_tests
Runs .NET tests and stores failures, output, and available TRX artifacts.
trace_start
Starts a long-running command under the workspace and stores an active GliderTrace runtime session.
trace_stop
Stops an active trace_start session, terminates the launched process, and finalizes stored evidence.

Analyze Evidence

trace_correlate_code
Maps stored GliderTrace stack-frame evidence to Glider-compatible C# symbol references.
trace_exceptions
Groups exception evidence for a GliderTrace session by type, message, and first stack frame.
trace_counters
Summarizes collected dotnet-counters CSV artifacts for a GliderTrace session.
trace_hotspots
Summarizes CPU sample hotspots from collected runtime.nettrace artifacts for a GliderTrace session.

Inspect, Compare & Export

trace_get_session
Returns GliderTrace session metadata, compact summary, artifact references, and optional top findings.
trace_query_events
Queries normalized GliderTrace evidence events by session, kind, text, severity, and cursor.
trace_compare_sessions
Compares two stored GliderTrace sessions and highlights fixed, new, and persisting evidence.
trace_export
Exports a compact GliderTrace agent summary or zip artifact reference for a session.
trace_list_sessions
Lists stored GliderTrace sessions from the local session index, with filters for mode, status, label, and start time.
trace_pin_session
Pins or unpins a stored GliderTrace session. Retention never deletes a pinned session.

Capture Sensitive Dumps

trace_capture_dump
Captures an explicit sensitive process dump artifact from an already-running local CoreCLR process.
trace_capture_gcdump
Captures an explicit sensitive GC dump artifact from an already-running local CoreCLR process.

Import, Attach & Capture

trace_import_otlp
Imports bounded OpenTelemetry JSON or NDJSON evidence from a workspace file into a GliderTrace session.
trace_import_artifacts
Imports existing workspace or artifact-root TRX, MSBuild binlog, log, counters, nettrace, ETL, dump, or GC dump files into a GliderTrace session.
trace_list_processes
Lists local Windows processes, or diagnostics-published processes on other hosts. Inspect each target before capture.

From GliderTrace 1.0.0: expanded Windows inventory, target identities, and process capabilities.

trace_attach
Collects a bounded EventPipe nettrace from CoreCLR, or an ETW profile from a verified Windows Framework IIS worker.

Feedback

send_feedback
Sends feedback and product facts as a public GitHub issue. First search open and closed issues in glidermcp/glidermcp for your exact problem using abstract, public terms. Confirm each duplicate concerns GliderTrace. Update to the latest product version. Restart the server. Retry the affected operation. If a duplicate exists, use the existing issue. Call send_feedback only if the problem persists after the update and no duplicate exists.