README
¶
Trace
Jaeger
To try out the OTLP exporter, since v1.35.0 you can run Jaeger as an OTLP endpoint and for trace visualization in a Docker container:
docker run -d --name jaeger \
-e COLLECTOR_OTLP_ENABLED=true \
-p 16686:16686 \
-p 4317:4317 \
-p 4318:4318 \
jaegertracing/all-in-one:latest
- otlp go sdk 使用方法: https://opentelemetry.io/docs/languages/go/exporters/
- jaeger 端口说明: https://www.jaegertracing.io/docs/1.55/getting-started/#all-in-one
采样策略
TraceIDRatioBased(ratio float64) 确实是一个百分比采样器：参数范围：0.0 到 1.0 之间的浮点数
- 0.0：不采样任何 trace（0%）
- 0.5：采样 50% 的请求
- 1.0：采样所有请求（100%）
工作原理：基于 TraceID 进行哈希计算，确保相同的 TraceID 在不同服务中会有相同的采样决策
推荐的采样策略:
前端/网关 (采样率: 10%)
↓
你的Go服务 (ParentBased + 根采样率: 0%)
↓
结果: 只有那10%被网关采样的请求会在你的服务中产生trace
生产环境注意事项
- 监控导出器状态：添加健康检查监控导出器是否正常工作
- 错误处理：妥善处理导出失败的情况，避免影响主业务
- 性能调优：根据实际流量调整批量处理参数
- 安全配置：生产环境使用 TLS 和认证
- 避免 stdout：生产环境不要使用 stdout exporter
配置
[trace]
enable = true
endpoint = "127.0.0.1:4318"
Documentation
¶
Index ¶
Constants ¶
View Source
const (
AppName = "trace"
)
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type TRACE_PROVIDER ¶
type TRACE_PROVIDER string
const ( // 标准otlp http协议 TRACE_PROVIDER_OTLP TRACE_PROVIDER = "otlp" // 开发环境使用 TRACE_PROVIDER_STDOUT TRACE_PROVIDER = "stdout" )
type Trace ¶ added in v2.0.3
type Trace struct {
ioc.ObjectImpl
Enable bool `json:"enable" yaml:"enable" toml:"enable" env:"ENABLE"`
Provider TRACE_PROVIDER `toml:"provider" json:"provider" yaml:"provider" env:"PROVIDER"`
Endpoint string `toml:"endpoint" json:"endpoint" yaml:"endpoint" env:"ENDPOINT"`
Insecure bool `toml:"insecure" json:"insecure" yaml:"insecure" env:"INSECURE"`
// 采样率配置
TraceIDRatio float64 `toml:"trace_id_ratio" json:"trace_id_ratio" yaml:"trace_id_ratio" env:"TRACE_ID_RATIO"`
// 上报配置
BatchTimeout time.Duration `toml:"batch_timeout" json:"batch_timeout" yaml:"batch_timeout" env:"BATCH_TIMEOUT"`
MaxExportBatchSize int `toml:"max_export_batch_size" json:"max_export_batch_size" yaml:"max_export_batch_size" env:"MAX_EXPORT_BATCH_SIZE"`
MaxQueueSize int `toml:"max_queue_size" json:"max_queue_size" yaml:"max_queue_size" env:"MAX_QUEUE_SIZE"`
// contains filtered or unexported fields
}
func (*Trace) Init ¶ added in v2.0.3
otlp go sdk 使用方法: https://opentelemetry.io/docs/languages/go/exporters/ jaeger 端口说明: https://www.jaegertracing.io/docs/1.55/getting-started/#all-in-one
Source Files
Click to show internal directories.
Click to hide internal directories.