知识卡片
创建子span要保留新上下文
Tracer从传入Context创建span时,同时返回包含新span的Context。后续子操作应继续传这个新Context,并在工作结束时End当前Span;只结束span而丢掉新Context,后续调用可能仍挂在旧父节点。原图把Start当成只返回一个span,需按官方接口校正。图中的依赖表示API返回与使用关系,不假定Context直接拥有可公开访问的span字段。
结构图:
classDiagram
class Context["context.Context"] {
<<interface>>
}
class Tracer {
<<interface>>
+Start(ctx, spanName, opts) (context.Context, Span)
}
class Span {
<<interface>>
+End(options)
}
Tracer ..> Context : 输入与返回上下文
Tracer ..> Span : 返回新span
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 遵照OpenTelemetry的探针 · 查看原书依据
在开始一个新的span时,必须从组件中获取OTel特定的tracer传递给上下文并更新: 此代码段允许你创建并命名上下文(例如,HTTP请求或gRPC的上下文)中已存在的任意span的子span,开启计时器计时,计算span的时长,然后在函数调用结束时执行的延迟(defer)中完成用于传输给后端的span。
参考来源
- 位置:《可观测性工程》第7章《遵照OpenTelemetry的探针》(来源项目:book-sources;源文件:extracted/可观测性工程/_epub-src/OEBPS/018.xhtml)
- 结论依据:原文的概念、案例或操作步骤支撑本卡解释;代码图仅作教学机制,已辨识的版本/排印问题不作可运行保证。
- 原始内容:在开始一个新的span时,必须从组件中获取OTel特定的tracer传递给上下文并更新: 此代码段允许你创建并命名上下文(例如,HTTP请求或gRPC的上下文)中已存在的任意span的子span,开启计时器计时,计算span的时长,然后在函数调用结束时执行的延迟(defer)中完成用于传输给后端的span。
- 图片依据:OEBPS/images/loftrg15tvf1ele4i1g.jpg、OEBPS/images/loftrf2eulb7dy9y0s8.jpg(均已实际查看;结构关系按正文和可辨代码解释)。
- 校正依据:[OpenTelemetry Go官方埋点文档](https://opentelemetry.io/docs/languages/go/instrumentation/)示例保留ctx与span两个返回值。本卡据此校正教学图,不把旧截图当成当前可编译API。