trace_exceptions

[diagnostics]

Groups exception evidence for a GliderTrace session by type, message, and first stack frame.

Try it locally in the GliderTrace playground

Parameters

Examples

Replace sample paths and symbol keys with values from your workspace.

Summarize exceptions in a session

{
  "sessionId": "trc_20260507_123044_ab12cd34"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trace_exceptions",
    "arguments": {
      "sessionId": "trc_20260507_123044_ab12cd34"
    }
  }
}

Response Notes

Returns grouped exception counts, first stack frames, sample events, and severity distribution. It carries a coverage block. An incomplete block adds a warning. A zero-group result may still hide dropped exceptions.

Unreleased builds with text provenance retain source and exceptionRelation in samples; see trace_query_events for their meaning and recovery. Each group contains at most three samples. samplesTruncated reports omitted occurrences. Group limits and filters can also exclude related exceptions.

timestampBasis reports ingestion, collection, unknown, or mixed; firstSeen and lastSeen use that basis. Group rank does not establish source order. Query unfiltered events and follow nextCursor when samples cannot establish the chain. Capture coverage remains separate from sample completeness and parser support.

GliderTrace 1.0.0 returns compact JSON for every tool. Result fields appear beside success; there is no response-format parameter. success describes the tool call. Check the process or session status and exitCode separately. Scalar results and fields that conflict with reserved names appear under result.

To migrate an envelope consumer, read response.sessionId instead of response.data.sessionId. Stored sessions and exported files keep their formats. --max-response-chars limits response text to 60,000 UTF-16 characters by default. Use 0 to disable it, or at least 1,000. This limit counts text characters, not transport bytes or tokens.

outputLimit.truncated marks omitted response detail. It does not change capture completeness. Use the returned next tool and arguments when available. Do not repeat a command or feedback submission to recover omitted output. For event pages, keep the filters and cursor while reducing limit.

For session details, set includeArtifacts and includeTopFindings to false to reduce output. Check error, actionable meta, warnings, and coverage before drawing conclusions. Internal diagnostics stay in local server logs.