Class TelemetryConfig

Namespace

Typhon.Engine

Assembly

Typhon.Engine.dll

Global telemetry configuration for Typhon Engine.

This class provides static readonly fields that allow the JIT compiler to eliminate disabled telemetry code paths entirely. When a readonly field is false, the JIT can treat if (TelemetryConfig.ProfilerActive) as dead code and remove it completely in Tier 1 compilation.

Source of truth: every gate flag (the *Active / *Enabled fields) and the static constructor that resolves them are GENERATED from Observability/telemetry-flags.jsonc by Typhon.Generators.Telemetry.TelemetryConfigGenerator (see the generated partial in TelemetryConfig.g.cs). This file holds only the non-gate fields, the config-reading helpers, and the diagnostics. Add or change a flag by editing the catalog, not this file.

IMPORTANT: Call EnsureInitialized() once at application startup, BEFORE any hot paths are JIT compiled. This ensures the static constructor runs early and the JIT sees the final values when compiling performance-critical methods.

Configuration precedence (highest to lowest):

1. Environment variables (TYPHON__PROFILER__ENABLED, etc.)
2. typhon.telemetry.json in current directory
3. typhon.telemetry.json next to the assembly
4. Built-in defaults (all disabled)

public static class TelemetryConfig

Inheritance

object

TelemetryConfig

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Remarks

Environment variable naming uses double underscore (__) as hierarchy separator for cross-platform compatibility:

TYPHON__PROFILER__ENABLED=true
TYPHON__PROFILER__GCTRACING__ENABLED=true
TYPHON__PROFILER__SCHEDULER__GAUGES__STRAGGLERGAP__ENABLED=true

Fields

ConcurrencyAccessControlActive

Combined gate for the AccessControl subtree.

public static readonly bool ConcurrencyAccessControlActive

Field Value

bool

ConcurrencyAccessControlContentionActive

Combined gate for AccessControl contention markers.

public static readonly bool ConcurrencyAccessControlContentionActive

Field Value

bool

ConcurrencyAccessControlExclusiveAcquireActive

Combined gate for AccessControl exclusive-acquire events.

public static readonly bool ConcurrencyAccessControlExclusiveAcquireActive

Field Value

bool

ConcurrencyAccessControlExclusiveReleaseActive

Combined gate for AccessControl exclusive-release events.

public static readonly bool ConcurrencyAccessControlExclusiveReleaseActive

Field Value

bool

ConcurrencyAccessControlPromotionActive

Combined gate for AccessControl shared↔exclusive promotion/demotion events.

public static readonly bool ConcurrencyAccessControlPromotionActive

Field Value

bool

ConcurrencyAccessControlSharedAcquireActive

Combined gate for AccessControl shared-acquire events.

public static readonly bool ConcurrencyAccessControlSharedAcquireActive

Field Value

bool

ConcurrencyAccessControlSharedReleaseActive

Combined gate for AccessControl shared-release events.

public static readonly bool ConcurrencyAccessControlSharedReleaseActive

Field Value

bool

ConcurrencyAccessControlSmallActive

Combined gate for the AccessControlSmall subtree.

public static readonly bool ConcurrencyAccessControlSmallActive

Field Value

bool

ConcurrencyAccessControlSmallContentionActive

Combined gate for AccessControlSmall contention markers.

public static readonly bool ConcurrencyAccessControlSmallContentionActive

Field Value

bool

ConcurrencyAccessControlSmallExclusiveAcquireActive

Combined gate for AccessControlSmall exclusive-acquire events.

public static readonly bool ConcurrencyAccessControlSmallExclusiveAcquireActive

Field Value

bool

ConcurrencyAccessControlSmallExclusiveReleaseActive

Combined gate for AccessControlSmall exclusive-release events.

public static readonly bool ConcurrencyAccessControlSmallExclusiveReleaseActive

Field Value

bool

ConcurrencyAccessControlSmallSharedAcquireActive

Combined gate for AccessControlSmall shared-acquire events.

public static readonly bool ConcurrencyAccessControlSmallSharedAcquireActive

Field Value

bool

ConcurrencyAccessControlSmallSharedReleaseActive

Combined gate for AccessControlSmall shared-release events.

public static readonly bool ConcurrencyAccessControlSmallSharedReleaseActive

Field Value

bool

ConcurrencyActive

Combined Concurrency root gate: master Enabled AND Typhon:Profiler:Concurrency:Enabled.

public static readonly bool ConcurrencyActive

Field Value

bool

ConcurrencyAdaptiveWaiterActive

Combined gate for the AdaptiveWaiter subtree.

public static readonly bool ConcurrencyAdaptiveWaiterActive

Field Value

bool

ConcurrencyAdaptiveWaiterYieldOrSleepActive

Combined gate for AdaptiveWaiter yield-or-sleep transition events. Phase 2 design (#280) chose transitions only — NOT per-spin — to keep trace volume sane.

public static readonly bool ConcurrencyAdaptiveWaiterYieldOrSleepActive

Field Value

bool

ConcurrencyEpochActive

Combined gate for the Epoch subtree.

public static readonly bool ConcurrencyEpochActive

Field Value

bool

ConcurrencyEpochAdvanceActive

Combined gate for GlobalEpoch advance events.

public static readonly bool ConcurrencyEpochAdvanceActive

Field Value

bool

ConcurrencyEpochRefreshActive

Combined gate for RefreshScope events.

public static readonly bool ConcurrencyEpochRefreshActive

Field Value

bool

ConcurrencyEpochScopeEnterActive

Combined gate for EpochGuard Enter (PinCurrentThread) events.

public static readonly bool ConcurrencyEpochScopeEnterActive

Field Value

bool

ConcurrencyEpochScopeExitActive

Combined gate for EpochGuard Dispose events.

public static readonly bool ConcurrencyEpochScopeExitActive

Field Value

bool

ConcurrencyEpochSlotClaimActive

Combined gate for EpochThreadRegistry slot-claim events.

public static readonly bool ConcurrencyEpochSlotClaimActive

Field Value

bool

ConcurrencyEpochSlotReclaimActive

Combined gate for EpochThreadRegistry dead-thread slot-reclaim events.

public static readonly bool ConcurrencyEpochSlotReclaimActive

Field Value

bool

ConcurrencyOlcLatchActive

Combined gate for the OlcLatch subtree.

public static readonly bool ConcurrencyOlcLatchActive

Field Value

bool

ConcurrencyOlcLatchMarkObsoleteActive

Combined gate for OlcLatch MarkObsolete events.

public static readonly bool ConcurrencyOlcLatchMarkObsoleteActive

Field Value

bool

ConcurrencyOlcLatchValidationFailActive

Combined gate for OlcLatch ValidateVersion-failure events.

public static readonly bool ConcurrencyOlcLatchValidationFailActive

Field Value

bool

ConcurrencyOlcLatchWriteLockAttemptActive

Combined gate for OlcLatch TryWriteLock-failure events.

public static readonly bool ConcurrencyOlcLatchWriteLockAttemptActive

Field Value

bool

ConcurrencyOlcLatchWriteUnlockActive

Combined gate for OlcLatch WriteUnlock events.

public static readonly bool ConcurrencyOlcLatchWriteUnlockActive

Field Value

bool

ConcurrencyResourceAccessControlAccessingActive

Combined gate for ResourceAccessControl Accessing-mode acquire events.

public static readonly bool ConcurrencyResourceAccessControlAccessingActive

Field Value

bool

ConcurrencyResourceAccessControlActive

Combined gate for the ResourceAccessControl subtree.

public static readonly bool ConcurrencyResourceAccessControlActive

Field Value

bool

ConcurrencyResourceAccessControlContentionActive

Combined gate for ResourceAccessControl contention markers.

public static readonly bool ConcurrencyResourceAccessControlContentionActive

Field Value

bool

ConcurrencyResourceAccessControlDestroyActive

Combined gate for ResourceAccessControl Destroy-mode acquire events.

public static readonly bool ConcurrencyResourceAccessControlDestroyActive

Field Value

bool

ConcurrencyResourceAccessControlModifyActive

Combined gate for ResourceAccessControl Modify-mode acquire events.

public static readonly bool ConcurrencyResourceAccessControlModifyActive

Field Value

bool

ConcurrencyResourceAccessControlModifyPromotionActive

Combined gate for ResourceAccessControl Modify-promotion slow-path events.

public static readonly bool ConcurrencyResourceAccessControlModifyPromotionActive

Field Value

bool

DataActive

Combined gate for the Data-plane tracing subtree (transaction, MVCC, B+Tree index spans).

public static readonly bool DataActive

Field Value

bool

DataIndexActive

Combined gate for the Data:Index subtree.

public static readonly bool DataIndexActive

Field Value

bool

DataIndexBTreeActive

Combined gate for the Data:Index:BTree subtree (B+Tree search/scan/mutation spans).

public static readonly bool DataIndexBTreeActive

Field Value

bool

DataIndexBTreeBulkInsertActive

Combined gate for the Data:Index:BTree:BulkInsert span.

public static readonly bool DataIndexBTreeBulkInsertActive

Field Value

bool

DataIndexBTreeNodeCowActive

Combined gate for the Data:Index:BTree:NodeCow span (copy-on-write of a B+Tree node).

public static readonly bool DataIndexBTreeNodeCowActive

Field Value

bool

DataIndexBTreeRangeScanActive

Combined gate for the Data:Index:BTree:RangeScan span.

public static readonly bool DataIndexBTreeRangeScanActive

Field Value

bool

DataIndexBTreeRangeScanRevalidateActive

Combined gate for the Data:Index:BTree:RangeScan:Revalidate span (optimistic scan revalidation after a version change).

public static readonly bool DataIndexBTreeRangeScanRevalidateActive

Field Value

bool

DataIndexBTreeRebalanceFallbackActive

Combined gate for the Data:Index:BTree:RebalanceFallback span (fallback to a pessimistic rebalance).

public static readonly bool DataIndexBTreeRebalanceFallbackActive

Field Value

bool

DataIndexBTreeRootActive

Combined gate for the Data:Index:BTree:Root span (root split/replace).

public static readonly bool DataIndexBTreeRootActive

Field Value

bool

DataIndexBTreeSearchActive

Combined gate for the Data:Index:BTree:Search span (point lookup).

public static readonly bool DataIndexBTreeSearchActive

Field Value

bool

DataMvccActive

Combined gate for the Data:MVCC subtree (version chain-walk and cleanup spans).

public static readonly bool DataMvccActive

Field Value

bool

DataMvccChainWalkActive

Combined gate for the Data:MVCC:ChainWalk span (walking a version chain to the visible revision).

public static readonly bool DataMvccChainWalkActive

Field Value

bool

DataMvccVersionCleanupActive

Combined gate for the Data:MVCC:VersionCleanup span (reclaiming obsolete versions).

public static readonly bool DataMvccVersionCleanupActive

Field Value

bool

DataTransactionActive

Combined gate for the Data:Transaction subtree (init/prepare/validate/conflict/cleanup spans).

public static readonly bool DataTransactionActive

Field Value

bool

DataTransactionCleanupActive

Combined gate for the Data:Transaction:Cleanup span.

public static readonly bool DataTransactionCleanupActive

Field Value

bool

DataTransactionConflictActive

Combined gate for the Data:Transaction:Conflict span (write-write conflict detected).

public static readonly bool DataTransactionConflictActive

Field Value

bool

DataTransactionInitActive

Combined gate for the Data:Transaction:Init span.

public static readonly bool DataTransactionInitActive

Field Value

bool

DataTransactionPrepareActive

Combined gate for the Data:Transaction:Prepare span.

public static readonly bool DataTransactionPrepareActive

Field Value

bool

DataTransactionValidateActive

Combined gate for the Data:Transaction:Validate span (commit-time conflict validation).

public static readonly bool DataTransactionValidateActive

Field Value

bool

DurabilityActive

Combined gate for the Durability tracing subtree (WAL, checkpoint, recovery, UoW spans).

public static readonly bool DurabilityActive

Field Value

bool

DurabilityCheckpointActive

Combined gate for the Durability:Checkpoint subtree (checkpoint spans).

public static readonly bool DurabilityCheckpointActive

Field Value

bool

DurabilityCheckpointBackpressureActive

Combined gate for the Durability:Checkpoint:Backpressure span (checkpoint throttled by backpressure).

public static readonly bool DurabilityCheckpointBackpressureActive

Field Value

bool

DurabilityCheckpointSleepActive

Combined gate for the Durability:Checkpoint:Sleep span (checkpoint pacing sleep).

public static readonly bool DurabilityCheckpointSleepActive

Field Value

bool

DurabilityCheckpointWriteBatchActive

Combined gate for the Durability:Checkpoint:WriteBatch span (writing a batch of dirty pages).

public static readonly bool DurabilityCheckpointWriteBatchActive

Field Value

bool

DurabilityRecoveryActive

Combined gate for the Durability:Recovery subtree (crash-recovery spans).

public static readonly bool DurabilityRecoveryActive

Field Value

bool

DurabilityRecoveryDiscoverActive

Combined gate for the Durability:Recovery:Discover span (discovering WAL segments to replay).

public static readonly bool DurabilityRecoveryDiscoverActive

Field Value

bool

DurabilityRecoveryRecordActive

Combined gate for the Durability:Recovery:Record span (applying one WAL record).

public static readonly bool DurabilityRecoveryRecordActive

Field Value

bool

DurabilityRecoveryRedoActive

Combined gate for the Durability:Recovery:Redo span (redo pass).

public static readonly bool DurabilityRecoveryRedoActive

Field Value

bool

DurabilityRecoverySegmentActive

Combined gate for the Durability:Recovery:Segment span (replaying one WAL segment).

public static readonly bool DurabilityRecoverySegmentActive

Field Value

bool

DurabilityRecoveryStartActive

Combined gate for the Durability:Recovery:Start span (recovery session start).

public static readonly bool DurabilityRecoveryStartActive

Field Value

bool

DurabilityRecoveryTickFenceActive

Combined gate for the Durability:Recovery:TickFence span (replaying a write-tick fence boundary).

public static readonly bool DurabilityRecoveryTickFenceActive

Field Value

bool

DurabilityRecoveryUndoActive

Combined gate for the Durability:Recovery:Undo span (undo of uncommitted effects).

public static readonly bool DurabilityRecoveryUndoActive

Field Value

bool

DurabilityUowActive

Combined gate for the Durability:UoW subtree (unit-of-work durability spans).

public static readonly bool DurabilityUowActive

Field Value

bool

DurabilityUowDeadlineActive

Combined gate for the Durability:UoW:Deadline span (unit-of-work deadline check).

public static readonly bool DurabilityUowDeadlineActive

Field Value

bool

DurabilityUowStateActive

Combined gate for the Durability:UoW:State span (unit-of-work state transition).

public static readonly bool DurabilityUowStateActive

Field Value

bool

DurabilityWalActive

Combined gate for the Durability:WAL subtree (write-ahead-log spans).

public static readonly bool DurabilityWalActive

Field Value

bool

DurabilityWalBackpressureActive

Combined gate for the Durability:WAL:Backpressure span (commit throttled by WAL backpressure).

public static readonly bool DurabilityWalBackpressureActive

Field Value

bool

DurabilityWalBufferActive

Combined gate for the Durability:WAL:Buffer span (WAL buffer fill/rotate).

public static readonly bool DurabilityWalBufferActive

Field Value

bool

DurabilityWalFrameActive

Combined gate for the Durability:WAL:Frame span (per-frame WAL encoding).

public static readonly bool DurabilityWalFrameActive

Field Value

bool

DurabilityWalGroupCommitActive

Combined gate for the Durability:WAL:GroupCommit span (group-commit batch).

public static readonly bool DurabilityWalGroupCommitActive

Field Value

bool

DurabilityWalOsWriteActive

Combined gate for the Durability:WAL:OsWrite span (OS write of a WAL buffer).

public static readonly bool DurabilityWalOsWriteActive

Field Value

bool

DurabilityWalQueueActive

Combined gate for the Durability:WAL:Queue span (commit-queue enqueue).

public static readonly bool DurabilityWalQueueActive

Field Value

bool

DurabilityWalQueueDrainActive

Combined gate for the Durability:WAL:QueueDrain span (draining the commit queue to the WAL writer).

public static readonly bool DurabilityWalQueueDrainActive

Field Value

bool

DurabilityWalSignalActive

Combined gate for the Durability:WAL:Signal span (post-flush signal to waiting committers).

public static readonly bool DurabilityWalSignalActive

Field Value

bool

EcsActive

Combined gate for the ECS tracing subtree (query-construction and view-maintenance spans).

public static readonly bool EcsActive

Field Value

bool

EcsQueryActive

Combined gate for the ECS:Query subtree (archetype-query construction spans).

public static readonly bool EcsQueryActive

Field Value

bool

EcsQueryConstraintEnabledActive

Combined gate for the ECS:Query:Constraint:Enabled span (enabled-constraint evaluation).

public static readonly bool EcsQueryConstraintEnabledActive

Field Value

bool

EcsQueryConstructActive

Combined gate for the ECS:Query:Construct span (query object construction).

public static readonly bool EcsQueryConstructActive

Field Value

bool

EcsQueryMaskAndActive

Combined gate for the ECS:Query:MaskAnd span (component-mask AND intersection).

public static readonly bool EcsQueryMaskAndActive

Field Value

bool

EcsQuerySpatialAttachActive

Combined gate for the ECS:Query:Spatial:Attach span (attaching a spatial constraint to a query).

public static readonly bool EcsQuerySpatialAttachActive

Field Value

bool

EcsQuerySubtreeExpandActive

Combined gate for the ECS:Query:SubtreeExpand span (archetype-subtree expansion).

public static readonly bool EcsQuerySubtreeExpandActive

Field Value

bool

EcsViewActive

Combined gate for the ECS:View subtree (materialized-view refresh spans).

public static readonly bool EcsViewActive

Field Value

bool

EcsViewDeltaBufferOverflowActive

Combined gate for the ECS:View:DeltaBuffer:Overflow span (delta buffer overflowed, forcing a full refresh).

public static readonly bool EcsViewDeltaBufferOverflowActive

Field Value

bool

EcsViewDeltaCacheMissActive

Combined gate for the ECS:View:DeltaCache:Miss span (delta-cache miss).

public static readonly bool EcsViewDeltaCacheMissActive

Field Value

bool

EcsViewIncrementalDrainActive

Combined gate for the ECS:View:IncrementalDrain span (draining buffered deltas into a view).

public static readonly bool EcsViewIncrementalDrainActive

Field Value

bool

EcsViewProcessEntryActive

Combined gate for the ECS:View:ProcessEntry span (processing one view entry).

public static readonly bool EcsViewProcessEntryActive

Field Value

bool

EcsViewProcessEntryOrActive

Combined gate for the ECS:View:ProcessEntryOr span (processing an OR-clause view entry).

public static readonly bool EcsViewProcessEntryOrActive

Field Value

bool

EcsViewRefreshFullActive

Combined gate for the ECS:View:RefreshFull span (full view rebuild).

public static readonly bool EcsViewRefreshFullActive

Field Value

bool

EcsViewRefreshFullOrActive

Combined gate for the ECS:View:RefreshFullOr span (full rebuild of an OR-clause view).

public static readonly bool EcsViewRefreshFullOrActive

Field Value

bool

EcsViewRefreshPullActive

Combined gate for the ECS:View:RefreshPull span (pull-based view refresh).

public static readonly bool EcsViewRefreshPullActive

Field Value

bool

EcsViewRegistryDeregisterActive

Combined gate for the ECS:View:Registry:Deregister span (view deregistration).

public static readonly bool EcsViewRegistryDeregisterActive

Field Value

bool

EcsViewRegistryRegisterActive

Combined gate for the ECS:View:Registry:Register span (view registration).

public static readonly bool EcsViewRegistryRegisterActive

Field Value

bool

LoadedConfigurationFile

The configuration file path that was loaded, or null if using defaults/env vars only.

public static readonly string LoadedConfigurationFile

Field Value

string

MemoryActive

Combined gate for the Memory tracing subtree.

public static readonly bool MemoryActive

Field Value

bool

MemoryAlignmentWasteActive

Combined gate for the Memory:AlignmentWaste span (bytes lost to alignment padding on an allocation).

public static readonly bool MemoryAlignmentWasteActive

Field Value

bool

ProfilerActive

Global profiler enable/disable. When false, all profiler-emitted telemetry is disabled regardless of individual component settings.

public static readonly bool ProfilerActive

Field Value

bool

ProfilerCpuSamplingActive

Combined gate: true only when ProfilerActive AND ProfilerCpuSamplingEnabled are set.

public static readonly bool ProfilerCpuSamplingActive

Field Value

bool

ProfilerCpuSamplingEnabled

Whether opt-in in-process CPU stack sampling is requested by configuration.

public static readonly bool ProfilerCpuSamplingEnabled

Field Value

bool

ProfilerGaugesActive

Combined gate: true only when ProfilerActive AND ProfilerGaugesEnabled are set.

public static readonly bool ProfilerGaugesActive

Field Value

bool

ProfilerGaugesEnabled

Whether opt-in per-tick gauge snapshots are requested by configuration.

public static readonly bool ProfilerGaugesEnabled

Field Value

bool

ProfilerGcTracingActive

Combined gate: true only when ProfilerActive AND ProfilerGcTracingEnabled are set.

public static readonly bool ProfilerGcTracingActive

Field Value

bool

ProfilerGcTracingEnabled

Whether opt-in .NET runtime GC-event tracing is requested by configuration.

public static readonly bool ProfilerGcTracingEnabled

Field Value

bool

ProfilerMemoryAllocationsActive

Combined gate: true only when ProfilerActive AND ProfilerMemoryAllocationsEnabled are set.

public static readonly bool ProfilerMemoryAllocationsActive

Field Value

bool

ProfilerMemoryAllocationsEnabled

Whether opt-in per-allocation tracking is requested by configuration.

public static readonly bool ProfilerMemoryAllocationsEnabled

Field Value

bool

QueryActive

Combined gate for the Query tracing subtree (parse/plan/execute spans).

public static readonly bool QueryActive

Field Value

bool

QueryCountActive

Combined gate for the Query:Count span (count-only execution).

public static readonly bool QueryCountActive

Field Value

bool

QueryEstimateActive

Combined gate for the Query:Estimate span (cardinality/cost estimation).

public static readonly bool QueryEstimateActive

Field Value

bool

QueryExecuteActive

Combined gate for the Query:Execute subtree (execution spans).

public static readonly bool QueryExecuteActive

Field Value

bool

QueryExecuteFilterActive

Combined gate for the Query:Execute:Filter span (residual predicate filtering).

public static readonly bool QueryExecuteFilterActive

Field Value

bool

QueryExecuteIndexScanActive

Combined gate for the Query:Execute:IndexScan span.

public static readonly bool QueryExecuteIndexScanActive

Field Value

bool

QueryExecuteIterateActive

Combined gate for the Query:Execute:Iterate span (result iteration).

public static readonly bool QueryExecuteIterateActive

Field Value

bool

QueryExecutePaginationActive

Combined gate for the Query:Execute:Pagination span (skip/take pagination).

public static readonly bool QueryExecutePaginationActive

Field Value

bool

QueryExecuteStorageModeActive

Combined gate for the Query:Execute:StorageMode span (per-storage-mode execution path).

public static readonly bool QueryExecuteStorageModeActive

Field Value

bool

QueryParseDnfActive

Combined gate for the Query:Parse:DNF span (disjunctive-normal-form conversion).

public static readonly bool QueryParseDnfActive

Field Value

bool

QueryParseEnabledActive

Combined gate for the Query:Parse subtree (query-string parsing spans).

public static readonly bool QueryParseEnabledActive

Field Value

bool

QueryPlanEnabledActive

Combined gate for the Query:Plan subtree (planning/optimization spans).

public static readonly bool QueryPlanEnabledActive

Field Value

bool

QueryPlanPrimarySelectActive

Combined gate for the Query:Plan:PrimarySelect span (primary access-path selection).

public static readonly bool QueryPlanPrimarySelectActive

Field Value

bool

QueryPlanSortActive

Combined gate for the Query:Plan:Sort span (sort planning).

public static readonly bool QueryPlanSortActive

Field Value

bool

RuntimeActive

Combined gate for the Runtime tracing subtree (UoW phase, transaction lifecycle, subscription spans).

public static readonly bool RuntimeActive

Field Value

bool

RuntimePhaseActive

Combined gate for the Runtime:Phase subtree (unit-of-work create/flush spans).

public static readonly bool RuntimePhaseActive

Field Value

bool

RuntimePhaseUoWCreateActive

Combined gate for the Runtime:Phase:UoWCreate span (unit-of-work creation).

public static readonly bool RuntimePhaseUoWCreateActive

Field Value

bool

RuntimePhaseUoWFlushActive

Combined gate for the Runtime:Phase:UoWFlush span (unit-of-work flush).

public static readonly bool RuntimePhaseUoWFlushActive

Field Value

bool

RuntimeSubscriptionActive

Combined gate for the Runtime:Subscription subtree (change-subscription delivery spans).

public static readonly bool RuntimeSubscriptionActive

Field Value

bool

RuntimeSubscriptionDeltaBuildActive

Combined gate for the Runtime:Subscription:Delta:Build span (building a change delta).

public static readonly bool RuntimeSubscriptionDeltaBuildActive

Field Value

bool

RuntimeSubscriptionDeltaDirtyBitmapSupplementActive

Combined gate for the Runtime:Subscription:Delta:DirtyBitmapSupplement span.

public static readonly bool RuntimeSubscriptionDeltaDirtyBitmapSupplementActive

Field Value

bool

RuntimeSubscriptionDeltaSerializeActive

Combined gate for the Runtime:Subscription:Delta:Serialize span (serializing a change delta).

public static readonly bool RuntimeSubscriptionDeltaSerializeActive

Field Value

bool

RuntimeSubscriptionOutputActive

Combined gate for the Runtime:Subscription:Output subtree (subscriber output execute/cleanup spans).

public static readonly bool RuntimeSubscriptionOutputActive

Field Value

bool

RuntimeSubscriptionOutputCleanupActive

Combined gate for the Runtime:Subscription:Output:Cleanup span.

public static readonly bool RuntimeSubscriptionOutputCleanupActive

Field Value

bool

RuntimeSubscriptionOutputExecuteActive

Combined gate for the Runtime:Subscription:Output:Execute span (running a subscriber's output callback).

public static readonly bool RuntimeSubscriptionOutputExecuteActive

Field Value

bool

RuntimeSubscriptionSubscriberActive

Combined gate for the Runtime:Subscription:Subscriber span (per-subscriber delivery).

public static readonly bool RuntimeSubscriptionSubscriberActive

Field Value

bool

RuntimeSubscriptionTransitionBeginSyncActive

Combined gate for the Runtime:Subscription:Transition:BeginSync span.

public static readonly bool RuntimeSubscriptionTransitionBeginSyncActive

Field Value

bool

RuntimeThreadSchedulingActive

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.

public static readonly bool RuntimeThreadSchedulingActive

Field Value

bool

RuntimeTransactionActive

Combined gate for the Runtime:Transaction subtree (transaction lifecycle spans).

public static readonly bool RuntimeTransactionActive

Field Value

bool

RuntimeTransactionLifecycleActive

Combined gate for the Runtime:Transaction:Lifecycle span.

public static readonly bool RuntimeTransactionLifecycleActive

Field Value

bool

RuntimeWriteTickFenceActive

Combined gate for the Runtime:WriteTickFence subtree (per-table and per-archetype cluster write-fence spans).

public static readonly bool RuntimeWriteTickFenceActive

Field Value

bool

RuntimeWriteTickFenceClusterActive

Combined gate for the Runtime:WriteTickFence:Cluster span (per-archetype cluster fence cost).

public static readonly bool RuntimeWriteTickFenceClusterActive

Field Value

bool

RuntimeWriteTickFenceClusterShadowActive

Combined gate for the Runtime:WriteTickFence:Cluster:Shadow span.

public static readonly bool RuntimeWriteTickFenceClusterShadowActive

Field Value

bool

RuntimeWriteTickFenceClusterSpatialActive

Combined gate for the Runtime:WriteTickFence:Cluster:Spatial span.

public static readonly bool RuntimeWriteTickFenceClusterSpatialActive

Field Value

bool

RuntimeWriteTickFenceShadowActive

Combined gate for the Runtime:WriteTickFence:Shadow span (shadow-copy portion of a table fence).

public static readonly bool RuntimeWriteTickFenceShadowActive

Field Value

bool

RuntimeWriteTickFenceSpatialActive

Combined gate for the Runtime:WriteTickFence:Spatial span (spatial-index portion of a table fence).

public static readonly bool RuntimeWriteTickFenceSpatialActive

Field Value

bool

RuntimeWriteTickFenceTableActive

Combined gate for the Runtime:WriteTickFence:Table span (per-table fence cost).

public static readonly bool RuntimeWriteTickFenceTableActive

Field Value

bool

SchedulerActive

Whether Scheduler component telemetry is enabled in configuration.

public static readonly bool SchedulerActive

Field Value

bool

SchedulerArchetypeTouchesActive

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.

public static readonly bool SchedulerArchetypeTouchesActive

Field Value

bool

SchedulerDependencyActive

Combined gate for the Scheduler:Dependency subtree (dependency-ready/fan-out spans).

public static readonly bool SchedulerDependencyActive

Field Value

bool

SchedulerDependencyFanOutActive

Combined gate for the Scheduler:Dependency:FanOut span.

public static readonly bool SchedulerDependencyFanOutActive

Field Value

bool

SchedulerDependencyReadyActive

Combined gate for the Scheduler:Dependency:Ready span (a system's dependencies became satisfied).

public static readonly bool SchedulerDependencyReadyActive

Field Value

bool

SchedulerDispenseActive

Combined gate for the Scheduler:Dispense span (work-item dispense to workers).

public static readonly bool SchedulerDispenseActive

Field Value

bool

SchedulerGraphActive

Combined gate for the Scheduler:Graph subtree (DAG build/rebuild spans).

public static readonly bool SchedulerGraphActive

Field Value

bool

SchedulerGraphBuildActive

Combined gate for the Scheduler:Graph:Build span (initial DAG build).

public static readonly bool SchedulerGraphBuildActive

Field Value

bool

SchedulerGraphRebuildActive

Combined gate for the Scheduler:Graph:Rebuild span (DAG rebuild after a schema/system change).

public static readonly bool SchedulerGraphRebuildActive

Field Value

bool

SchedulerMetronomeActive

Combined gate for the Scheduler:Metronome subtree.

public static readonly bool SchedulerMetronomeActive

Field Value

bool

SchedulerMetronomeWaitActive

Combined flag for the SchedulerMetronomeWait span (kind 241).

public static readonly bool SchedulerMetronomeWaitActive

Field Value

bool

SchedulerOverloadActive

Combined gate for the Scheduler:Overload subtree (overload level-change/shed spans).

public static readonly bool SchedulerOverloadActive

Field Value

bool

SchedulerOverloadDetectorActive

Combined flag for the per-tick OverloadDetector gauge snapshot (overrunRatio, consecutive counters, level, multiplier).

public static readonly bool SchedulerOverloadDetectorActive

Field Value

bool

SchedulerOverloadLevelChangeActive

Combined gate for the Scheduler:Overload:LevelChange span.

public static readonly bool SchedulerOverloadLevelChangeActive

Field Value

bool

SchedulerOverloadSystemShedActive

Combined gate for the Scheduler:Overload:SystemShed span (a system shed under overload).

public static readonly bool SchedulerOverloadSystemShedActive

Field Value

bool

SchedulerOverloadTickMultiplierActive

Combined gate for the Scheduler:Overload:TickMultiplier span.

public static readonly bool SchedulerOverloadTickMultiplierActive

Field Value

bool

SchedulerQueueActive

Combined gate for the Scheduler:Queue subtree.

public static readonly bool SchedulerQueueActive

Field Value

bool

SchedulerQueueTickEndActive

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).

public static readonly bool SchedulerQueueTickEndActive

Field Value

bool

SchedulerSystemActive

Combined gate for the Scheduler:System subtree (per-system execution/queue-wait spans).

public static readonly bool SchedulerSystemActive

Field Value

bool

SchedulerSystemCompletionActive

Combined gate for the Scheduler:System:Completion span.

public static readonly bool SchedulerSystemCompletionActive

Field Value

bool

SchedulerSystemQueueWaitActive

Combined gate for the Scheduler:System:QueueWait span (time a system waited in its queue before running).

public static readonly bool SchedulerSystemQueueWaitActive

Field Value

bool

SchedulerSystemSingleThreadedActive

Combined gate for the Scheduler:System:SingleThreaded span.

public static readonly bool SchedulerSystemSingleThreadedActive

Field Value

bool

SchedulerSystemStartExecutionActive

Combined gate for the Scheduler:System:StartExecution span.

public static readonly bool SchedulerSystemStartExecutionActive

Field Value

bool

SchedulerTrackStragglerGap

Whether to track straggler gap (parallel efficiency metric for Patate systems).

public static readonly bool SchedulerTrackStragglerGap

Field Value

bool

SchedulerTrackTransitionLatency

Whether to track per-system transition latency.

public static readonly bool SchedulerTrackTransitionLatency

Field Value

bool

SchedulerTrackWorkerUtilization

Whether to track per-worker active/idle time breakdown.

public static readonly bool SchedulerTrackWorkerUtilization

Field Value

bool

SchedulerWorkerActive

Combined gate for the Scheduler:Worker subtree (worker idle/wake spans).

public static readonly bool SchedulerWorkerActive

Field Value

bool

SchedulerWorkerBetweenTickActive

Combined gate for the Scheduler:Worker:BetweenTick span (worker gap between ticks).

public static readonly bool SchedulerWorkerBetweenTickActive

Field Value

bool

SchedulerWorkerIdleActive

Combined gate for the Scheduler:Worker:Idle span.

public static readonly bool SchedulerWorkerIdleActive

Field Value

bool

SchedulerWorkerWakeActive

Combined gate for the Scheduler:Worker:Wake span.

public static readonly bool SchedulerWorkerWakeActive

Field Value

bool

SpatialActive

Combined gate for the entire Spatial subsystem (parent of all Spatial:* leaves).

public static readonly bool SpatialActive

Field Value

bool

SpatialCellActive

Combined gate for the Spatial:Cell subtree.

public static readonly bool SpatialCellActive

Field Value

bool

SpatialCellIndexActive

Combined gate for the Spatial:Cell:Index subtree (per-cell occupant index add/update/remove spans).

public static readonly bool SpatialCellIndexActive

Field Value

bool

SpatialCellIndexAddActive

Combined gate for the Spatial:Cell:Index:Add span.

public static readonly bool SpatialCellIndexAddActive

Field Value

bool

SpatialCellIndexRemoveActive

Combined gate for the Spatial:Cell:Index:Remove span.

public static readonly bool SpatialCellIndexRemoveActive

Field Value

bool

SpatialCellIndexUpdateActive

Combined gate for the Spatial:Cell:Index:Update span.

public static readonly bool SpatialCellIndexUpdateActive

Field Value

bool

SpatialClusterMigrationActive

Combined gate for the Spatial:ClusterMigration subtree (cross-cell cluster migration spans).

public static readonly bool SpatialClusterMigrationActive

Field Value

bool

SpatialClusterMigrationDetectActive

Combined gate for the Spatial:ClusterMigration:Detect span (migration-needed detection).

public static readonly bool SpatialClusterMigrationDetectActive

Field Value

bool

SpatialClusterMigrationExecuteActive

Combined gate for the Spatial:ClusterMigration:Execute span (migration apply; legacy kind 60, on by default).

public static readonly bool SpatialClusterMigrationExecuteActive

Field Value

bool

SpatialClusterMigrationHysteresisActive

Combined gate for the Spatial:ClusterMigration:Hysteresis span (hysteresis suppression of a migration).

public static readonly bool SpatialClusterMigrationHysteresisActive

Field Value

bool

SpatialClusterMigrationQueueActive

Combined gate for the Spatial:ClusterMigration:Queue span (migration enqueue).

public static readonly bool SpatialClusterMigrationQueueActive

Field Value

bool

SpatialGridActive

Combined gate for the Spatial:Grid subtree (uniform-grid cell tier/occupancy spans).

public static readonly bool SpatialGridActive

Field Value

bool

SpatialGridCellTierChangeActive

Combined gate for the Spatial:Grid:CellTierChange span (cell promoted/demoted between density tiers).

public static readonly bool SpatialGridCellTierChangeActive

Field Value

bool

SpatialGridClusterCellAssignActive

Combined gate for the Spatial:Grid:ClusterCellAssign span (cluster assigned to a grid cell).

public static readonly bool SpatialGridClusterCellAssignActive

Field Value

bool

SpatialGridOccupancyChangeActive

Combined gate for the Spatial:Grid:OccupancyChange span.

public static readonly bool SpatialGridOccupancyChangeActive

Field Value

bool

SpatialMaintainAabbValidateActive

Combined gate for the Spatial:Maintain:AabbValidate span.

public static readonly bool SpatialMaintainAabbValidateActive

Field Value

bool

SpatialMaintainActive

Combined gate for the Spatial:Maintain subtree (index-maintenance spans on entity insert/update).

public static readonly bool SpatialMaintainActive

Field Value

bool

SpatialMaintainBackPointerWriteActive

Combined gate for the Spatial:Maintain:BackPointerWrite span.

public static readonly bool SpatialMaintainBackPointerWriteActive

Field Value

bool

SpatialMaintainInsertActive

Combined gate for the Spatial:Maintain:Insert span.

public static readonly bool SpatialMaintainInsertActive

Field Value

bool

SpatialMaintainUpdateSlowPathActive

Combined gate for the Spatial:Maintain:UpdateSlowPath span.

public static readonly bool SpatialMaintainUpdateSlowPathActive

Field Value

bool

SpatialQueryAabbActive

Combined gate for the Spatial:Query:Aabb span (axis-aligned bounding-box overlap query).

public static readonly bool SpatialQueryAabbActive

Field Value

bool

SpatialQueryActive

Combined gate for the Spatial:Query subtree (AABB/radius/ray/frustum/kNN/count query spans).

public static readonly bool SpatialQueryActive

Field Value

bool

SpatialQueryCountActive

Combined gate for the Spatial:Query:Count span (count-only spatial query).

public static readonly bool SpatialQueryCountActive

Field Value

bool

SpatialQueryFrustumActive

Combined gate for the Spatial:Query:Frustum span (frustum-culling query).

public static readonly bool SpatialQueryFrustumActive

Field Value

bool

SpatialQueryKnnActive

Combined gate for the Spatial:Query:Knn span (k-nearest-neighbour query).

public static readonly bool SpatialQueryKnnActive

Field Value

bool

SpatialQueryRadiusActive

Combined gate for the Spatial:Query:Radius span (radius/sphere overlap query).

public static readonly bool SpatialQueryRadiusActive

Field Value

bool

SpatialQueryRayActive

Combined gate for the Spatial:Query:Ray span (ray-cast query).

public static readonly bool SpatialQueryRayActive

Field Value

bool

SpatialRTreeActive

Combined gate for the Spatial:RTree subtree (R-tree structural mutation spans).

public static readonly bool SpatialRTreeActive

Field Value

bool

SpatialRTreeBulkLoadActive

Combined gate for the Spatial:RTree:BulkLoad span (bulk STR-pack load).

public static readonly bool SpatialRTreeBulkLoadActive

Field Value

bool

SpatialRTreeInsertActive

Combined gate for the Spatial:RTree:Insert span.

public static readonly bool SpatialRTreeInsertActive

Field Value

bool

SpatialRTreeNodeSplitActive

Combined gate for the Spatial:RTree:NodeSplit span.

public static readonly bool SpatialRTreeNodeSplitActive

Field Value

bool

SpatialRTreeRemoveActive

Combined gate for the Spatial:RTree:Remove span.

public static readonly bool SpatialRTreeRemoveActive

Field Value

bool

SpatialTierIndexActive

Combined gate for the Spatial:TierIndex subtree (tier-index rebuild spans).

public static readonly bool SpatialTierIndexActive

Field Value

bool

SpatialTierIndexRebuildActive

Combined gate for the Spatial:TierIndex:Rebuild span.

public static readonly bool SpatialTierIndexRebuildActive

Field Value

bool

SpatialTierIndexVersionSkipActive

Combined gate for the Spatial:TierIndex:VersionSkip span (rebuild skipped because the version was unchanged).

public static readonly bool SpatialTierIndexVersionSkipActive

Field Value

bool

SpatialTriggerActive

Combined gate for the Spatial:Trigger subtree (spatial-trigger region/eval spans).

public static readonly bool SpatialTriggerActive

Field Value

bool

SpatialTriggerCacheActive

Combined gate for the Spatial:Trigger:Cache subtree.

public static readonly bool SpatialTriggerCacheActive

Field Value

bool

SpatialTriggerCacheInvalidateActive

Combined gate for the Spatial:Trigger:Cache:Invalidate span.

public static readonly bool SpatialTriggerCacheInvalidateActive

Field Value

bool

SpatialTriggerEvalActive

Combined gate for the Spatial:Trigger:Eval span (trigger-region evaluation).

public static readonly bool SpatialTriggerEvalActive

Field Value

bool

SpatialTriggerOccupantActive

Combined gate for the Spatial:Trigger:Occupant subtree.

public static readonly bool SpatialTriggerOccupantActive

Field Value

bool

SpatialTriggerOccupantDiffActive

Combined gate for the Spatial:Trigger:Occupant:Diff span (enter/exit occupant diff).

public static readonly bool SpatialTriggerOccupantDiffActive

Field Value

bool

SpatialTriggerRegionActive

Combined gate for the Spatial:Trigger:Region span.

public static readonly bool SpatialTriggerRegionActive

Field Value

bool

StorageActive

Combined gate for the Storage tracing subtree (page-cache, segment, file-handle, occupancy-map spans).

public static readonly bool StorageActive

Field Value

bool

StorageChunkSegmentActive

Combined gate for the Storage:ChunkSegment subtree.

public static readonly bool StorageChunkSegmentActive

Field Value

bool

StorageChunkSegmentGrowActive

Combined gate for the Storage:ChunkSegment:Grow span.

public static readonly bool StorageChunkSegmentGrowActive

Field Value

bool

StorageFileHandleEnabledActive

Combined gate for the Storage:FileHandle span (OS file-handle lifecycle).

public static readonly bool StorageFileHandleEnabledActive

Field Value

bool

StorageOccupancyMapActive

Combined gate for the Storage:OccupancyMap subtree.

public static readonly bool StorageOccupancyMapActive

Field Value

bool

StorageOccupancyMapGrowActive

Combined gate for the Storage:OccupancyMap:Grow span.

public static readonly bool StorageOccupancyMapGrowActive

Field Value

bool

StoragePageCacheActive

Combined gate for the Storage:PageCache subtree.

public static readonly bool StoragePageCacheActive

Field Value

bool

StoragePageCacheCompletionThresholdMs

Producer-side duration threshold (ms) for kinds 56/57/58 (PageCache:DiskRead/Write/Flush Completed). When > 0 the emit path skips records whose duration is shorter than the threshold; when 0 it matches today's behaviour (always emit when un-suppressed). Default: 1 ms.

public static readonly int StoragePageCacheCompletionThresholdMs

Field Value

int

StoragePageCacheDirtyWalkActive

Combined gate for the Storage:PageCache:DirtyWalk span (walk of dirty pages during checkpoint).

public static readonly bool StoragePageCacheDirtyWalkActive

Field Value

bool

StorageSegmentActive

Combined gate for the Storage:Segment subtree (segment create/grow/load spans).

public static readonly bool StorageSegmentActive

Field Value

bool

StorageSegmentCreateActive

Combined gate for the Storage:Segment:Create span.

public static readonly bool StorageSegmentCreateActive

Field Value

bool

StorageSegmentGrowActive

Combined gate for the Storage:Segment:Grow span.

public static readonly bool StorageSegmentGrowActive

Field Value

bool

StorageSegmentLoadActive

Combined gate for the Storage:Segment:Load span.

public static readonly bool StorageSegmentLoadActive

Field Value

bool

Methods

EnsureInitialized()

Forces early initialization of telemetry configuration. Call this at application startup to ensure the JIT compiler sees the readonly field values before compiling hot paths.

public static void EnsureInitialized()

Remarks

The NoInlining attribute ensures this method is actually called and not optimized away, guaranteeing the static constructor runs.

GetActiveComponentsSummary()

Returns a concise one-line summary of active telemetry components.

public static string GetActiveComponentsSummary()

Returns

string

GetConfigurationSummary()

Returns a human-readable summary of the current telemetry configuration. Useful for logging at application startup.

public static string GetConfigurationSummary()

Returns

string

A multi-line string describing all telemetry settings.