文档中心

日志服务

请输入

Trace 存储

Trace 功能概述

Trace 存储是日志服务提供的一种分布式链路追踪功能。Trace 存储基于原生的 OpenTelemetry 协议与标准，支持各类 Trace 数据的接入、存储、检索分析、可视化等功能，实现全链路 Trace 数据的可观测。本文档介绍 Trace 存储的功能概述、使用限制、接入方案等。

功能简介

在云原生、微服务、分布式等涉及多个服务交互的架构或系统中，一个请求通常需要经过多个微服务的处理，某个性能问题可能涉及多个服务和组件。随着分布式系统的规模和复杂性的不断增加，了解请求在系统中的路径和跨组件的流动变得更加困难。分布式链路追踪可查看请求在系统中的完整调用链路与视图、追踪异常信号的传播路径、监控整个事务的执行过程，从而帮助开发人员了解每个微服务的性能指标，快速、及时定位和解决问题。

日志服务通过 Trace 存储提供基于 OpenTelemetry （简称为 OTel）标准协议的分布式链路追踪能力，适用于性能优化、故障排查、微服务架构监控、服务调用链路分析、分布式事务追踪、安全审计等场景。OpenTelemetry 提供跨语言的标准规范，使所有观测数据有效统一起来，并提供基于 OTel 标准的 API 实现的各种语言的 SDK，支持自定义开发观测数据采集。Trace 数据成功接入日志服务后，日志服务会及时记录全链路的请求及其上下文信息，并将其以统一的标准化格式保存到服务端，以供后续的查询、分析与数据可视化。

目前，日志服务通过 Trace 存储提供以下能力：

各类 Trace 数据接入与存储。

Trace 数据的在线实时检索与分析。

相关资源

资源	说明
日志主题	在创建 Trace 实例时，日志服务会同时自动创建 2 个日志主题。日志主题包括： tls_${trace实例名称}-trace：用于存储采集到的 Trace 原始数据。 tls_${trace实例名称}-dependency：用于存储从 Trace 原始数据中提取并聚合后的拓扑关系数据。 Tip 不支持手动删除日志主题，但可以修改tls_${trace实例名称}-trace的配置。 Trace 数据在日志主题中的默认保存时间（TTL）为 30 天，您可以按需修改。
索引	日志服务默认为 Trace Topic 配置索引。请勿修改或删除预置的索引字段，否则会导致 Trace 实例功能异常或数据检索异常。

注意事项

日志服务的 Trace 存储免收服务费用，但使用 Trace 存储时涉及的日志主题分区、数据存储、索引存储等资源使用将按照标准的计费模式收费。详细的价格信息请参考产品计费。

为保证数据安全，建议您在使用 Trace 存储时，使用火山引擎 IAM 账号进行操作。IAM 子账号应具备操作 Trace 实例和写入数据的权限策略，详细说明请参考授权策略示例。

使用限制

每个火山引擎账号可创建的 Trace 实例数量取决于该 Trace 实例所属日志项目剩余可创建的日志主题数量。

Trace 功能依赖定时 SQL 任务的调度并发限制。详细说明，请参考使用限制。

Trace 上传吞吐量和 QPS 与 Trace 实例关联的 Topic 对齐，超过对应阈值后，会报错。

查询 Trace 时，查询 QPS 和数据量与 Trace 实例关联的 Topic 对齐，超过对应阈值后，会报错。

Trace 实例关联的 dependency 的日志主题名字和索引配置不允许修改。

Span 上传时，单 Span 的大小不能超过 9KiB，单请求最大 4MiB。

接入方案

日志服务支持通过原生 OpenTelemetry 协议将 Trace 数据接入到日志服务，推荐的接入方式如下。

接入方式	说明	参考文档
OpenTelemetry SDK	OpenTelemetry 提供基于 OTel 标准的 API 实现的各种语言 SDK，支持 Trace 数据的采集。您可以使用 OpenTelemetry SDK 直接将 Trace 数据写入到日志服务，其中 OpenTelemetry 支持 HTTPS 协议或 gRPC 方式。	通过 OpenTelemetry SDK 写入数据

Tip

推荐使用开源 OpenTelemetry 标准协议、对接 OpenTracing 和 OpenTelemetry 标准，以便快速对接日志服务，并与其他开源系统无缝打通。

建议系统中的各个组件、服务使用同样的 Trace 存储接入方式，便于 Trace 数据的一站式完整采集与上传。

最近更新时间：2026.07.29 10:43:40

这个页面对您有帮助吗？

有用

无用