在 OpenTelemetry 中,otel.Tracer(name) 函数是如何创建和配置跟踪器的?

在 opentelemetry 中,otel.tracer(name) 函数是如何创建和配置跟踪器的?

otel.tracer(name) 源码解析

在 opentelemetry 源码中,otel.tracer(name) 函数用于获取或创建具有指定名称的跟踪器。跟踪器是一个负责收集跟踪信息的组件,包括跨度、日志和事件等。

函数签名

func tracer(name string, opts ...trace.traceroption) trace.tracer
  • name: 跟踪器名称。
  • opts: 可选的跟踪器选项,用于配置跟踪器行为。

实现

tracer 函数的实现位于 tracer.go 文件中。该函数首先获取跟踪器提供程序(tracerprovider),然后调用 tracerprovider.tracer 方法:

func tracer(name string, opts ...trace.traceroption) trace.tracer {
    return gettracerprovider().tracer(name, opts...)
}

tracerprovider.tracer() 方法

tracerprovider.tracer 方法查找给定名称的跟踪器,如果不存在则创建它:

func (p *tracerprovider) tracer(name string, opts ...trace.traceroption) trace.tracer {
    // ...

    c := trace.newtracerconfig(opts...)

    // ...

    if val, ok := p.tracers[key]; ok {
        return val
    }

    // ...
}

newtracerconfig() 函数

newtracerconfig 函数创建一个新的跟踪器配置,它允许用户指定跟踪器的各种选项,例如采样率、日志等级和导出器。

func newtracerconfig(options ...traceroption) tracerconfig {
    var config tracerconfig
    for _, option := range options {
        config = option.apply(config)
    }
    return config
}

疑问:option.apply(config) 行

在 newtracerconfig 函数中,有一个名为 option.apply(config) 的行。这个 option 是一个实现了 traceroption 接口的类型。该接口有一个 apply 方法,用于更新给定的跟踪器配置:

type TracerOption interface {
    apply(TracerConfig) TracerConfig
}

总结

总的来说,otel.tracer() 函数允许用户获取或创建具有指定名称的跟踪器。可以通过传递 traceroption 参数来配置跟踪器行为。这些选项通常用于定制采样、日志记录和导出行为。

以上就是在 OpenTelemetry 中,otel.Tracer(name) 函数是如何创建和配置跟踪器的?的详细内容,更多请关注其它相关文章!