Grafana Tempo 2.8 版本特性详解TraceQL 指标函数、内存优化与升级注意事项【免费下载链接】tempoGrafana Tempo is a high volume, minimal dependency distributed tracing backend.项目地址: https://gitcode.com/GitHub_Trending/tempo1/tempoTempo 2.8 是 Grafana Tempo 分布式链路追踪后端的一次重要版本更新核心亮点集中在三个方面为 TraceQL 增加了topk/bottomk排序函数、sum_over_time聚合函数与most_recent实验性查询提示帮助用户在成百上千的服务与端点中快速定位异常通过去除大 trace 的内存池化、迭代器优化与背压机制显著降低内存与查询开销同时在安全与运维层面落地了更安全的默认配置端口 3200、distroless 镜像、Go 1.24与若干破坏性变更。读完本文你将完整掌握 Tempo 2.8 新增 TraceQL 语法的用法、性能优化的实现思路、以及升级时必须处理的配置变更与安全修复清单。本文以 docs/sources/tempo/release-notes/version-2/v2-8.md 为骨架结合仓库源码如 pkg/traceql 下的解析器与执行引擎对各项特性做纵深补充。新增 TraceQL 语言特性Tempo 2.8 为 TraceQL 引入了三项强大的查询增强在 Grafana Cloud 中查询 trace 时拥有更高的灵活性与性能使用新的topk(n)与bottomk(n)函数对指标排序快速获得排名最高/最低的时间序列使用sum_over_time()按时间步长聚合数值实现内置的累计求和如总字节数、错误计数通过实验性的most_recenttrue查询提示优先取回最新 trace。指标排序函数 topk / bottomk在分析跨越数百上千个服务或端点的延迟、错误率、吞吐量时很容易在海量数据中迷失方向。过去你必须拉回全量聚合结果再人工检查或后处理才能找出最差或最好的对象。现在借助topk(n)与bottomk(n)可以在一条高效的查询中立即将视野收窄到排名前 n 或后 n 的 span 序列既节省时间又减少了后续需要扫描的数据量。其基本用法如下{} | avg_over_time(span:duration) by (span:name) | topk(10) {} | count_over_time() by (span:name) | bottomk(10)这两个函数都是第二级second stage函数作用于第一级聚合的中间结果topk(n)返回第一级聚合中取值最高的 n 个序列bottomk(n)返回取值最低的 n 个序列。从仓库源码看topk、bottomk作为关键字注册在 pkg/traceql/lexer.go 的 token 表中其执行语义定义在 pkg/traceql/ast_metrics.go 中String()方法分别返回topk与bottomk。pkg/traceql/test_examples.yaml 中收录了大量组合用法例如{} | rate() | topk(10) {} | rate() by (span.client_ip) | topk(10) {} | count_over_time() by (name) | topk(10) with(sample0.1) {} | quantile_over_time(duration, 0, 0.9, 1) by (span.http.path) | topk(10) ({} | rate()) ({} | rate()) | topk(5) 10可以看出topk/bottomk可以与rate()、count_over_time()、quantile_over_time()、avg_over_time()等第一级聚合自由组合甚至可以出现在算术表达式之后、与比较运算符连用如topk(5) 10实现“排名 阈值过滤”的复合筛选。sum_over_time 聚合函数sum_over_time()用于对数值型属性做累加聚合求和的时间区间由step参数决定。典型用法{ span.http.response_content_length 0 } | sum_over_time(span.http.response_content_length)有了sum_over_time()你可以在 TraceQL 内部直接计算累计和例如总传输字节数、总错误计数或资源消耗随时间的变化{} | sum_over_time(span.http.response_content_length)在每个 step 区间内sum_over_time(attr)会对所有匹配 span 的attr取值求和。该函数在 pkg/traceql/lexer.go 中注册为SUM_OVER_TIMEtoken与min_over_time、max_over_time、avg_over_time同属metricsAggregateSumOverTime一类聚合参见 pkg/traceql/ast_metrics.go。pkg/traceql/test_examples.yaml 中给出的示例{} | sum_over_time(duration) by (span.http.path)表明它还支持按标签分组后分别求和。实验性查询提示 most_recenttrue排查线上事故或监控生产健康时你往往需要最先看到最新的trace。默认情况下 Tempo 查询引擎偏向速度只返回最先匹配到的前 N 条 trace这些不一定是最新的。most_recent提示确保你始终看到最新数据从而避免因提前达到行数上限而错过最新的错误或性能回退。示例{} with (most_recenttrue) { span.foo bar } { status error } with (most_recenttrue)当设置most_recenttrue时Tempo 会在数据分片上执行更深的搜索、保留最新候选并按开始时间排序返回结果而不是在首次命中上限时就停止。该提示可作用于任何TraceQL 选择查询。从源码看most_recent是 pkg/traceql/enum_hints.go 中集中登记的查询提示之一HintMostRecent并被标记为非危险提示isUnsafe返回 false。在查询前端modules/frontend/search_sharder.go 通过MostRecentShards配置默认值 200见 modules/frontend/search_sharder.go控制该模式下用于回溯的 shard 数量因此更深的搜索也会带来更多的工作量。按父 span ID 查询2.8 还支持按父 span 的 ID 查询。使用span:parentID内在字段可以确保查询结果是指定父 span 的子 span这在 span 链接等场景中非常实用。该内在字段定义于 pkg/traceql/enum_attributes.goIntrinsicParentID对应的字符串形式为span:parentID见 pkg/traceql/enum_attributes.go并可通过span:parentID反向解析见 pkg/traceql/enum_attributes.go。主要的性能与内存改进Tempo 2.8 移除了大 trace 的池化pooling。测试表明移除大对象池化显著改善了内存占用在高流量/多租户部署下将内存高水位线high-water mark降低到不到原来的一半。不过仍保留部分池化以保证 CPU、吞吐量与 GC 频率处于合理水平现在使用固定的1M 默认分配大小足以覆盖大多数 trace。官方发布的 compactor 内存曲线图显示在 PR 4985 合入后 compactor 的内存占用获得了大幅改善该 PR 同时附有基准测试结果。性能改进清单TraceQL 与 Tempo 整体在本版本中获得了一系列性能提升还原 EqualRowNumber 为可内联函数以提升 TraceQL 性能PR 4705利用 max definition level 优化迭代器在 nexting大型查询中频繁调用的操作时忽略 RowNumber 的部分内容即使是微小的改进也会带来显著收益PR 4753增大 query-frontend 默认批处理大小TraceQL 性能已足以在一次 querier 上传递更大的批次并完成全部任务PR 4844改进 Tempo 构建选项PR 4755使用 rebatching 重写 tracePR 4690重排 span 迭代器PR 4754通过缓冲池化改进 memcached 内存占用PR 4970。特性与增强本节概括 Tempo 2.8 中最重要的特性与增强。TraceQL 正确性修复正确性correctness是本次版本的重点改进方向之一主要包括修复{.foo true}与{.foo || false}这类查询的行为PR 4855使与 nil 的比较对称化PR 4869修正 select 操作之后额外 spanset 过滤器导致的结果错误PR 4600修复非专用列non-dedicated columns中多个过滤器且按同一变量分组时 TraceQL 指标结果错误的问题PR 4887修复所有非平凡指标non-trivial metrics的流式输出PR 4624修复{} { span.attr-that-doesnt-exist ! foo }的行为PR 5007修复 query range 的各类边界情况PR 4962从compare()函数中排除nestedSetParent等其他值PR 5196。由于 query frontend 在执行 TraceQL 时会缓存单个 block 的任务结果这些修复也会影响缓存行为修复以.0结尾的浮点数导致的 TraceQL 结果缓存 bugPR 4539正确缓存 TraceQL 指标中 query range 的前端任务PR 4771修复 TraceQL 指标查询前端缓存 key 生成时的碰撞问题PR 5017。TraceQL 样例exemplar改进与修复Tempo 2.8 改善了 TraceQL 指标中的 exemplar将 exemplar 按时间分布并对 exemplar 数量设置硬上限PR 5158为直方图与分位数选择正确的 exemplarPR 5145修复被查询 exemplar 数量的问题PR 5115。此外在安全修复中还专门为 TraceQL 指标查询的 exemplar 提示增加了上限以防止无界内存分配对应 CVE-2026-27878。错误处理与日志改进Tempo 更新了错误处理方式使排障更简单更新 query range 错误消息PR 4929当 trace 大小超过速率限制时改进限流错误消息PR 4986恢复 compactor 中已完成 block 的专用列日志PR 4832query-frontend 日志在日志行中附加消息PR 4975。其他增强为TraceByID端点新增吞吐量 SLO 与指标可通过throughput_bytes_slo字段配置并会在 SLO 与吞吐量指标中填充optraces标签PR 4668防止 ingester 中的查询阻塞 trace 落盘与内存尖峰PR 4483Host Info Processor 现在在指标中跟踪标识主机的资源属性PR 5152distributor 新增 IPv6 支持PR 4840为 mutex 与阻塞值添加默认值PR 4979。升级注意事项升级到 Tempo 2.8 时需要注意以下破坏性变更与注意事项。默认监听端口变更Tempo 2.8 将默认http_listen_port从 80 改为3200。请检查 Tempo 配置文件中server:块的配置项server: # HTTP server listen host [http_listen_address: string] # HTTP server listen port [http_listen_port: int | default 3200]该变更的动机详见讨论 issue 4945实现于 PR 4960核心是让默认配置不再依赖特权端口从而降低部署与运维成本。移除 Tempo serverlessTempo serverless 已被移除以下配置项不再有效应从 Tempo 配置中删除PR 4599querier: search: prefer_self: int external_hedge_requests_at: duration external_hedge_requests_up_to: duration external_backend: string google_cloud_run: string external_endpoints: array此外以下与 serverless 相关的指标也已移除tempo_querier_external_endpoint_duration_seconds、tempo_querier_external_endpoint_hedged_roundtrips_total、tempo_feature_enabled。更新、移除或重命名的配置参数参数说明max_span_attr_byte重命名为max_attribute_bytesPR 4633tempo_discarded_spans_total从tempo_discarded_spans_total中移除internal_error原因PR 4554tempo_receiver_accepted_span与tempo_receiver_refused_spansname维度从tempo/jaeger_receiver变为jaeger/jaeger_receiverPR 4893其他升级注意点OTEL Collector 升级到 v0.122.1tempo_receiver_accepted_span与tempo_receiver_refused_spans的name维度从tempo/jaeger_receiver变为jaeger/jaeger_receiverPR 4893Tempo query 中将以otelgrpc替换opentracing-contrib/go-grpcPR 4958在 event、link 与 instrumentation scope 级别强制 max attribute size配置改为按租户per-tenant并将max_span_attr_byte重命名为max_attribute_bytesPR 4633SLO 指标query_frontend_bytes_processed_per_second从 histogram 转为 counter性能更高PR 4748移除已被弃用的 OpenTelemetry Jaeger exporterPR 4926。安全修复Tempo 2.8 在安全方面进行了密集的依赖升级与加固按补丁版本汇总如下。2.8.4Go 升级至 1.26.2修复 CVE-2026-25679PR 6800gRPC 模块补丁至 v1.79.3、go.opentelemetry.io/otel/sdk升级至 v1.40.0修复 CVE-2026-33186 与 CVE-2026-39883PR 6899otlptracehttp升级至 v1.43.0修复 CVE-2026-39882PR 6890otlpmetrichttp升级至 v1.43.0修复 CVE-2026-39882PR 6889github.com/go-jose/go-jose/v4升级至 v4.1.4修复 CVE-2026-34986PR 6908github.com/antchfx/xpath升级至 v1.3.6修复 CVE-2026-32287PR 6763为 TraceQL 指标查询的 exemplar 提示设置上限防止无界内存分配修复 CVE-2026-27878PR 6792将搜索的默认max_result_limit设为262144256×1024。此前默认值0允许无界搜索结果集修复 CVE-2026-21728PR 6525。2.8.3Go 升级至 1.25.5修复 CVE-2025-61729、CVE-2025-47907、CVE-2025-58183 与 CVE-2025-61727PR 6089、6096、6227github.com/expr-lang/expr升级至 v1.17.7修复 CVE-2025-68156PR 6230、6092。2.8.2Go 升级至 1.24.4修复 CVE-2025-22874、CVE-2025-4673、CVE-2025-0913 与 GHSA-FV92-FJC5-JJ9HPR 5323。2.8.0采用 distroless 基础容器镜像以提升安全性PR 4556Go 升级至 1.24.3PR 5110。Bug 修复摘要除上述内容外Tempo 2.8 各补丁版本还包含以下重要修复。2.8.3修复无效查询api/v2/search/tagsSearchTagsV2时的死锁PR 5607、6228修复query_rangeHTTP 处理中因取消或其他错误可能触发的 panicPR 5667、6229修复某些配置项总是被运行时 overrides 覆盖、导致无法在不使用 overrides 配置的情况下设置的问题PR 5202修复 ingester 中 trace 空闲周期未正确生效的问题并新增 max live trace period默认 30s防止跨长时间滴灌 span 的超大 trace 被无限期驻留内存PR 5346修复SearchTagValuesV2端点提供无效 tag 名称时应返回 400 Bad Request 而非 500 Internal Server ErrorPR 5493。2.8.2为partitionAssignmentVar增加 nil 检查PR 5198修正 instant query 计算PR 5252修复 distributor HTTP 写入请求中的 tracing context 传播PR 5312修复短 trace ID 的trace:id搜索PR 5331修复查询同时覆盖 ingester 与少量其他 block 时most_recenttrue不返回最新结果的问题PR 5438修复avg_over_time聚合期间 counter series 缺失时的 panicPR 5300。2.8.1修复 ingester 中哈希碰撞导致 span 存储错误的问题PR 5276。2.8.0为 gRPC 流式 query range 请求选择默认 step若未提供并正确复制| rate()等指标在 gRPC 流式传输时的 exemplarPR 4576修复 distributor 中哈希碰撞导致 span 存储错误的问题PR 5186在 ReadRange 的缓存 key 中加入对象名PR 4982修复压缩compaction期间罕见的 panicPR 4915若查询中已过滤某 tag则将操作数作为唯一值返回PR 4673从默认配置转换为旧版配置时包含成本归属PR 4937memcached 尊重被取消的 context 以防止 panicPR 5041修复通过 API 设置用户配置 overrides 中的 processorsPR 4741修复启动时的 panicPR 4744修复超出最大 tag 查询响应大小时内在 tag 查询被丢弃的问题PR 4784修复 SyncIterator 中的错误传播PR 5045修复 mixin 以包含otlp_v1_tracesHTTP 写入路由PR 5072修复TempoBlockListRisingQuickly告警分组PR 4876修复 metrics generator host info processor 的 overrides 配置PR 5118修复 metrics generatortarget_info跳过无名称属性以防止下游错误PR 5148。总结Tempo 2.8 是一次兼顾查询能力增强与资源占用瘦身的版本topk/bottomk与sum_over_time让 TraceQL 指标查询从拉全量再后处理进化为一条查询直接出排名与累计值most_recenttrue与span:parentID则补齐了排障与 span 关联场景的拼图大 trace 池化移除与迭代器优化把 compactor 等环节的内存高水位线大幅压低。升级前请务必核对本文升级注意事项部分的端口变更、serverless 配置删除、max_attribute_bytes重命名等破坏性变更并参考各补丁版本的安全修复清单及时跟进依赖版本。【免费下载链接】tempoGrafana Tempo is a high volume, minimal dependency distributed tracing backend.项目地址: https://gitcode.com/GitHub_Trending/tempo1/tempo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Grafana Tempo 2.8 版本特性详解TraceQL 指标函数、内存优化与升级注意事项【免费下载链接】tempoGrafana Tempo is a high volume, minimal dependency distributed tracing backend.项目地址: https://gitcode.com/GitHub_Trending/tempo1/tempoTempo 2.8 是 Grafana Tempo 分布式链路追踪后端的一次重要版本更新核心亮点集中在三个方面为 TraceQL 增加了topk/bottomk排序函数、sum_over_time聚合函数与most_recent实验性查询提示帮助用户在成百上千的服务与端点中快速定位异常通过去除大 trace 的内存池化、迭代器优化与背压机制显著降低内存与查询开销同时在安全与运维层面落地了更安全的默认配置端口 3200、distroless 镜像、Go 1.24与若干破坏性变更。读完本文你将完整掌握 Tempo 2.8 新增 TraceQL 语法的用法、性能优化的实现思路、以及升级时必须处理的配置变更与安全修复清单。本文以 docs/sources/tempo/release-notes/version-2/v2-8.md 为骨架结合仓库源码如 pkg/traceql 下的解析器与执行引擎对各项特性做纵深补充。新增 TraceQL 语言特性Tempo 2.8 为 TraceQL 引入了三项强大的查询增强在 Grafana Cloud 中查询 trace 时拥有更高的灵活性与性能使用新的topk(n)与bottomk(n)函数对指标排序快速获得排名最高/最低的时间序列使用sum_over_time()按时间步长聚合数值实现内置的累计求和如总字节数、错误计数通过实验性的most_recenttrue查询提示优先取回最新 trace。指标排序函数 topk / bottomk在分析跨越数百上千个服务或端点的延迟、错误率、吞吐量时很容易在海量数据中迷失方向。过去你必须拉回全量聚合结果再人工检查或后处理才能找出最差或最好的对象。现在借助topk(n)与bottomk(n)可以在一条高效的查询中立即将视野收窄到排名前 n 或后 n 的 span 序列既节省时间又减少了后续需要扫描的数据量。其基本用法如下{} | avg_over_time(span:duration) by (span:name) | topk(10) {} | count_over_time() by (span:name) | bottomk(10)这两个函数都是第二级second stage函数作用于第一级聚合的中间结果topk(n)返回第一级聚合中取值最高的 n 个序列bottomk(n)返回取值最低的 n 个序列。从仓库源码看topk、bottomk作为关键字注册在 pkg/traceql/lexer.go 的 token 表中其执行语义定义在 pkg/traceql/ast_metrics.go 中String()方法分别返回topk与bottomk。pkg/traceql/test_examples.yaml 中收录了大量组合用法例如{} | rate() | topk(10) {} | rate() by (span.client_ip) | topk(10) {} | count_over_time() by (name) | topk(10) with(sample0.1) {} | quantile_over_time(duration, 0, 0.9, 1) by (span.http.path) | topk(10) ({} | rate()) ({} | rate()) | topk(5) 10可以看出topk/bottomk可以与rate()、count_over_time()、quantile_over_time()、avg_over_time()等第一级聚合自由组合甚至可以出现在算术表达式之后、与比较运算符连用如topk(5) 10实现“排名 阈值过滤”的复合筛选。sum_over_time 聚合函数sum_over_time()用于对数值型属性做累加聚合求和的时间区间由step参数决定。典型用法{ span.http.response_content_length 0 } | sum_over_time(span.http.response_content_length)有了sum_over_time()你可以在 TraceQL 内部直接计算累计和例如总传输字节数、总错误计数或资源消耗随时间的变化{} | sum_over_time(span.http.response_content_length)在每个 step 区间内sum_over_time(attr)会对所有匹配 span 的attr取值求和。该函数在 pkg/traceql/lexer.go 中注册为SUM_OVER_TIMEtoken与min_over_time、max_over_time、avg_over_time同属metricsAggregateSumOverTime一类聚合参见 pkg/traceql/ast_metrics.go。pkg/traceql/test_examples.yaml 中给出的示例{} | sum_over_time(duration) by (span.http.path)表明它还支持按标签分组后分别求和。实验性查询提示 most_recenttrue排查线上事故或监控生产健康时你往往需要最先看到最新的trace。默认情况下 Tempo 查询引擎偏向速度只返回最先匹配到的前 N 条 trace这些不一定是最新的。most_recent提示确保你始终看到最新数据从而避免因提前达到行数上限而错过最新的错误或性能回退。示例{} with (most_recenttrue) { span.foo bar } { status error } with (most_recenttrue)当设置most_recenttrue时Tempo 会在数据分片上执行更深的搜索、保留最新候选并按开始时间排序返回结果而不是在首次命中上限时就停止。该提示可作用于任何TraceQL 选择查询。从源码看most_recent是 pkg/traceql/enum_hints.go 中集中登记的查询提示之一HintMostRecent并被标记为非危险提示isUnsafe返回 false。在查询前端modules/frontend/search_sharder.go 通过MostRecentShards配置默认值 200见 modules/frontend/search_sharder.go控制该模式下用于回溯的 shard 数量因此更深的搜索也会带来更多的工作量。按父 span ID 查询2.8 还支持按父 span 的 ID 查询。使用span:parentID内在字段可以确保查询结果是指定父 span 的子 span这在 span 链接等场景中非常实用。该内在字段定义于 pkg/traceql/enum_attributes.goIntrinsicParentID对应的字符串形式为span:parentID见 pkg/traceql/enum_attributes.go并可通过span:parentID反向解析见 pkg/traceql/enum_attributes.go。主要的性能与内存改进Tempo 2.8 移除了大 trace 的池化pooling。测试表明移除大对象池化显著改善了内存占用在高流量/多租户部署下将内存高水位线high-water mark降低到不到原来的一半。不过仍保留部分池化以保证 CPU、吞吐量与 GC 频率处于合理水平现在使用固定的1M 默认分配大小足以覆盖大多数 trace。官方发布的 compactor 内存曲线图显示在 PR 4985 合入后 compactor 的内存占用获得了大幅改善该 PR 同时附有基准测试结果。性能改进清单TraceQL 与 Tempo 整体在本版本中获得了一系列性能提升还原 EqualRowNumber 为可内联函数以提升 TraceQL 性能PR 4705利用 max definition level 优化迭代器在 nexting大型查询中频繁调用的操作时忽略 RowNumber 的部分内容即使是微小的改进也会带来显著收益PR 4753增大 query-frontend 默认批处理大小TraceQL 性能已足以在一次 querier 上传递更大的批次并完成全部任务PR 4844改进 Tempo 构建选项PR 4755使用 rebatching 重写 tracePR 4690重排 span 迭代器PR 4754通过缓冲池化改进 memcached 内存占用PR 4970。特性与增强本节概括 Tempo 2.8 中最重要的特性与增强。TraceQL 正确性修复正确性correctness是本次版本的重点改进方向之一主要包括修复{.foo true}与{.foo || false}这类查询的行为PR 4855使与 nil 的比较对称化PR 4869修正 select 操作之后额外 spanset 过滤器导致的结果错误PR 4600修复非专用列non-dedicated columns中多个过滤器且按同一变量分组时 TraceQL 指标结果错误的问题PR 4887修复所有非平凡指标non-trivial metrics的流式输出PR 4624修复{} { span.attr-that-doesnt-exist ! foo }的行为PR 5007修复 query range 的各类边界情况PR 4962从compare()函数中排除nestedSetParent等其他值PR 5196。由于 query frontend 在执行 TraceQL 时会缓存单个 block 的任务结果这些修复也会影响缓存行为修复以.0结尾的浮点数导致的 TraceQL 结果缓存 bugPR 4539正确缓存 TraceQL 指标中 query range 的前端任务PR 4771修复 TraceQL 指标查询前端缓存 key 生成时的碰撞问题PR 5017。TraceQL 样例exemplar改进与修复Tempo 2.8 改善了 TraceQL 指标中的 exemplar将 exemplar 按时间分布并对 exemplar 数量设置硬上限PR 5158为直方图与分位数选择正确的 exemplarPR 5145修复被查询 exemplar 数量的问题PR 5115。此外在安全修复中还专门为 TraceQL 指标查询的 exemplar 提示增加了上限以防止无界内存分配对应 CVE-2026-27878。错误处理与日志改进Tempo 更新了错误处理方式使排障更简单更新 query range 错误消息PR 4929当 trace 大小超过速率限制时改进限流错误消息PR 4986恢复 compactor 中已完成 block 的专用列日志PR 4832query-frontend 日志在日志行中附加消息PR 4975。其他增强为TraceByID端点新增吞吐量 SLO 与指标可通过throughput_bytes_slo字段配置并会在 SLO 与吞吐量指标中填充optraces标签PR 4668防止 ingester 中的查询阻塞 trace 落盘与内存尖峰PR 4483Host Info Processor 现在在指标中跟踪标识主机的资源属性PR 5152distributor 新增 IPv6 支持PR 4840为 mutex 与阻塞值添加默认值PR 4979。升级注意事项升级到 Tempo 2.8 时需要注意以下破坏性变更与注意事项。默认监听端口变更Tempo 2.8 将默认http_listen_port从 80 改为3200。请检查 Tempo 配置文件中server:块的配置项server: # HTTP server listen host [http_listen_address: string] # HTTP server listen port [http_listen_port: int | default 3200]该变更的动机详见讨论 issue 4945实现于 PR 4960核心是让默认配置不再依赖特权端口从而降低部署与运维成本。移除 Tempo serverlessTempo serverless 已被移除以下配置项不再有效应从 Tempo 配置中删除PR 4599querier: search: prefer_self: int external_hedge_requests_at: duration external_hedge_requests_up_to: duration external_backend: string google_cloud_run: string external_endpoints: array此外以下与 serverless 相关的指标也已移除tempo_querier_external_endpoint_duration_seconds、tempo_querier_external_endpoint_hedged_roundtrips_total、tempo_feature_enabled。更新、移除或重命名的配置参数参数说明max_span_attr_byte重命名为max_attribute_bytesPR 4633tempo_discarded_spans_total从tempo_discarded_spans_total中移除internal_error原因PR 4554tempo_receiver_accepted_span与tempo_receiver_refused_spansname维度从tempo/jaeger_receiver变为jaeger/jaeger_receiverPR 4893其他升级注意点OTEL Collector 升级到 v0.122.1tempo_receiver_accepted_span与tempo_receiver_refused_spans的name维度从tempo/jaeger_receiver变为jaeger/jaeger_receiverPR 4893Tempo query 中将以otelgrpc替换opentracing-contrib/go-grpcPR 4958在 event、link 与 instrumentation scope 级别强制 max attribute size配置改为按租户per-tenant并将max_span_attr_byte重命名为max_attribute_bytesPR 4633SLO 指标query_frontend_bytes_processed_per_second从 histogram 转为 counter性能更高PR 4748移除已被弃用的 OpenTelemetry Jaeger exporterPR 4926。安全修复Tempo 2.8 在安全方面进行了密集的依赖升级与加固按补丁版本汇总如下。2.8.4Go 升级至 1.26.2修复 CVE-2026-25679PR 6800gRPC 模块补丁至 v1.79.3、go.opentelemetry.io/otel/sdk升级至 v1.40.0修复 CVE-2026-33186 与 CVE-2026-39883PR 6899otlptracehttp升级至 v1.43.0修复 CVE-2026-39882PR 6890otlpmetrichttp升级至 v1.43.0修复 CVE-2026-39882PR 6889github.com/go-jose/go-jose/v4升级至 v4.1.4修复 CVE-2026-34986PR 6908github.com/antchfx/xpath升级至 v1.3.6修复 CVE-2026-32287PR 6763为 TraceQL 指标查询的 exemplar 提示设置上限防止无界内存分配修复 CVE-2026-27878PR 6792将搜索的默认max_result_limit设为262144256×1024。此前默认值0允许无界搜索结果集修复 CVE-2026-21728PR 6525。2.8.3Go 升级至 1.25.5修复 CVE-2025-61729、CVE-2025-47907、CVE-2025-58183 与 CVE-2025-61727PR 6089、6096、6227github.com/expr-lang/expr升级至 v1.17.7修复 CVE-2025-68156PR 6230、6092。2.8.2Go 升级至 1.24.4修复 CVE-2025-22874、CVE-2025-4673、CVE-2025-0913 与 GHSA-FV92-FJC5-JJ9HPR 5323。2.8.0采用 distroless 基础容器镜像以提升安全性PR 4556Go 升级至 1.24.3PR 5110。Bug 修复摘要除上述内容外Tempo 2.8 各补丁版本还包含以下重要修复。2.8.3修复无效查询api/v2/search/tagsSearchTagsV2时的死锁PR 5607、6228修复query_rangeHTTP 处理中因取消或其他错误可能触发的 panicPR 5667、6229修复某些配置项总是被运行时 overrides 覆盖、导致无法在不使用 overrides 配置的情况下设置的问题PR 5202修复 ingester 中 trace 空闲周期未正确生效的问题并新增 max live trace period默认 30s防止跨长时间滴灌 span 的超大 trace 被无限期驻留内存PR 5346修复SearchTagValuesV2端点提供无效 tag 名称时应返回 400 Bad Request 而非 500 Internal Server ErrorPR 5493。2.8.2为partitionAssignmentVar增加 nil 检查PR 5198修正 instant query 计算PR 5252修复 distributor HTTP 写入请求中的 tracing context 传播PR 5312修复短 trace ID 的trace:id搜索PR 5331修复查询同时覆盖 ingester 与少量其他 block 时most_recenttrue不返回最新结果的问题PR 5438修复avg_over_time聚合期间 counter series 缺失时的 panicPR 5300。2.8.1修复 ingester 中哈希碰撞导致 span 存储错误的问题PR 5276。2.8.0为 gRPC 流式 query range 请求选择默认 step若未提供并正确复制| rate()等指标在 gRPC 流式传输时的 exemplarPR 4576修复 distributor 中哈希碰撞导致 span 存储错误的问题PR 5186在 ReadRange 的缓存 key 中加入对象名PR 4982修复压缩compaction期间罕见的 panicPR 4915若查询中已过滤某 tag则将操作数作为唯一值返回PR 4673从默认配置转换为旧版配置时包含成本归属PR 4937memcached 尊重被取消的 context 以防止 panicPR 5041修复通过 API 设置用户配置 overrides 中的 processorsPR 4741修复启动时的 panicPR 4744修复超出最大 tag 查询响应大小时内在 tag 查询被丢弃的问题PR 4784修复 SyncIterator 中的错误传播PR 5045修复 mixin 以包含otlp_v1_tracesHTTP 写入路由PR 5072修复TempoBlockListRisingQuickly告警分组PR 4876修复 metrics generator host info processor 的 overrides 配置PR 5118修复 metrics generatortarget_info跳过无名称属性以防止下游错误PR 5148。总结Tempo 2.8 是一次兼顾查询能力增强与资源占用瘦身的版本topk/bottomk与sum_over_time让 TraceQL 指标查询从拉全量再后处理进化为一条查询直接出排名与累计值most_recenttrue与span:parentID则补齐了排障与 span 关联场景的拼图大 trace 池化移除与迭代器优化把 compactor 等环节的内存高水位线大幅压低。升级前请务必核对本文升级注意事项部分的端口变更、serverless 配置删除、max_attribute_bytes重命名等破坏性变更并参考各补丁版本的安全修复清单及时跟进依赖版本。【免费下载链接】tempoGrafana Tempo is a high volume, minimal dependency distributed tracing backend.项目地址: https://gitcode.com/GitHub_Trending/tempo1/tempo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
