Telemetry Flags Reference
224 flags. GENERATED by scripts/gen-telemetry-reference.py from telemetry-flags.jsonc — do not hand-edit.
Every gate that controls Typhon's distributed tracing and typed-event Profiler. All default off unless noted; enabling a subtree's root enables its leaves (parent-implies-children). Set them in typhon.telemetry.json or via TYPHON__…__ENABLED environment variables.
Copy-paste template
Copy this into typhon.telemetry.json (the loader skips comments and trailing commas) and flip what you need. It also ships verbatim as typhon.telemetry.template.jsonc next to this page in the repo.
// GENERATED by scripts/gen-telemetry-reference.py from telemetry-flags.jsonc — do not hand-edit.
// Copy to `typhon.telemetry.json` (or keep the .jsonc — the loader skips comments),
// then flip the flags you want to observe. Env vars override: TYPHON__PROFILER__…__ENABLED=true.
// Parent-implies-children: enabling a subtree's root enables all its leaves unless a leaf is set false.
{
"Typhon": {
"Profiler": {
// Global profiler enable/disable. When false, all profiler-emitted telemetry is disabled regardless of individual component settings.
"Enabled": false,
"GcTracing": {
// Whether opt-in .NET runtime GC-event tracing is requested by configuration.
"Enabled": false,
},
"MemoryAllocations": {
// Whether opt-in per-allocation tracking is requested by configuration.
"Enabled": false,
},
"CpuSampling": {
// Whether opt-in in-process CPU stack sampling is requested by configuration.
"Enabled": false,
},
"Gauges": {
// Whether opt-in per-tick gauge snapshots are requested by configuration.
"Enabled": false,
},
"Scheduler": {
// Whether Scheduler component telemetry is enabled in configuration.
"Enabled": false,
"Gauges": {
"TransitionLatency": {
// Whether to track per-system transition latency.
"Enabled": true,
},
"WorkerUtilization": {
// Whether to track per-worker active/idle time breakdown.
"Enabled": true,
},
"StragglerGap": {
// Whether to track straggler gap (parallel efficiency metric for Patate systems).
"Enabled": true,
},
},
"ArchetypeTouches": {
// Whether to capture per-(system, archetype) entity-touch counts at parallel-query completion (Workbench Data Flow module). Default true. JIT dead-code-eliminates the capture path when false.
"Enabled": true,
},
"System": {
// Combined gate for the Scheduler:System subtree (per-system execution/queue-wait spans).
"Enabled": false,
"StartExecution": {
// Combined gate for the Scheduler:System:StartExecution span.
"Enabled": false,
},
"Completion": {
// Combined gate for the Scheduler:System:Completion span.
"Enabled": false,
},
"QueueWait": {
// Combined gate for the Scheduler:System:QueueWait span (time a system waited in its queue before running).
"Enabled": false,
},
"SingleThreaded": {
// Combined gate for the Scheduler:System:SingleThreaded span.
"Enabled": false,
},
},
"Worker": {
// Combined gate for the Scheduler:Worker subtree (worker idle/wake spans).
"Enabled": false,
"Idle": {
// Combined gate for the Scheduler:Worker:Idle span.
"Enabled": false,
},
"Wake": {
// Combined gate for the Scheduler:Worker:Wake span.
"Enabled": false,
},
"BetweenTick": {
// Combined gate for the Scheduler:Worker:BetweenTick span (worker gap between ticks).
"Enabled": false,
},
},
"Dispense": {
// Combined gate for the Scheduler:Dispense span (work-item dispense to workers).
"Enabled": false,
},
"Dependency": {
// Combined gate for the Scheduler:Dependency subtree (dependency-ready/fan-out spans).
"Enabled": false,
"Ready": {
// Combined gate for the Scheduler:Dependency:Ready span (a system's dependencies became satisfied).
"Enabled": false,
},
"FanOut": {
// Combined gate for the Scheduler:Dependency:FanOut span.
"Enabled": false,
},
},
"Overload": {
// Combined gate for the Scheduler:Overload subtree (overload level-change/shed spans).
"Enabled": false,
"LevelChange": {
// Combined gate for the Scheduler:Overload:LevelChange span.
"Enabled": false,
},
"SystemShed": {
// Combined gate for the Scheduler:Overload:SystemShed span (a system shed under overload).
"Enabled": false,
},
"TickMultiplier": {
// Combined gate for the Scheduler:Overload:TickMultiplier span.
"Enabled": false,
},
"Detector": {
// Combined flag for the per-tick OverloadDetector gauge snapshot (overrunRatio, consecutive counters, level, multiplier).
"Enabled": false,
},
},
"Graph": {
// Combined gate for the Scheduler:Graph subtree (DAG build/rebuild spans).
"Enabled": false,
"Build": {
// Combined gate for the Scheduler:Graph:Build span (initial DAG build).
"Enabled": false,
},
"Rebuild": {
// Combined gate for the Scheduler:Graph:Rebuild span (DAG rebuild after a schema/system change).
"Enabled": false,
},
},
"Metronome": {
// Combined gate for the Scheduler:Metronome subtree.
"Enabled": false,
"Wait": {
// Combined flag for the SchedulerMetronomeWait span (kind 241).
"Enabled": false,
},
},
"Queue": {
// Combined gate for the Scheduler:Queue subtree.
"Enabled": false,
"TickEnd": {
// Combined flag for the QueueTickEnd instant (kind 244). Per-(tick, queue) rollup emitted at end-of-tick; drives the Workbench Data API queue/<name> tracks (#311 / DAG view backpressure edges).
"Enabled": false,
},
},
},
"Concurrency": {
// Combined Concurrency root gate: master Enabled AND Typhon:Profiler:Concurrency:Enabled.
"Enabled": false,
"AccessControl": {
// Combined gate for the AccessControl subtree.
"Enabled": false,
"SharedAcquire": {
// Combined gate for AccessControl shared-acquire events.
"Enabled": false,
},
"SharedRelease": {
// Combined gate for AccessControl shared-release events.
"Enabled": false,
},
"ExclusiveAcquire": {
// Combined gate for AccessControl exclusive-acquire events.
"Enabled": false,
},
"ExclusiveRelease": {
// Combined gate for AccessControl exclusive-release events.
"Enabled": false,
},
"Promotion": {
// Combined gate for AccessControl shared↔exclusive promotion/demotion events.
"Enabled": false,
},
"Contention": {
// Combined gate for AccessControl contention markers.
"Enabled": false,
},
},
"AccessControlSmall": {
// Combined gate for the AccessControlSmall subtree.
"Enabled": false,
"SharedAcquire": {
// Combined gate for AccessControlSmall shared-acquire events.
"Enabled": false,
},
"SharedRelease": {
// Combined gate for AccessControlSmall shared-release events.
"Enabled": false,
},
"ExclusiveAcquire": {
// Combined gate for AccessControlSmall exclusive-acquire events.
"Enabled": false,
},
"ExclusiveRelease": {
// Combined gate for AccessControlSmall exclusive-release events.
"Enabled": false,
},
"Contention": {
// Combined gate for AccessControlSmall contention markers.
"Enabled": false,
},
},
"ResourceAccessControl": {
// Combined gate for the ResourceAccessControl subtree.
"Enabled": false,
"Accessing": {
// Combined gate for ResourceAccessControl Accessing-mode acquire events.
"Enabled": false,
},
"Modify": {
// Combined gate for ResourceAccessControl Modify-mode acquire events.
"Enabled": false,
},
"Destroy": {
// Combined gate for ResourceAccessControl Destroy-mode acquire events.
"Enabled": false,
},
"ModifyPromotion": {
// Combined gate for ResourceAccessControl Modify-promotion slow-path events.
"Enabled": false,
},
"Contention": {
// Combined gate for ResourceAccessControl contention markers.
"Enabled": false,
},
},
"Epoch": {
// Combined gate for the Epoch subtree.
"Enabled": false,
"ScopeEnter": {
// Combined gate for EpochGuard Enter (PinCurrentThread) events.
"Enabled": false,
},
"ScopeExit": {
// Combined gate for EpochGuard Dispose events.
"Enabled": false,
},
"Advance": {
// Combined gate for GlobalEpoch advance events.
"Enabled": false,
},
"Refresh": {
// Combined gate for RefreshScope events.
"Enabled": false,
},
"SlotClaim": {
// Combined gate for EpochThreadRegistry slot-claim events.
"Enabled": false,
},
"SlotReclaim": {
// Combined gate for EpochThreadRegistry dead-thread slot-reclaim events.
"Enabled": false,
},
},
"AdaptiveWaiter": {
// Combined gate for the AdaptiveWaiter subtree.
"Enabled": false,
"YieldOrSleep": {
// Combined gate for AdaptiveWaiter yield-or-sleep transition events. Phase 2 design (#280) chose transitions only — NOT per-spin — to keep trace volume sane.
"Enabled": false,
},
},
"OlcLatch": {
// Combined gate for the OlcLatch subtree.
"Enabled": false,
"WriteLockAttempt": {
// Combined gate for OlcLatch TryWriteLock-failure events.
"Enabled": false,
},
"WriteUnlock": {
// Combined gate for OlcLatch WriteUnlock events.
"Enabled": false,
},
"MarkObsolete": {
// Combined gate for OlcLatch MarkObsolete events.
"Enabled": false,
},
"ValidationFail": {
// Combined gate for OlcLatch ValidateVersion-failure events.
"Enabled": false,
},
},
},
"Spatial": {
// Combined gate for the entire Spatial subsystem (parent of all Spatial:* leaves).
"Enabled": false,
"Query": {
// Combined gate for the Spatial:Query subtree (AABB/radius/ray/frustum/kNN/count query spans).
"Enabled": false,
"Aabb": {
// Combined gate for the Spatial:Query:Aabb span (axis-aligned bounding-box overlap query).
"Enabled": false,
},
"Radius": {
// Combined gate for the Spatial:Query:Radius span (radius/sphere overlap query).
"Enabled": false,
},
"Ray": {
// Combined gate for the Spatial:Query:Ray span (ray-cast query).
"Enabled": false,
},
"Frustum": {
// Combined gate for the Spatial:Query:Frustum span (frustum-culling query).
"Enabled": false,
},
"Knn": {
// Combined gate for the Spatial:Query:Knn span (k-nearest-neighbour query).
"Enabled": false,
},
"Count": {
// Combined gate for the Spatial:Query:Count span (count-only spatial query).
"Enabled": false,
},
},
"RTree": {
// Combined gate for the Spatial:RTree subtree (R-tree structural mutation spans).
"Enabled": false,
"Insert": {
// Combined gate for the Spatial:RTree:Insert span.
"Enabled": false,
},
"Remove": {
// Combined gate for the Spatial:RTree:Remove span.
"Enabled": false,
},
"NodeSplit": {
// Combined gate for the Spatial:RTree:NodeSplit span.
"Enabled": false,
},
"BulkLoad": {
// Combined gate for the Spatial:RTree:BulkLoad span (bulk STR-pack load).
"Enabled": false,
},
},
"Grid": {
// Combined gate for the Spatial:Grid subtree (uniform-grid cell tier/occupancy spans).
"Enabled": false,
"CellTierChange": {
// Combined gate for the Spatial:Grid:CellTierChange span (cell promoted/demoted between density tiers).
"Enabled": false,
},
"OccupancyChange": {
// Combined gate for the Spatial:Grid:OccupancyChange span.
"Enabled": false,
},
"ClusterCellAssign": {
// Combined gate for the Spatial:Grid:ClusterCellAssign span (cluster assigned to a grid cell).
"Enabled": false,
},
},
"Cell": {
// Combined gate for the Spatial:Cell subtree.
"Enabled": false,
"Index": {
// Combined gate for the Spatial:Cell:Index subtree (per-cell occupant index add/update/remove spans).
"Enabled": false,
"Add": {
// Combined gate for the Spatial:Cell:Index:Add span.
"Enabled": false,
},
"Update": {
// Combined gate for the Spatial:Cell:Index:Update span.
"Enabled": false,
},
"Remove": {
// Combined gate for the Spatial:Cell:Index:Remove span.
"Enabled": false,
},
},
},
"ClusterMigration": {
// Combined gate for the Spatial:ClusterMigration subtree (cross-cell cluster migration spans).
"Enabled": false,
"Detect": {
// Combined gate for the Spatial:ClusterMigration:Detect span (migration-needed detection).
"Enabled": false,
},
"Queue": {
// Combined gate for the Spatial:ClusterMigration:Queue span (migration enqueue).
"Enabled": false,
},
"Execute": {
// Combined gate for the Spatial:ClusterMigration:Execute span (migration apply; legacy kind 60, on by default).
"Enabled": false,
},
"Hysteresis": {
// Combined gate for the Spatial:ClusterMigration:Hysteresis span (hysteresis suppression of a migration).
"Enabled": false,
},
},
"TierIndex": {
// Combined gate for the Spatial:TierIndex subtree (tier-index rebuild spans).
"Enabled": false,
"Rebuild": {
// Combined gate for the Spatial:TierIndex:Rebuild span.
"Enabled": false,
},
"VersionSkip": {
// Combined gate for the Spatial:TierIndex:VersionSkip span (rebuild skipped because the version was unchanged).
"Enabled": false,
},
},
"Maintain": {
// Combined gate for the Spatial:Maintain subtree (index-maintenance spans on entity insert/update).
"Enabled": false,
"Insert": {
// Combined gate for the Spatial:Maintain:Insert span.
"Enabled": false,
},
"UpdateSlowPath": {
// Combined gate for the Spatial:Maintain:UpdateSlowPath span.
"Enabled": false,
},
"AabbValidate": {
// Combined gate for the Spatial:Maintain:AabbValidate span.
"Enabled": false,
},
"BackPointerWrite": {
// Combined gate for the Spatial:Maintain:BackPointerWrite span.
"Enabled": false,
},
},
"Trigger": {
// Combined gate for the Spatial:Trigger subtree (spatial-trigger region/eval spans).
"Enabled": false,
"Occupant": {
// Combined gate for the Spatial:Trigger:Occupant subtree.
"Enabled": false,
"Diff": {
// Combined gate for the Spatial:Trigger:Occupant:Diff span (enter/exit occupant diff).
"Enabled": false,
},
},
"Cache": {
// Combined gate for the Spatial:Trigger:Cache subtree.
"Enabled": false,
"Invalidate": {
// Combined gate for the Spatial:Trigger:Cache:Invalidate span.
"Enabled": false,
},
},
"Region": {
// Combined gate for the Spatial:Trigger:Region span.
"Enabled": false,
},
"Eval": {
// Combined gate for the Spatial:Trigger:Eval span (trigger-region evaluation).
"Enabled": false,
},
},
},
"Runtime": {
// Combined gate for the Runtime tracing subtree (UoW phase, transaction lifecycle, subscription spans).
"Enabled": false,
"Phase": {
// Combined gate for the Runtime:Phase subtree (unit-of-work create/flush spans).
"Enabled": false,
"UoWCreate": {
// Combined gate for the Runtime:Phase:UoWCreate span (unit-of-work creation).
"Enabled": false,
},
"UoWFlush": {
// Combined gate for the Runtime:Phase:UoWFlush span (unit-of-work flush).
"Enabled": false,
},
},
"Transaction": {
// Combined gate for the Runtime:Transaction subtree (transaction lifecycle spans).
"Enabled": false,
"Lifecycle": {
// Combined gate for the Runtime:Transaction:Lifecycle span.
"Enabled": false,
},
},
"Subscription": {
// Combined gate for the Runtime:Subscription subtree (change-subscription delivery spans).
"Enabled": false,
"Output": {
// Combined gate for the Runtime:Subscription:Output subtree (subscriber output execute/cleanup spans).
"Enabled": false,
"Execute": {
// Combined gate for the Runtime:Subscription:Output:Execute span (running a subscriber's output callback).
"Enabled": false,
},
"Cleanup": {
// Combined gate for the Runtime:Subscription:Output:Cleanup span.
"Enabled": false,
},
},
"Subscriber": {
// Combined gate for the Runtime:Subscription:Subscriber span (per-subscriber delivery).
"Enabled": false,
},
"Delta": {
"Build": {
// Combined gate for the Runtime:Subscription:Delta:Build span (building a change delta).
"Enabled": false,
},
"Serialize": {
// Combined gate for the Runtime:Subscription:Delta:Serialize span (serializing a change delta).
"Enabled": false,
},
"DirtyBitmapSupplement": {
// Combined gate for the Runtime:Subscription:Delta:DirtyBitmapSupplement span.
"Enabled": false,
},
},
"Transition": {
"BeginSync": {
// Combined gate for the Runtime:Subscription:Transition:BeginSync span.
"Enabled": false,
},
},
},
"WriteTickFence": {
// Combined gate for the Runtime:WriteTickFence subtree (per-table and per-archetype cluster write-fence spans).
"Enabled": false,
"Table": {
// Combined gate for the Runtime:WriteTickFence:Table span (per-table fence cost).
"Enabled": false,
},
"Shadow": {
// Combined gate for the Runtime:WriteTickFence:Shadow span (shadow-copy portion of a table fence).
"Enabled": false,
},
"Spatial": {
// Combined gate for the Runtime:WriteTickFence:Spatial span (spatial-index portion of a table fence).
"Enabled": false,
},
"Cluster": {
// Combined gate for the Runtime:WriteTickFence:Cluster span (per-archetype cluster fence cost).
"Enabled": false,
"Shadow": {
// Combined gate for the Runtime:WriteTickFence:Cluster:Shadow span.
"Enabled": false,
},
"Spatial": {
// Combined gate for the Runtime:WriteTickFence:Cluster:Spatial span.
"Enabled": false,
},
},
},
"ThreadScheduling": {
// Whether OS thread scheduling tracing is requested by configuration. When enabled (Windows-only), EtwSchedulingPump opens the NT Kernel Logger and emits one ThreadContextSwitch record per on-CPU slice for every Typhon-registered OS thread. Records carry duration + wait reason so the Workbench can render off-CPU gaps with their cause overlaid on the affected thread's lane.
"Enabled": false,
},
},
"Storage": {
// Combined gate for the Storage tracing subtree (page-cache, segment, file-handle, occupancy-map spans).
"Enabled": false,
"PageCache": {
// Combined gate for the Storage:PageCache subtree.
"Enabled": false,
"DirtyWalk": {
// Combined gate for the Storage:PageCache:DirtyWalk span (walk of dirty pages during checkpoint).
"Enabled": false,
},
},
"Segment": {
// Combined gate for the Storage:Segment subtree (segment create/grow/load spans).
"Enabled": false,
"Create": {
// Combined gate for the Storage:Segment:Create span.
"Enabled": false,
},
"Grow": {
// Combined gate for the Storage:Segment:Grow span.
"Enabled": false,
},
"Load": {
// Combined gate for the Storage:Segment:Load span.
"Enabled": false,
},
},
"ChunkSegment": {
// Combined gate for the Storage:ChunkSegment subtree.
"Enabled": false,
"Grow": {
// Combined gate for the Storage:ChunkSegment:Grow span.
"Enabled": false,
},
},
"FileHandle": {
// Combined gate for the Storage:FileHandle span (OS file-handle lifecycle).
"Enabled": false,
},
"OccupancyMap": {
// Combined gate for the Storage:OccupancyMap subtree.
"Enabled": false,
"Grow": {
// Combined gate for the Storage:OccupancyMap:Grow span.
"Enabled": false,
},
},
},
"Memory": {
// Combined gate for the Memory tracing subtree.
"Enabled": false,
"AlignmentWaste": {
// Combined gate for the Memory:AlignmentWaste span (bytes lost to alignment padding on an allocation).
"Enabled": false,
},
},
"Data": {
// Combined gate for the Data-plane tracing subtree (transaction, MVCC, B+Tree index spans).
"Enabled": false,
"Transaction": {
// Combined gate for the Data:Transaction subtree (init/prepare/validate/conflict/cleanup spans).
"Enabled": false,
"Init": {
// Combined gate for the Data:Transaction:Init span.
"Enabled": false,
},
"Prepare": {
// Combined gate for the Data:Transaction:Prepare span.
"Enabled": false,
},
"Validate": {
// Combined gate for the Data:Transaction:Validate span (commit-time conflict validation).
"Enabled": false,
},
"Conflict": {
// Combined gate for the Data:Transaction:Conflict span (write-write conflict detected).
"Enabled": false,
},
"Cleanup": {
// Combined gate for the Data:Transaction:Cleanup span.
"Enabled": false,
},
},
"MVCC": {
// Combined gate for the Data:MVCC subtree (version chain-walk and cleanup spans).
"Enabled": false,
"ChainWalk": {
// Combined gate for the Data:MVCC:ChainWalk span (walking a version chain to the visible revision).
"Enabled": false,
},
"VersionCleanup": {
// Combined gate for the Data:MVCC:VersionCleanup span (reclaiming obsolete versions).
"Enabled": false,
},
},
"Index": {
// Combined gate for the Data:Index subtree.
"Enabled": false,
"BTree": {
// Combined gate for the Data:Index:BTree subtree (B+Tree search/scan/mutation spans).
"Enabled": false,
"Search": {
// Combined gate for the Data:Index:BTree:Search span (point lookup).
"Enabled": false,
},
"RangeScan": {
// Combined gate for the Data:Index:BTree:RangeScan span.
"Enabled": false,
"Revalidate": {
// Combined gate for the Data:Index:BTree:RangeScan:Revalidate span (optimistic scan revalidation after a version change).
"Enabled": false,
},
},
"RebalanceFallback": {
// Combined gate for the Data:Index:BTree:RebalanceFallback span (fallback to a pessimistic rebalance).
"Enabled": false,
},
"BulkInsert": {
// Combined gate for the Data:Index:BTree:BulkInsert span.
"Enabled": false,
},
"Root": {
// Combined gate for the Data:Index:BTree:Root span (root split/replace).
"Enabled": false,
},
"NodeCow": {
// Combined gate for the Data:Index:BTree:NodeCow span (copy-on-write of a B+Tree node).
"Enabled": false,
},
},
},
},
"Query": {
// Combined gate for the Query tracing subtree (parse/plan/execute spans).
"Enabled": false,
"Parse": {
// Combined gate for the Query:Parse subtree (query-string parsing spans).
"Enabled": false,
"DNF": {
// Combined gate for the Query:Parse:DNF span (disjunctive-normal-form conversion).
"Enabled": false,
},
},
"Plan": {
// Combined gate for the Query:Plan subtree (planning/optimization spans).
"Enabled": false,
"PrimarySelect": {
// Combined gate for the Query:Plan:PrimarySelect span (primary access-path selection).
"Enabled": false,
},
"Sort": {
// Combined gate for the Query:Plan:Sort span (sort planning).
"Enabled": false,
},
},
"Execute": {
// Combined gate for the Query:Execute subtree (execution spans).
"Enabled": false,
"IndexScan": {
// Combined gate for the Query:Execute:IndexScan span.
"Enabled": false,
},
"Iterate": {
// Combined gate for the Query:Execute:Iterate span (result iteration).
"Enabled": false,
},
"Filter": {
// Combined gate for the Query:Execute:Filter span (residual predicate filtering).
"Enabled": false,
},
"Pagination": {
// Combined gate for the Query:Execute:Pagination span (skip/take pagination).
"Enabled": false,
},
"StorageMode": {
// Combined gate for the Query:Execute:StorageMode span (per-storage-mode execution path).
"Enabled": false,
},
},
"Estimate": {
// Combined gate for the Query:Estimate span (cardinality/cost estimation).
"Enabled": false,
},
"Count": {
// Combined gate for the Query:Count span (count-only execution).
"Enabled": false,
},
},
"ECS": {
// Combined gate for the ECS tracing subtree (query-construction and view-maintenance spans).
"Enabled": false,
"Query": {
// Combined gate for the ECS:Query subtree (archetype-query construction spans).
"Enabled": false,
"Construct": {
// Combined gate for the ECS:Query:Construct span (query object construction).
"Enabled": false,
},
"MaskAnd": {
// Combined gate for the ECS:Query:MaskAnd span (component-mask AND intersection).
"Enabled": false,
},
"SubtreeExpand": {
// Combined gate for the ECS:Query:SubtreeExpand span (archetype-subtree expansion).
"Enabled": false,
},
"Constraint": {
"Enabled": {
// Combined gate for the ECS:Query:Constraint:Enabled span (enabled-constraint evaluation).
"Enabled": false,
},
},
"Spatial": {
"Attach": {
// Combined gate for the ECS:Query:Spatial:Attach span (attaching a spatial constraint to a query).
"Enabled": false,
},
},
},
"View": {
// Combined gate for the ECS:View subtree (materialized-view refresh spans).
"Enabled": false,
"RefreshPull": {
// Combined gate for the ECS:View:RefreshPull span (pull-based view refresh).
"Enabled": false,
},
"IncrementalDrain": {
// Combined gate for the ECS:View:IncrementalDrain span (draining buffered deltas into a view).
"Enabled": false,
},
"DeltaBuffer": {
"Overflow": {
// Combined gate for the ECS:View:DeltaBuffer:Overflow span (delta buffer overflowed, forcing a full refresh).
"Enabled": false,
},
},
"ProcessEntry": {
// Combined gate for the ECS:View:ProcessEntry span (processing one view entry).
"Enabled": false,
},
"ProcessEntryOr": {
// Combined gate for the ECS:View:ProcessEntryOr span (processing an OR-clause view entry).
"Enabled": false,
},
"RefreshFull": {
// Combined gate for the ECS:View:RefreshFull span (full view rebuild).
"Enabled": false,
},
"RefreshFullOr": {
// Combined gate for the ECS:View:RefreshFullOr span (full rebuild of an OR-clause view).
"Enabled": false,
},
"Registry": {
"Register": {
// Combined gate for the ECS:View:Registry:Register span (view registration).
"Enabled": false,
},
"Deregister": {
// Combined gate for the ECS:View:Registry:Deregister span (view deregistration).
"Enabled": false,
},
},
"DeltaCache": {
"Miss": {
// Combined gate for the ECS:View:DeltaCache:Miss span (delta-cache miss).
"Enabled": false,
},
},
},
},
"Durability": {
// Combined gate for the Durability tracing subtree (WAL, checkpoint, recovery, UoW spans).
"Enabled": false,
"WAL": {
// Combined gate for the Durability:WAL subtree (write-ahead-log spans).
"Enabled": false,
"QueueDrain": {
// Combined gate for the Durability:WAL:QueueDrain span (draining the commit queue to the WAL writer).
"Enabled": false,
},
"OsWrite": {
// Combined gate for the Durability:WAL:OsWrite span (OS write of a WAL buffer).
"Enabled": false,
},
"Signal": {
// Combined gate for the Durability:WAL:Signal span (post-flush signal to waiting committers).
"Enabled": false,
},
"GroupCommit": {
// Combined gate for the Durability:WAL:GroupCommit span (group-commit batch).
"Enabled": false,
},
"Queue": {
// Combined gate for the Durability:WAL:Queue span (commit-queue enqueue).
"Enabled": false,
},
"Buffer": {
// Combined gate for the Durability:WAL:Buffer span (WAL buffer fill/rotate).
"Enabled": false,
},
"Frame": {
// Combined gate for the Durability:WAL:Frame span (per-frame WAL encoding).
"Enabled": false,
},
"Backpressure": {
// Combined gate for the Durability:WAL:Backpressure span (commit throttled by WAL backpressure).
"Enabled": false,
},
},
"Checkpoint": {
// Combined gate for the Durability:Checkpoint subtree (checkpoint spans).
"Enabled": false,
"WriteBatch": {
// Combined gate for the Durability:Checkpoint:WriteBatch span (writing a batch of dirty pages).
"Enabled": false,
},
"Backpressure": {
// Combined gate for the Durability:Checkpoint:Backpressure span (checkpoint throttled by backpressure).
"Enabled": false,
},
"Sleep": {
// Combined gate for the Durability:Checkpoint:Sleep span (checkpoint pacing sleep).
"Enabled": false,
},
},
"Recovery": {
// Combined gate for the Durability:Recovery subtree (crash-recovery spans).
"Enabled": false,
"Start": {
// Combined gate for the Durability:Recovery:Start span (recovery session start).
"Enabled": false,
},
"Discover": {
// Combined gate for the Durability:Recovery:Discover span (discovering WAL segments to replay).
"Enabled": false,
},
"Segment": {
// Combined gate for the Durability:Recovery:Segment span (replaying one WAL segment).
"Enabled": false,
},
"Record": {
// Combined gate for the Durability:Recovery:Record span (applying one WAL record).
"Enabled": false,
},
"Redo": {
// Combined gate for the Durability:Recovery:Redo span (redo pass).
"Enabled": false,
},
"Undo": {
// Combined gate for the Durability:Recovery:Undo span (undo of uncommitted effects).
"Enabled": false,
},
"TickFence": {
// Combined gate for the Durability:Recovery:TickFence span (replaying a write-tick fence boundary).
"Enabled": false,
},
},
"UoW": {
// Combined gate for the Durability:UoW subtree (unit-of-work durability spans).
"Enabled": false,
"State": {
// Combined gate for the Durability:UoW:State span (unit-of-work state transition).
"Enabled": false,
},
"Deadline": {
// Combined gate for the Durability:UoW:Deadline span (unit-of-work deadline check).
"Enabled": false,
},
},
},
},
},
}
All flags
Profiler (top level)
| Config key |
Default |
Enables |
Typhon:Profiler:Enabled |
false |
Global profiler enable/disable. When false, all profiler-emitted telemetry is disabled regardless of individual component settings. |
GcTracing
| Config key |
Default |
Enables |
Typhon:Profiler:GcTracing:Enabled |
false |
Whether opt-in .NET runtime GC-event tracing is requested by configuration. |
MemoryAllocations
| Config key |
Default |
Enables |
Typhon:Profiler:MemoryAllocations:Enabled |
false |
Whether opt-in per-allocation tracking is requested by configuration. |
CpuSampling
| Config key |
Default |
Enables |
Typhon:Profiler:CpuSampling:Enabled |
false |
Whether opt-in in-process CPU stack sampling is requested by configuration. |
Gauges
| Config key |
Default |
Enables |
Typhon:Profiler:Gauges:Enabled |
false |
Whether opt-in per-tick gauge snapshots are requested by configuration. |
Scheduler
| Config key |
Default |
Enables |
Typhon:Profiler:Scheduler:Enabled |
false |
Whether Scheduler component telemetry is enabled in configuration. |
Typhon:Profiler:Scheduler:Gauges:TransitionLatency:Enabled |
true |
Whether to track per-system transition latency. |
Typhon:Profiler:Scheduler:Gauges:WorkerUtilization:Enabled |
true |
Whether to track per-worker active/idle time breakdown. |
Typhon:Profiler:Scheduler:Gauges:StragglerGap:Enabled |
true |
Whether to track straggler gap (parallel efficiency metric for Patate systems). |
Typhon:Profiler:Scheduler:ArchetypeTouches:Enabled |
true |
Whether to capture per-(system, archetype) entity-touch counts at parallel-query completion (Workbench Data Flow module). Default true. JIT dead-code-eliminates the capture path when false. |
Typhon:Profiler:Scheduler:System:Enabled |
false |
Combined gate for the Scheduler:System subtree (per-system execution/queue-wait spans). |
Typhon:Profiler:Scheduler:System:StartExecution:Enabled |
false |
Combined gate for the Scheduler:System:StartExecution span. |
Typhon:Profiler:Scheduler:System:Completion:Enabled |
false |
Combined gate for the Scheduler:System:Completion span. |
Typhon:Profiler:Scheduler:System:QueueWait:Enabled |
false |
Combined gate for the Scheduler:System:QueueWait span (time a system waited in its queue before running). |
Typhon:Profiler:Scheduler:System:SingleThreaded:Enabled |
false |
Combined gate for the Scheduler:System:SingleThreaded span. |
Typhon:Profiler:Scheduler:Worker:Enabled |
false |
Combined gate for the Scheduler:Worker subtree (worker idle/wake spans). |
Typhon:Profiler:Scheduler:Worker:Idle:Enabled |
false |
Combined gate for the Scheduler:Worker:Idle span. |
Typhon:Profiler:Scheduler:Worker:Wake:Enabled |
false |
Combined gate for the Scheduler:Worker:Wake span. |
Typhon:Profiler:Scheduler:Worker:BetweenTick:Enabled |
false |
Combined gate for the Scheduler:Worker:BetweenTick span (worker gap between ticks). |
Typhon:Profiler:Scheduler:Dispense:Enabled |
false |
Combined gate for the Scheduler:Dispense span (work-item dispense to workers). |
Typhon:Profiler:Scheduler:Dependency:Enabled |
false |
Combined gate for the Scheduler:Dependency subtree (dependency-ready/fan-out spans). |
Typhon:Profiler:Scheduler:Dependency:Ready:Enabled |
false |
Combined gate for the Scheduler:Dependency:Ready span (a system's dependencies became satisfied). |
Typhon:Profiler:Scheduler:Dependency:FanOut:Enabled |
false |
Combined gate for the Scheduler:Dependency:FanOut span. |
Typhon:Profiler:Scheduler:Overload:Enabled |
false |
Combined gate for the Scheduler:Overload subtree (overload level-change/shed spans). |
Typhon:Profiler:Scheduler:Overload:LevelChange:Enabled |
false |
Combined gate for the Scheduler:Overload:LevelChange span. |
Typhon:Profiler:Scheduler:Overload:SystemShed:Enabled |
false |
Combined gate for the Scheduler:Overload:SystemShed span (a system shed under overload). |
Typhon:Profiler:Scheduler:Overload:TickMultiplier:Enabled |
false |
Combined gate for the Scheduler:Overload:TickMultiplier span. |
Typhon:Profiler:Scheduler:Overload:Detector:Enabled |
false |
Combined flag for the per-tick OverloadDetector gauge snapshot (overrunRatio, consecutive counters, level, multiplier). |
Typhon:Profiler:Scheduler:Graph:Enabled |
false |
Combined gate for the Scheduler:Graph subtree (DAG build/rebuild spans). |
Typhon:Profiler:Scheduler:Graph:Build:Enabled |
false |
Combined gate for the Scheduler:Graph:Build span (initial DAG build). |
Typhon:Profiler:Scheduler:Graph:Rebuild:Enabled |
false |
Combined gate for the Scheduler:Graph:Rebuild span (DAG rebuild after a schema/system change). |
Typhon:Profiler:Scheduler:Metronome:Enabled |
false |
Combined gate for the Scheduler:Metronome subtree. |
Typhon:Profiler:Scheduler:Metronome:Wait:Enabled |
false |
Combined flag for the SchedulerMetronomeWait span (kind 241). |
Typhon:Profiler:Scheduler:Queue:Enabled |
false |
Combined gate for the Scheduler:Queue subtree. |
Typhon:Profiler:Scheduler:Queue:TickEnd:Enabled |
false |
Combined flag for the QueueTickEnd instant (kind 244). Per-(tick, queue) rollup emitted at end-of-tick; drives the Workbench Data API queue/<name> tracks (#311 / DAG view backpressure edges). |
Concurrency
| Config key |
Default |
Enables |
Typhon:Profiler:Concurrency:Enabled |
false |
Combined Concurrency root gate: master Enabled AND Typhon:Profiler:Concurrency:Enabled. |
Typhon:Profiler:Concurrency:AccessControl:Enabled |
false |
Combined gate for the AccessControl subtree. |
Typhon:Profiler:Concurrency:AccessControl:SharedAcquire:Enabled |
false |
Combined gate for AccessControl shared-acquire events. |
Typhon:Profiler:Concurrency:AccessControl:SharedRelease:Enabled |
false |
Combined gate for AccessControl shared-release events. |
Typhon:Profiler:Concurrency:AccessControl:ExclusiveAcquire:Enabled |
false |
Combined gate for AccessControl exclusive-acquire events. |
Typhon:Profiler:Concurrency:AccessControl:ExclusiveRelease:Enabled |
false |
Combined gate for AccessControl exclusive-release events. |
Typhon:Profiler:Concurrency:AccessControl:Promotion:Enabled |
false |
Combined gate for AccessControl shared↔exclusive promotion/demotion events. |
Typhon:Profiler:Concurrency:AccessControl:Contention:Enabled |
false |
Combined gate for AccessControl contention markers. |
Typhon:Profiler:Concurrency:AccessControlSmall:Enabled |
false |
Combined gate for the AccessControlSmall subtree. |
Typhon:Profiler:Concurrency:AccessControlSmall:SharedAcquire:Enabled |
false |
Combined gate for AccessControlSmall shared-acquire events. |
Typhon:Profiler:Concurrency:AccessControlSmall:SharedRelease:Enabled |
false |
Combined gate for AccessControlSmall shared-release events. |
Typhon:Profiler:Concurrency:AccessControlSmall:ExclusiveAcquire:Enabled |
false |
Combined gate for AccessControlSmall exclusive-acquire events. |
Typhon:Profiler:Concurrency:AccessControlSmall:ExclusiveRelease:Enabled |
false |
Combined gate for AccessControlSmall exclusive-release events. |
Typhon:Profiler:Concurrency:AccessControlSmall:Contention:Enabled |
false |
Combined gate for AccessControlSmall contention markers. |
Typhon:Profiler:Concurrency:ResourceAccessControl:Enabled |
false |
Combined gate for the ResourceAccessControl subtree. |
Typhon:Profiler:Concurrency:ResourceAccessControl:Accessing:Enabled |
false |
Combined gate for ResourceAccessControl Accessing-mode acquire events. |
Typhon:Profiler:Concurrency:ResourceAccessControl:Modify:Enabled |
false |
Combined gate for ResourceAccessControl Modify-mode acquire events. |
Typhon:Profiler:Concurrency:ResourceAccessControl:Destroy:Enabled |
false |
Combined gate for ResourceAccessControl Destroy-mode acquire events. |
Typhon:Profiler:Concurrency:ResourceAccessControl:ModifyPromotion:Enabled |
false |
Combined gate for ResourceAccessControl Modify-promotion slow-path events. |
Typhon:Profiler:Concurrency:ResourceAccessControl:Contention:Enabled |
false |
Combined gate for ResourceAccessControl contention markers. |
Typhon:Profiler:Concurrency:Epoch:Enabled |
false |
Combined gate for the Epoch subtree. |
Typhon:Profiler:Concurrency:Epoch:ScopeEnter:Enabled |
false |
Combined gate for EpochGuard Enter (PinCurrentThread) events. |
Typhon:Profiler:Concurrency:Epoch:ScopeExit:Enabled |
false |
Combined gate for EpochGuard Dispose events. |
Typhon:Profiler:Concurrency:Epoch:Advance:Enabled |
false |
Combined gate for GlobalEpoch advance events. |
Typhon:Profiler:Concurrency:Epoch:Refresh:Enabled |
false |
Combined gate for RefreshScope events. |
Typhon:Profiler:Concurrency:Epoch:SlotClaim:Enabled |
false |
Combined gate for EpochThreadRegistry slot-claim events. |
Typhon:Profiler:Concurrency:Epoch:SlotReclaim:Enabled |
false |
Combined gate for EpochThreadRegistry dead-thread slot-reclaim events. |
Typhon:Profiler:Concurrency:AdaptiveWaiter:Enabled |
false |
Combined gate for the AdaptiveWaiter subtree. |
Typhon:Profiler:Concurrency:AdaptiveWaiter:YieldOrSleep:Enabled |
false |
Combined gate for AdaptiveWaiter yield-or-sleep transition events. Phase 2 design (#280) chose transitions only — NOT per-spin — to keep trace volume sane. |
Typhon:Profiler:Concurrency:OlcLatch:Enabled |
false |
Combined gate for the OlcLatch subtree. |
Typhon:Profiler:Concurrency:OlcLatch:WriteLockAttempt:Enabled |
false |
Combined gate for OlcLatch TryWriteLock-failure events. |
Typhon:Profiler:Concurrency:OlcLatch:WriteUnlock:Enabled |
false |
Combined gate for OlcLatch WriteUnlock events. |
Typhon:Profiler:Concurrency:OlcLatch:MarkObsolete:Enabled |
false |
Combined gate for OlcLatch MarkObsolete events. |
Typhon:Profiler:Concurrency:OlcLatch:ValidationFail:Enabled |
false |
Combined gate for OlcLatch ValidateVersion-failure events. |
Spatial
| Config key |
Default |
Enables |
Typhon:Profiler:Spatial:Enabled |
false |
Combined gate for the entire Spatial subsystem (parent of all Spatial:* leaves). |
Typhon:Profiler:Spatial:Query:Enabled |
false |
Combined gate for the Spatial:Query subtree (AABB/radius/ray/frustum/kNN/count query spans). |
Typhon:Profiler:Spatial:Query:Aabb:Enabled |
false |
Combined gate for the Spatial:Query:Aabb span (axis-aligned bounding-box overlap query). |
Typhon:Profiler:Spatial:Query:Radius:Enabled |
false |
Combined gate for the Spatial:Query:Radius span (radius/sphere overlap query). |
Typhon:Profiler:Spatial:Query:Ray:Enabled |
false |
Combined gate for the Spatial:Query:Ray span (ray-cast query). |
Typhon:Profiler:Spatial:Query:Frustum:Enabled |
false |
Combined gate for the Spatial:Query:Frustum span (frustum-culling query). |
Typhon:Profiler:Spatial:Query:Knn:Enabled |
false |
Combined gate for the Spatial:Query:Knn span (k-nearest-neighbour query). |
Typhon:Profiler:Spatial:Query:Count:Enabled |
false |
Combined gate for the Spatial:Query:Count span (count-only spatial query). |
Typhon:Profiler:Spatial:RTree:Enabled |
false |
Combined gate for the Spatial:RTree subtree (R-tree structural mutation spans). |
Typhon:Profiler:Spatial:RTree:Insert:Enabled |
false |
Combined gate for the Spatial:RTree:Insert span. |
Typhon:Profiler:Spatial:RTree:Remove:Enabled |
false |
Combined gate for the Spatial:RTree:Remove span. |
Typhon:Profiler:Spatial:RTree:NodeSplit:Enabled |
false |
Combined gate for the Spatial:RTree:NodeSplit span. |
Typhon:Profiler:Spatial:RTree:BulkLoad:Enabled |
false |
Combined gate for the Spatial:RTree:BulkLoad span (bulk STR-pack load). |
Typhon:Profiler:Spatial:Grid:Enabled |
false |
Combined gate for the Spatial:Grid subtree (uniform-grid cell tier/occupancy spans). |
Typhon:Profiler:Spatial:Grid:CellTierChange:Enabled |
false |
Combined gate for the Spatial:Grid:CellTierChange span (cell promoted/demoted between density tiers). |
Typhon:Profiler:Spatial:Grid:OccupancyChange:Enabled |
false |
Combined gate for the Spatial:Grid:OccupancyChange span. |
Typhon:Profiler:Spatial:Grid:ClusterCellAssign:Enabled |
false |
Combined gate for the Spatial:Grid:ClusterCellAssign span (cluster assigned to a grid cell). |
Typhon:Profiler:Spatial:Cell:Enabled |
false |
Combined gate for the Spatial:Cell subtree. |
Typhon:Profiler:Spatial:Cell:Index:Enabled |
false |
Combined gate for the Spatial:Cell:Index subtree (per-cell occupant index add/update/remove spans). |
Typhon:Profiler:Spatial:Cell:Index:Add:Enabled |
false |
Combined gate for the Spatial:Cell:Index:Add span. |
Typhon:Profiler:Spatial:Cell:Index:Update:Enabled |
false |
Combined gate for the Spatial:Cell:Index:Update span. |
Typhon:Profiler:Spatial:Cell:Index:Remove:Enabled |
false |
Combined gate for the Spatial:Cell:Index:Remove span. |
Typhon:Profiler:Spatial:ClusterMigration:Enabled |
false |
Combined gate for the Spatial:ClusterMigration subtree (cross-cell cluster migration spans). |
Typhon:Profiler:Spatial:ClusterMigration:Detect:Enabled |
false |
Combined gate for the Spatial:ClusterMigration:Detect span (migration-needed detection). |
Typhon:Profiler:Spatial:ClusterMigration:Queue:Enabled |
false |
Combined gate for the Spatial:ClusterMigration:Queue span (migration enqueue). |
Typhon:Profiler:Spatial:ClusterMigration:Execute:Enabled |
false |
Combined gate for the Spatial:ClusterMigration:Execute span (migration apply; legacy kind 60, on by default). |
Typhon:Profiler:Spatial:ClusterMigration:Hysteresis:Enabled |
false |
Combined gate for the Spatial:ClusterMigration:Hysteresis span (hysteresis suppression of a migration). |
Typhon:Profiler:Spatial:TierIndex:Enabled |
false |
Combined gate for the Spatial:TierIndex subtree (tier-index rebuild spans). |
Typhon:Profiler:Spatial:TierIndex:Rebuild:Enabled |
false |
Combined gate for the Spatial:TierIndex:Rebuild span. |
Typhon:Profiler:Spatial:TierIndex:VersionSkip:Enabled |
false |
Combined gate for the Spatial:TierIndex:VersionSkip span (rebuild skipped because the version was unchanged). |
Typhon:Profiler:Spatial:Maintain:Enabled |
false |
Combined gate for the Spatial:Maintain subtree (index-maintenance spans on entity insert/update). |
Typhon:Profiler:Spatial:Maintain:Insert:Enabled |
false |
Combined gate for the Spatial:Maintain:Insert span. |
Typhon:Profiler:Spatial:Maintain:UpdateSlowPath:Enabled |
false |
Combined gate for the Spatial:Maintain:UpdateSlowPath span. |
Typhon:Profiler:Spatial:Maintain:AabbValidate:Enabled |
false |
Combined gate for the Spatial:Maintain:AabbValidate span. |
Typhon:Profiler:Spatial:Maintain:BackPointerWrite:Enabled |
false |
Combined gate for the Spatial:Maintain:BackPointerWrite span. |
Typhon:Profiler:Spatial:Trigger:Enabled |
false |
Combined gate for the Spatial:Trigger subtree (spatial-trigger region/eval spans). |
Typhon:Profiler:Spatial:Trigger:Occupant:Enabled |
false |
Combined gate for the Spatial:Trigger:Occupant subtree. |
Typhon:Profiler:Spatial:Trigger:Occupant:Diff:Enabled |
false |
Combined gate for the Spatial:Trigger:Occupant:Diff span (enter/exit occupant diff). |
Typhon:Profiler:Spatial:Trigger:Cache:Enabled |
false |
Combined gate for the Spatial:Trigger:Cache subtree. |
Typhon:Profiler:Spatial:Trigger:Cache:Invalidate:Enabled |
false |
Combined gate for the Spatial:Trigger:Cache:Invalidate span. |
Typhon:Profiler:Spatial:Trigger:Region:Enabled |
false |
Combined gate for the Spatial:Trigger:Region span. |
Typhon:Profiler:Spatial:Trigger:Eval:Enabled |
false |
Combined gate for the Spatial:Trigger:Eval span (trigger-region evaluation). |
Runtime
| Config key |
Default |
Enables |
Typhon:Profiler:Runtime:Enabled |
false |
Combined gate for the Runtime tracing subtree (UoW phase, transaction lifecycle, subscription spans). |
Typhon:Profiler:Runtime:Phase:Enabled |
false |
Combined gate for the Runtime:Phase subtree (unit-of-work create/flush spans). |
Typhon:Profiler:Runtime:Phase:UoWCreate:Enabled |
false |
Combined gate for the Runtime:Phase:UoWCreate span (unit-of-work creation). |
Typhon:Profiler:Runtime:Phase:UoWFlush:Enabled |
false |
Combined gate for the Runtime:Phase:UoWFlush span (unit-of-work flush). |
Typhon:Profiler:Runtime:Transaction:Enabled |
false |
Combined gate for the Runtime:Transaction subtree (transaction lifecycle spans). |
Typhon:Profiler:Runtime:Transaction:Lifecycle:Enabled |
false |
Combined gate for the Runtime:Transaction:Lifecycle span. |
Typhon:Profiler:Runtime:Subscription:Enabled |
false |
Combined gate for the Runtime:Subscription subtree (change-subscription delivery spans). |
Typhon:Profiler:Runtime:Subscription:Output:Enabled |
false |
Combined gate for the Runtime:Subscription:Output subtree (subscriber output execute/cleanup spans). |
Typhon:Profiler:Runtime:Subscription:Output:Execute:Enabled |
false |
Combined gate for the Runtime:Subscription:Output:Execute span (running a subscriber's output callback). |
Typhon:Profiler:Runtime:Subscription:Output:Cleanup:Enabled |
false |
Combined gate for the Runtime:Subscription:Output:Cleanup span. |
Typhon:Profiler:Runtime:Subscription:Subscriber:Enabled |
false |
Combined gate for the Runtime:Subscription:Subscriber span (per-subscriber delivery). |
Typhon:Profiler:Runtime:Subscription:Delta:Build:Enabled |
false |
Combined gate for the Runtime:Subscription:Delta:Build span (building a change delta). |
Typhon:Profiler:Runtime:Subscription:Delta:Serialize:Enabled |
false |
Combined gate for the Runtime:Subscription:Delta:Serialize span (serializing a change delta). |
Typhon:Profiler:Runtime:Subscription:Delta:DirtyBitmapSupplement:Enabled |
false |
Combined gate for the Runtime:Subscription:Delta:DirtyBitmapSupplement span. |
Typhon:Profiler:Runtime:Subscription:Transition:BeginSync:Enabled |
false |
Combined gate for the Runtime:Subscription:Transition:BeginSync span. |
Typhon:Profiler:Runtime:WriteTickFence:Enabled |
false |
Combined gate for the Runtime:WriteTickFence subtree (per-table and per-archetype cluster write-fence spans). |
Typhon:Profiler:Runtime:WriteTickFence:Table:Enabled |
false |
Combined gate for the Runtime:WriteTickFence:Table span (per-table fence cost). |
Typhon:Profiler:Runtime:WriteTickFence:Shadow:Enabled |
false |
Combined gate for the Runtime:WriteTickFence:Shadow span (shadow-copy portion of a table fence). |
Typhon:Profiler:Runtime:WriteTickFence:Spatial:Enabled |
false |
Combined gate for the Runtime:WriteTickFence:Spatial span (spatial-index portion of a table fence). |
Typhon:Profiler:Runtime:WriteTickFence:Cluster:Enabled |
false |
Combined gate for the Runtime:WriteTickFence:Cluster span (per-archetype cluster fence cost). |
Typhon:Profiler:Runtime:WriteTickFence:Cluster:Shadow:Enabled |
false |
Combined gate for the Runtime:WriteTickFence:Cluster:Shadow span. |
Typhon:Profiler:Runtime:WriteTickFence:Cluster:Spatial:Enabled |
false |
Combined gate for the Runtime:WriteTickFence:Cluster:Spatial span. |
Typhon:Profiler:Runtime:ThreadScheduling:Enabled |
false |
Whether OS thread scheduling tracing is requested by configuration. When enabled (Windows-only), EtwSchedulingPump opens the NT Kernel Logger and emits one ThreadContextSwitch record per on-CPU slice for every Typhon-registered OS thread. Records carry duration + wait reason so the Workbench can render off-CPU gaps with their cause overlaid on the affected thread's lane. |
Storage
| Config key |
Default |
Enables |
Typhon:Profiler:Storage:Enabled |
false |
Combined gate for the Storage tracing subtree (page-cache, segment, file-handle, occupancy-map spans). |
Typhon:Profiler:Storage:PageCache:Enabled |
false |
Combined gate for the Storage:PageCache subtree. |
Typhon:Profiler:Storage:PageCache:DirtyWalk:Enabled |
false |
Combined gate for the Storage:PageCache:DirtyWalk span (walk of dirty pages during checkpoint). |
Typhon:Profiler:Storage:Segment:Enabled |
false |
Combined gate for the Storage:Segment subtree (segment create/grow/load spans). |
Typhon:Profiler:Storage:Segment:Create:Enabled |
false |
Combined gate for the Storage:Segment:Create span. |
Typhon:Profiler:Storage:Segment:Grow:Enabled |
false |
Combined gate for the Storage:Segment:Grow span. |
Typhon:Profiler:Storage:Segment:Load:Enabled |
false |
Combined gate for the Storage:Segment:Load span. |
Typhon:Profiler:Storage:ChunkSegment:Enabled |
false |
Combined gate for the Storage:ChunkSegment subtree. |
Typhon:Profiler:Storage:ChunkSegment:Grow:Enabled |
false |
Combined gate for the Storage:ChunkSegment:Grow span. |
Typhon:Profiler:Storage:FileHandle:Enabled |
false |
Combined gate for the Storage:FileHandle span (OS file-handle lifecycle). |
Typhon:Profiler:Storage:OccupancyMap:Enabled |
false |
Combined gate for the Storage:OccupancyMap subtree. |
Typhon:Profiler:Storage:OccupancyMap:Grow:Enabled |
false |
Combined gate for the Storage:OccupancyMap:Grow span. |
Memory
| Config key |
Default |
Enables |
Typhon:Profiler:Memory:Enabled |
false |
Combined gate for the Memory tracing subtree. |
Typhon:Profiler:Memory:AlignmentWaste:Enabled |
false |
Combined gate for the Memory:AlignmentWaste span (bytes lost to alignment padding on an allocation). |
Data
| Config key |
Default |
Enables |
Typhon:Profiler:Data:Enabled |
false |
Combined gate for the Data-plane tracing subtree (transaction, MVCC, B+Tree index spans). |
Typhon:Profiler:Data:Transaction:Enabled |
false |
Combined gate for the Data:Transaction subtree (init/prepare/validate/conflict/cleanup spans). |
Typhon:Profiler:Data:Transaction:Init:Enabled |
false |
Combined gate for the Data:Transaction:Init span. |
Typhon:Profiler:Data:Transaction:Prepare:Enabled |
false |
Combined gate for the Data:Transaction:Prepare span. |
Typhon:Profiler:Data:Transaction:Validate:Enabled |
false |
Combined gate for the Data:Transaction:Validate span (commit-time conflict validation). |
Typhon:Profiler:Data:Transaction:Conflict:Enabled |
false |
Combined gate for the Data:Transaction:Conflict span (write-write conflict detected). |
Typhon:Profiler:Data:Transaction:Cleanup:Enabled |
false |
Combined gate for the Data:Transaction:Cleanup span. |
Typhon:Profiler:Data:MVCC:Enabled |
false |
Combined gate for the Data:MVCC subtree (version chain-walk and cleanup spans). |
Typhon:Profiler:Data:MVCC:ChainWalk:Enabled |
false |
Combined gate for the Data:MVCC:ChainWalk span (walking a version chain to the visible revision). |
Typhon:Profiler:Data:MVCC:VersionCleanup:Enabled |
false |
Combined gate for the Data:MVCC:VersionCleanup span (reclaiming obsolete versions). |
Typhon:Profiler:Data:Index:Enabled |
false |
Combined gate for the Data:Index subtree. |
Typhon:Profiler:Data:Index:BTree:Enabled |
false |
Combined gate for the Data:Index:BTree subtree (B+Tree search/scan/mutation spans). |
Typhon:Profiler:Data:Index:BTree:Search:Enabled |
false |
Combined gate for the Data:Index:BTree:Search span (point lookup). |
Typhon:Profiler:Data:Index:BTree:RangeScan:Enabled |
false |
Combined gate for the Data:Index:BTree:RangeScan span. |
Typhon:Profiler:Data:Index:BTree:RangeScan:Revalidate:Enabled |
false |
Combined gate for the Data:Index:BTree:RangeScan:Revalidate span (optimistic scan revalidation after a version change). |
Typhon:Profiler:Data:Index:BTree:RebalanceFallback:Enabled |
false |
Combined gate for the Data:Index:BTree:RebalanceFallback span (fallback to a pessimistic rebalance). |
Typhon:Profiler:Data:Index:BTree:BulkInsert:Enabled |
false |
Combined gate for the Data:Index:BTree:BulkInsert span. |
Typhon:Profiler:Data:Index:BTree:Root:Enabled |
false |
Combined gate for the Data:Index:BTree:Root span (root split/replace). |
Typhon:Profiler:Data:Index:BTree:NodeCow:Enabled |
false |
Combined gate for the Data:Index:BTree:NodeCow span (copy-on-write of a B+Tree node). |
Query
| Config key |
Default |
Enables |
Typhon:Profiler:Query:Enabled |
false |
Combined gate for the Query tracing subtree (parse/plan/execute spans). |
Typhon:Profiler:Query:Parse:Enabled |
false |
Combined gate for the Query:Parse subtree (query-string parsing spans). |
Typhon:Profiler:Query:Parse:DNF:Enabled |
false |
Combined gate for the Query:Parse:DNF span (disjunctive-normal-form conversion). |
Typhon:Profiler:Query:Plan:Enabled |
false |
Combined gate for the Query:Plan subtree (planning/optimization spans). |
Typhon:Profiler:Query:Plan:PrimarySelect:Enabled |
false |
Combined gate for the Query:Plan:PrimarySelect span (primary access-path selection). |
Typhon:Profiler:Query:Plan:Sort:Enabled |
false |
Combined gate for the Query:Plan:Sort span (sort planning). |
Typhon:Profiler:Query:Execute:Enabled |
false |
Combined gate for the Query:Execute subtree (execution spans). |
Typhon:Profiler:Query:Execute:IndexScan:Enabled |
false |
Combined gate for the Query:Execute:IndexScan span. |
Typhon:Profiler:Query:Execute:Iterate:Enabled |
false |
Combined gate for the Query:Execute:Iterate span (result iteration). |
Typhon:Profiler:Query:Execute:Filter:Enabled |
false |
Combined gate for the Query:Execute:Filter span (residual predicate filtering). |
Typhon:Profiler:Query:Execute:Pagination:Enabled |
false |
Combined gate for the Query:Execute:Pagination span (skip/take pagination). |
Typhon:Profiler:Query:Execute:StorageMode:Enabled |
false |
Combined gate for the Query:Execute:StorageMode span (per-storage-mode execution path). |
Typhon:Profiler:Query:Estimate:Enabled |
false |
Combined gate for the Query:Estimate span (cardinality/cost estimation). |
Typhon:Profiler:Query:Count:Enabled |
false |
Combined gate for the Query:Count span (count-only execution). |
ECS
| Config key |
Default |
Enables |
Typhon:Profiler:ECS:Enabled |
false |
Combined gate for the ECS tracing subtree (query-construction and view-maintenance spans). |
Typhon:Profiler:ECS:Query:Enabled |
false |
Combined gate for the ECS:Query subtree (archetype-query construction spans). |
Typhon:Profiler:ECS:Query:Construct:Enabled |
false |
Combined gate for the ECS:Query:Construct span (query object construction). |
Typhon:Profiler:ECS:Query:MaskAnd:Enabled |
false |
Combined gate for the ECS:Query:MaskAnd span (component-mask AND intersection). |
Typhon:Profiler:ECS:Query:SubtreeExpand:Enabled |
false |
Combined gate for the ECS:Query:SubtreeExpand span (archetype-subtree expansion). |
Typhon:Profiler:ECS:Query:Constraint:Enabled:Enabled |
false |
Combined gate for the ECS:Query:Constraint:Enabled span (enabled-constraint evaluation). |
Typhon:Profiler:ECS:Query:Spatial:Attach:Enabled |
false |
Combined gate for the ECS:Query:Spatial:Attach span (attaching a spatial constraint to a query). |
Typhon:Profiler:ECS:View:Enabled |
false |
Combined gate for the ECS:View subtree (materialized-view refresh spans). |
Typhon:Profiler:ECS:View:RefreshPull:Enabled |
false |
Combined gate for the ECS:View:RefreshPull span (pull-based view refresh). |
Typhon:Profiler:ECS:View:IncrementalDrain:Enabled |
false |
Combined gate for the ECS:View:IncrementalDrain span (draining buffered deltas into a view). |
Typhon:Profiler:ECS:View:DeltaBuffer:Overflow:Enabled |
false |
Combined gate for the ECS:View:DeltaBuffer:Overflow span (delta buffer overflowed, forcing a full refresh). |
Typhon:Profiler:ECS:View:ProcessEntry:Enabled |
false |
Combined gate for the ECS:View:ProcessEntry span (processing one view entry). |
Typhon:Profiler:ECS:View:ProcessEntryOr:Enabled |
false |
Combined gate for the ECS:View:ProcessEntryOr span (processing an OR-clause view entry). |
Typhon:Profiler:ECS:View:RefreshFull:Enabled |
false |
Combined gate for the ECS:View:RefreshFull span (full view rebuild). |
Typhon:Profiler:ECS:View:RefreshFullOr:Enabled |
false |
Combined gate for the ECS:View:RefreshFullOr span (full rebuild of an OR-clause view). |
Typhon:Profiler:ECS:View:Registry:Register:Enabled |
false |
Combined gate for the ECS:View:Registry:Register span (view registration). |
Typhon:Profiler:ECS:View:Registry:Deregister:Enabled |
false |
Combined gate for the ECS:View:Registry:Deregister span (view deregistration). |
Typhon:Profiler:ECS:View:DeltaCache:Miss:Enabled |
false |
Combined gate for the ECS:View:DeltaCache:Miss span (delta-cache miss). |
Durability
| Config key |
Default |
Enables |
Typhon:Profiler:Durability:Enabled |
false |
Combined gate for the Durability tracing subtree (WAL, checkpoint, recovery, UoW spans). |
Typhon:Profiler:Durability:WAL:Enabled |
false |
Combined gate for the Durability:WAL subtree (write-ahead-log spans). |
Typhon:Profiler:Durability:WAL:QueueDrain:Enabled |
false |
Combined gate for the Durability:WAL:QueueDrain span (draining the commit queue to the WAL writer). |
Typhon:Profiler:Durability:WAL:OsWrite:Enabled |
false |
Combined gate for the Durability:WAL:OsWrite span (OS write of a WAL buffer). |
Typhon:Profiler:Durability:WAL:Signal:Enabled |
false |
Combined gate for the Durability:WAL:Signal span (post-flush signal to waiting committers). |
Typhon:Profiler:Durability:WAL:GroupCommit:Enabled |
false |
Combined gate for the Durability:WAL:GroupCommit span (group-commit batch). |
Typhon:Profiler:Durability:WAL:Queue:Enabled |
false |
Combined gate for the Durability:WAL:Queue span (commit-queue enqueue). |
Typhon:Profiler:Durability:WAL:Buffer:Enabled |
false |
Combined gate for the Durability:WAL:Buffer span (WAL buffer fill/rotate). |
Typhon:Profiler:Durability:WAL:Frame:Enabled |
false |
Combined gate for the Durability:WAL:Frame span (per-frame WAL encoding). |
Typhon:Profiler:Durability:WAL:Backpressure:Enabled |
false |
Combined gate for the Durability:WAL:Backpressure span (commit throttled by WAL backpressure). |
Typhon:Profiler:Durability:Checkpoint:Enabled |
false |
Combined gate for the Durability:Checkpoint subtree (checkpoint spans). |
Typhon:Profiler:Durability:Checkpoint:WriteBatch:Enabled |
false |
Combined gate for the Durability:Checkpoint:WriteBatch span (writing a batch of dirty pages). |
Typhon:Profiler:Durability:Checkpoint:Backpressure:Enabled |
false |
Combined gate for the Durability:Checkpoint:Backpressure span (checkpoint throttled by backpressure). |
Typhon:Profiler:Durability:Checkpoint:Sleep:Enabled |
false |
Combined gate for the Durability:Checkpoint:Sleep span (checkpoint pacing sleep). |
Typhon:Profiler:Durability:Recovery:Enabled |
false |
Combined gate for the Durability:Recovery subtree (crash-recovery spans). |
Typhon:Profiler:Durability:Recovery:Start:Enabled |
false |
Combined gate for the Durability:Recovery:Start span (recovery session start). |
Typhon:Profiler:Durability:Recovery:Discover:Enabled |
false |
Combined gate for the Durability:Recovery:Discover span (discovering WAL segments to replay). |
Typhon:Profiler:Durability:Recovery:Segment:Enabled |
false |
Combined gate for the Durability:Recovery:Segment span (replaying one WAL segment). |
Typhon:Profiler:Durability:Recovery:Record:Enabled |
false |
Combined gate for the Durability:Recovery:Record span (applying one WAL record). |
Typhon:Profiler:Durability:Recovery:Redo:Enabled |
false |
Combined gate for the Durability:Recovery:Redo span (redo pass). |
Typhon:Profiler:Durability:Recovery:Undo:Enabled |
false |
Combined gate for the Durability:Recovery:Undo span (undo of uncommitted effects). |
Typhon:Profiler:Durability:Recovery:TickFence:Enabled |
false |
Combined gate for the Durability:Recovery:TickFence span (replaying a write-tick fence boundary). |
Typhon:Profiler:Durability:UoW:Enabled |
false |
Combined gate for the Durability:UoW subtree (unit-of-work durability spans). |
Typhon:Profiler:Durability:UoW:State:Enabled |
false |
Combined gate for the Durability:UoW:State span (unit-of-work state transition). |
Typhon:Profiler:Durability:UoW:Deadline:Enabled |
false |
Combined gate for the Durability:UoW:Deadline span (unit-of-work deadline check). |