TraconDiagnostics

Namespace Tracon · Assembly Tracon.Core.dll

Defines Tracon telemetry source and measurement names.

public static class TraconDiagnostics

Inheritance

object ← TraconDiagnostics

Inherited Members

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Remarks

These names are stable. Consumers use them in OpenTelemetry configuration, so changing them is a breaking change.

Consumers continue to configure their own OTLP exporter. Tracon does not take over the pipeline. Example setup:

builder.Services.AddOpenTelemetry()
    .WithTracing(t => t.AddSource(TraconDiagnostics.ActivitySourceName))
    .WithMetrics(m => m.AddMeter(TraconDiagnostics.MeterName));

Fields

ActivitySourceName

Gets the Tracon ActivitySource name.

public const string ActivitySourceName = "Tracon"

Field Value

string

AgentSourceFailureCounterName

Gets the counter name for agent-source failures.

public const string AgentSourceFailureCounterName = "tracon.agent_source.failures"

Field Value

string

AuditWriteFailureCounterName

Gets the counter name for audit-trail entries that could not be written.

public const string AuditWriteFailureCounterName = "tracon.audit.write_failures"

Field Value

string

Remarks

Counted on BOTH audit write paths and separated by Tags.AuditOutcome: a swallowed failure left the operation to continue, a refused one stopped it. A non-zero value on either means the audit trail has a hole in it.

CompactHistoryActivityName

Gets the span name that represents a context-compaction summarization call.

public const string CompactHistoryActivityName = "compact_history"

Field Value

string

JobCounterName

Gets the counter name for finished background jobs.

public const string JobCounterName = "tracon.job.executions"

Field Value

string

JobDurationName

Gets the job-attempt duration histogram name in seconds.

public const string JobDurationName = "tracon.job.duration"

Field Value

string

JobQueueDepthGaugeName

Gets the observable gauge that shows outstanding jobs per lane and status.

public const string JobQueueDepthGaugeName = "tracon.job.queue.depth"

Field Value

string

JudgeCostCounterName

Gets the counter name for the judge’s own cost.

public const string JudgeCostCounterName = "tracon.judge.cost"

Field Value

string

JudgeScoreHistogramName

Gets the histogram name for judge scores from 0 to 100.

public const string JudgeScoreHistogramName = "tracon.judge.score"

Field Value

string

MeterName

Gets the Tracon Meter name.

public const string MeterName = "Tracon"

Field Value

string

ModelCacheLookupCounterName

Gets the response-cache lookup counter name.

public const string ModelCacheLookupCounterName = "tracon.model.cache"

Field Value

string

QuotaLimitGaugeName

Gets the observable gauge that shows the configured quota-scope limit.

public const string QuotaLimitGaugeName = "tracon.quota.limit"

Field Value

string

QuotaUsageGaugeName

Gets the observable gauge that shows quota-scope consumption in the current period.

public const string QuotaUsageGaugeName = "tracon.quota.usage"

Field Value

string

RunActivityName

Gets the root span name that represents a run.

public const string RunActivityName = "tracon.run"

Field Value

string

RunCostCounterName

Gets the monetary cost counter name per run.

public const string RunCostCounterName = "tracon.run.cost"

Field Value

string

RunCounterName

Gets the completed-run counter name.

public const string RunCounterName = "tracon.runs"

Field Value

string

RunDurationName

Gets the run-duration histogram name in seconds.

public const string RunDurationName = "tracon.run.duration"

Field Value

string

RunRecordingFailureCounterName

Gets the counter name for run records that could not be written.

public const string RunRecordingFailureCounterName = "tracon.run.recording_failures"

Field Value

string

Remarks

Run recording is best-effort by design: a store failure never interrupts the run. This counter is how that loss becomes visible. One measurement is one write attempt whose record was lost, separated by Tags.RecordingStage. A non-zero value means a run happened whose evidence is incomplete or missing.

SkillScriptActivityName

Gets the span name that represents a skill script execution.

public const string SkillScriptActivityName = "execute_skill_script"

Field Value

string

SkillScriptToolName

Gets the tool name for skill script calls in metrics.

public const string SkillScriptToolName = "skill_script"

Field Value

string

TokenCounterName

Gets the token counter name.

public const string TokenCounterName = "tracon.tokens"

Field Value

string

ToolCounterName

Gets the tool-invocation counter name.

public const string ToolCounterName = "tracon.tool.invocations"

Field Value

string

ToolDurationName

Gets the tool-call duration histogram name in seconds.

public const string ToolDurationName = "tracon.tool.duration"

Field Value

string