Skip to main content

JSONTrace

from v9.4status Work-in-Progress

JSONTrace is the JSON-safe normalized trace document used at ingestion and export boundaries.

import {buildJSONTrace, materializeJSONTrace} from '@deck.gl-community/trace-layers/trace';

Shape​

JSONTrace contains:

  • processes
  • crossDependencies
  • optional graph-global events
  • optional timeExtents
  • optional spanLayout, usually 'auto' or 'manual'

JSONTraceProcess owns process-local threads, spans, local dependencies, instants, and counters. JSONTrace adds graph-wide dependencies and events.

Use it for​

  • normalized JSON files
  • simple application builders
  • import/export boundaries
  • source-specific loaders before Arrow-backed runtime materialization

Do not use it as a render cache. Geometry belongs in TraceLayout, and runtime lookup/filter state belongs in TraceGraph.

Main helpers​

  • buildJSONTrace(...)
  • materializeJSONTrace(...)
  • mergeJSONTraces(...)
  • getJSONTraceTimingBounds(...)
  • buildTraceChunkDataFromJSONTrace(...)
  • buildTraceGraphDataFromJSONTrace(...)

Manual span layout​

When spanLayout is 'manual', spans may provide thread-relative layoutTopY and layoutHeight. Both values must be finite, layoutTopY >= 0, and layoutHeight > 0 for the span to render in manual mode.

See Data model, TraceGraphData, and TraceLayout.