Skip to main content

TraceLayout

from v9.4status Work-in-Progress

TraceLayout is the render-ready representation of a filtered trace graph.

import {buildTraceLayout, buildTraceLayouts, type TraceLayout} from '@deck.gl-community/trace-layers/trace';

What it contains​

  • visible process and thread rows
  • span, local dependency, and cross dependency geometry chunks
  • geometry caches for reuse
  • current and fully expanded bounds
  • collapse-aware row state
  • optional collapsed activity summaries
  • the visible graph projection the layout reflects

TraceLayout describes where normalized trace objects draw. It is not an ingestion format.

Builder APIs​

  • buildTraceLayout(...): build one layout for one graph
  • buildTraceLayouts(...): build aligned layouts for one or more graphs
  • buildTraceLayoutForSpanRefs(...): focused relayout for selected span refs
  • rebuildTraceLayoutGeometry(...): refresh geometry without rebuilding structure

Collapse state​

TraceLayoutCollapseState aligns one TraceGraphCollapseState per displayed graph. Use process and thread refs in mounted state, then serialize IDs only when crossing persistence boundaries with serializeTraceGraphCollapseState(...) and deserializeTraceGraphCollapseState(...).

Invalidation​

Rebuild layout when filtered topology, visible threads, aggregation mode, lane limits, process layout mode, or density changes. Rebuild geometry when timing projection, min span time, or local dependency geometry changes. Render-only color, fade, and animation changes should not rebuild the layout.

See Rendering traces and TraceVisSettings.