›

OpenTracing API

Elastic APM Go 代理提供了一个 OpenTracing API 的实现，它建立在 Elastic APM 核心 API 之上。

通过 OpenTracing API 创建的 Span 将被转换为 Elastic APM 事务或 Span。根 Span 和使用远程 Span 上下文创建的 Span 将被转换为 Elastic APM 事务。所有其他 Span 将被创建为 Elastic APM Span。

初始化追踪器

编辑

OpenTracing API 实现是在 Elastic APM 核心 API 之上构建的桥接器。要初始化 OpenTracing 追踪器实现，必须首先导入 apmot 包。

import (
	"go.elastic.co/apm/module/apmot/v2"
)

apmot 包导出一个函数“New”，它返回 opentracing.Tracer 接口的实现。如果在不带任何参数的情况下调用 apmot.New()，则返回的追踪器将包装 apm.DefaultTracer()。如果希望使用不同的 apm.Tracer，则可以使用 apmot.New(apmot.WithTracer(t)) 传递它。

otTracer := apmot.New()

获得 opentracing.Tracer 后，使用标准 OpenTracing API 将 Span 报告给 Elastic APM。有关 OpenTracing Go API 的文档，请参考 opentracing-go。

import (
	"context"

	"go.elastic.co/apm/module/apmot/v2"

	"github.com/opentracing/opentracing-go"
)

func main() {
	opentracing.SetGlobalTracer(apmot.New())

	parent, ctx := opentracing.StartSpanFromContext(context.Background(), "parent")
	child, _ := opentracing.StartSpanFromContext(ctx, "child")
	child.Finish()
	parent.Finish()
}

混合使用原生 API 和 OpenTracing API

编辑

导入 apmot 后，使用原生 API 创建的事务和 Span 将作为 OpenTracing Span 提供，使您可以混合使用原生 API 和 OpenTracing API。例如：

// Transaction created through native API.
transaction := apm.DefaultTracer().StartTransaction("GET /", "request")
ctx := apm.ContextWithTransaction(context.Background(), transaction)

// Span created through OpenTracing API will be a child of the transaction.
otSpan, ctx := opentracing.StartSpanFromContext(ctx, "ot-span")

// Span created through the native API will be a child of the span created
// above via the OpenTracing API.
apmSpan, ctx := apm.StartSpan(ctx, "apm-span", "apm-span")

opentracing.SpanFromContext 函数将返回一个包装了 apm.Span 或 apm.Transaction 的 opentracing.Span。这些 Span 对象仅用于在通过 OpenTracing API 创建新 Span 时传递上下文，并且不是完全功能性的 Span。特别是，Finish 和 Log* 方法是空操作，而 Tracer 方法返回一个空操作追踪器。

Elastic APM 特定标签

编辑

Elastic APM 定义了一些未包含在 OpenTracing API 中但在 Elastic APM 上下文中相关的标签。某些标签仅与 Elastic APM 事务相关。

type - 设置事务或 Span 的类型，例如“request”或“ext.http”。如果未指定 type，则可以从其他标签推断类型。例如，如果指定了“http.url”，则事务的类型将为“request”，Span 的类型将为“ext.http”。如果无法推断出任何类型，则将其设置为“unknown”。

以下标签仅与被转换为 Elastic APM 事务的根 Span 或服务入口 Span 相关