Class TyphonSpanAttributes

Namespace

Typhon.Engine

Assembly

Typhon.Engine.dll

Centralized attribute name constants for distributed tracing spans.

public static class TyphonSpanAttributes

Inheritance

object

TyphonSpanAttributes

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Remarks

These constants follow OpenTelemetry semantic conventions with the typhon. prefix for Typhon-specific attributes. Using constants ensures consistency across all span instrumentation and enables IDE autocompletion.

Example usage:

activity?.SetTag(TyphonSpanAttributes.TransactionTsn, tsn);
activity?.SetTag(TyphonSpanAttributes.EntityId, entityId);

Fields

CacheHit

Whether a page request was served from cache.

public const string CacheHit = "typhon.cache.hit"

Field Value

string

ComponentRevision

The revision number of a component.

public const string ComponentRevision = "typhon.component.revision"

Field Value

string

ComponentType

The type name of the component being operated on.

public const string ComponentType = "typhon.component.type"

Field Value

string

EcsArchetype

The archetype name (e.g., "Factory", "House").

public const string EcsArchetype = "typhon.ecs.archetype"

Field Value

string

EcsCascadeCount

Number of cascade-deleted children.

public const string EcsCascadeCount = "typhon.ecs.cascade_count"

Field Value

string

EcsComponentType

The component type name (e.g., "Typhon.Test.ECS.Position").

public const string EcsComponentType = "typhon.ecs.component_type"

Field Value

string

EcsEntityCount

Number of entities affected by a batch operation.

public const string EcsEntityCount = "typhon.ecs.entity_count"

Field Value

string

EcsQueryResultCount

Number of matching entities returned by a query.

public const string EcsQueryResultCount = "typhon.ecs.query.result_count"

Field Value

string

EcsQueryScanMode

The query scan mode used ("broad" or "targeted").

public const string EcsQueryScanMode = "typhon.ecs.query.scan_mode"

Field Value

string

EntityId

The primary key (entity ID) of the entity being operated on.

public const string EntityId = "typhon.entity.id"

Field Value

string

IndexName

The name of the index being operated on.

public const string IndexName = "typhon.index.name"

Field Value

string

IndexNodeDepth

The depth level in the B+Tree where the operation occurred.

public const string IndexNodeDepth = "typhon.index.node_depth"

Field Value

string

IndexNodeMerge

Indicates a B+Tree node merge occurred.

public const string IndexNodeMerge = "typhon.index.node_merge"

Field Value

string

IndexNodeSplit

Indicates a B+Tree node split occurred.

public const string IndexNodeSplit = "typhon.index.node_split"

Field Value

string

IndexOperation

The type of index operation being performed.

public const string IndexOperation = "typhon.index.operation"

Field Value

string

PageCount

The number of pages involved in a batch operation.

public const string PageCount = "typhon.page.count"

Field Value

string

PageId

The page index (file page ID) being accessed.

public const string PageId = "typhon.page.id"

Field Value

string

PageSource

The source of the page data ("cache" or "disk").

public const string PageSource = "typhon.page.source"

Field Value

string

ReadFound

Whether a read operation found the requested entity.

public const string ReadFound = "typhon.read.found"

Field Value

string

TransactionComponentCount

The number of component types touched by the transaction.

public const string TransactionComponentCount = "typhon.transaction.component_count"

Field Value

string

TransactionConflictDetected

Whether a concurrency conflict was detected during commit.

public const string TransactionConflictDetected = "typhon.transaction.conflict_detected"

Field Value

string

TransactionStatus

The final status of the transaction (e.g., "committed", "rolledback").

public const string TransactionStatus = "typhon.transaction.status"

Field Value

string

TransactionTsn

The Transaction Sequence Number (TSN) identifying the transaction.

public const string TransactionTsn = "typhon.transaction.tsn"

Field Value

string

ViewDeltaCount

Number of delta entries processed during View.Refresh.

public const string ViewDeltaCount = "typhon.view.delta_count"

Field Value

string

ViewOverflow

Whether the view overflowed and required a full re-query.

public const string ViewOverflow = "typhon.view.overflow"

Field Value

string