Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

telemetry

package

Go to main page

Versions in this module

v0

v0.12.3

May 13, 2026

v0.12.2

May 12, 2026

Changes in this version

+ const KeyReasoningEmitted

+ const KeyReasoningIntent

type ChatSpan

+ ReasoningEmitted string

+ ReasoningIntent string

v0.12.1

May 10, 2026

v0.12.0

May 10, 2026

Changes in this version

+ const KeyAgentID

+ const KeyAgentName

+ const KeyAgentVersion

+ const KeyAttemptIndex

+ const KeyAttemptedProviders

+ const KeyConversationID

+ const KeyCostAmount

+ const KeyCostCacheReadAmount

+ const KeyCostCacheWriteAmount

+ const KeyCostCurrency

+ const KeyCostInputAmount

+ const KeyCostOutputAmount

+ const KeyCostPricingRef

+ const KeyCostRaw

+ const KeyCostReasoningAmount

+ const KeyCostSource

+ const KeyErrorType

+ const KeyFailoverCount

+ const KeyHarnessName

+ const KeyHarnessVersion

+ const KeyOperationName

+ const KeyParentSessionID

+ const KeyProviderModelResolved

+ const KeyProviderName

+ const KeyProviderRoute

+ const KeyProviderSystem

+ const KeyRequestModel

+ const KeyResponseModel

+ const KeyServerAddress

+ const KeyServerPort

+ const KeyServiceName

+ const KeySessionID

+ const KeyTimingCacheReadMS

+ const KeyTimingCacheWriteMS

+ const KeyTimingFirstTokenMS

+ const KeyTimingGenerationMS

+ const KeyTimingPrefillMS

+ const KeyTimingQueueMS

+ const KeyTokenType

+ const KeyToolCallID

+ const KeyToolExecutionIndex

+ const KeyToolName

+ const KeyToolType

+ const KeyTurnIndex

+ const KeyUsageCacheRead

+ const KeyUsageCacheWrite

+ const KeyUsageInput

+ const KeyUsageOutput

+ var InstrumentationName = productinfo.ConfigDir

+ var ProductName = productinfo.Name

+ var ServiceName = productinfo.ConfigDir

+ type ChatMetrics struct

+ Duration time.Duration

+ Err error

+ ResolvedModel string

+ ResponseModel string

+ Usage Usage

+ type ChatMetricsRecorder interface

+ RecordChatMetrics func(ctx context.Context, attrs ChatSpan, metrics ChatMetrics)

+ type ChatSpan struct

+ AttemptIndex int

+ ConversationID string

+ HarnessName string

+ HarnessVersion string

+ ParentSessionID string

+ ProviderName string

+ ProviderRoute string

+ ProviderSystem string

+ RequestedModel string

+ ResolvedModel string

+ ResponseModel string

+ ServerAddress string

+ ServerPort int

+ SessionID string

+ StartTime time.Time

+ TurnIndex int

+ type Config struct

+ Enabled bool

+ MeterProvider metric.MeterProvider

+ Pricing RuntimePricing

+ Shutdown func(context.Context) error

+ TracerProvider trace.TracerProvider

+ type Cost struct

+ Amount *float64

+ CacheReadPerM float64

+ CacheWritePerM float64

+ Currency string

+ InputPerMTok float64

+ OutputPerMTok float64

+ PricingRef string

+ Source string

+ type ExecuteToolSpan struct

+ ConversationID string

+ HarnessName string

+ HarnessVersion string

+ ParentSessionID string

+ SessionID string

+ ToolCallID string

+ ToolExecutionIndex int

+ ToolName string

+ ToolType string

+ TurnIndex int

+ type InvokeAgentSpan struct

+ AgentID string

+ AgentName string

+ AgentVersion string

+ ConversationID string

+ HarnessName string

+ HarnessVersion string

+ ParentSessionID string

+ SessionID string

+ type RuntimePricing map[string]map[string]Cost

+ type Telemetry interface

+ ResolveCost func(providerSystem, resolvedModel string) (Cost, bool)

+ Shutdown func(ctx context.Context)

+ StartChat func(ctx context.Context, attrs ChatSpan) (context.Context, trace.Span)

+ StartExecuteTool func(ctx context.Context, attrs ExecuteToolSpan) (context.Context, trace.Span)

+ StartInvokeAgent func(ctx context.Context, attrs InvokeAgentSpan) (context.Context, trace.Span)

+ func New(cfg Config) Telemetry

+ func NewNoop() Telemetry

+ type Usage struct

+ CacheRead int

+ CacheWrite int

+ Input int

+ Output int

+ Total int