tracers

type Executor interface {
	// Processor
	// 类进程.
	//
	// 获取具体执行器的类进程, 基于此类进程启动/退出服务.
	Processor() (processor process.Processor)

	// Publish
	// 发布链路.
	Publish(spans ...Span) (err error)

	// SetFormatter
	// 设置格式.
	SetFormatter(formatter Formatter)
}

type Formatter interface {
	// Byte
	// 转字符码.
	Byte(vs ...Span) (body []byte, err error)

	// String
	// 转字符串.
	String(vs ...Span) (str string, err error)
}

type OperatorManager interface {
	// Generator
	// ID生成器.
	Generator() (generator *id)

	// GetExecutor
	// 执行器.
	GetExecutor() (executor Executor)

	// GetResource
	// 基础资源.
	GetResource() (kv loggers.Kv)

	// Push
	// 推送跨度.
	Push(span Span)

	// SetExecutor
	// 设置执行器.
	SetExecutor(executor Executor)
}

type Span interface {
	ApplyRequest(req *http.Request)
	Child(name string) Span
	Context() context.Context
	Duration() time.Duration
	End()
	Kv() loggers.Kv
	Logger() SpanLogger
	Logs() []loggers.Log
	Name() string
	ParentSpanId() SpanId
	SpanId() SpanId
	StartTime() time.Time
	Trace() Trace
}

type SpanId [8]byte

type SpanLogger interface {
	// Add
	// 添加 Key/Value 键值对.
	Add(key string, value interface{}) SpanLogger

	Debug(text string, args ...interface{})
	Error(text string, args ...interface{})
	Fatal(text string, args ...interface{})
	Info(text string, args ...interface{})
	Warn(text string, args ...interface{})
}

type Trace interface {
	// Context
	// 上下文.
	Context() context.Context

	// Kv
	// 链路Key/Value属性.
	Kv() loggers.Kv

	// Name
	// 链路名.
	Name() string

	// New
	// 创建跨度.
	//
	// 基于 Trace 生成新的链路跨度 Span.
	New(name string) Span

	// SpanId
	// 跨度ID.
	SpanId() SpanId

	// TraceId
	// 链路ID.
	TraceId() TraceId
}

type TraceId [16]byte