Trace 存储是日志服务提供的一种分布式链路追踪功能。Trace 存储基于原生的 OpenTelemetry 协议与标准，支持各类 Trace 数据的接入、存储、检索分析、可视化等功能，实现全链路 Trace 数据的可观测。本文档介绍 Trace 存储的功能概述、使用限制、接入方案等。 ## 功能简介在云原生、微服务、分布式等涉及多个服务交互的架构或系统中，一个请求通常需要经过多个微服务的处理，某个性能问题可能涉及多个服务和组件。随着分布式系统的规模和复杂性的不断增加，了解请求在系统中的路径和跨组件的流动变得更加困难。分布式链路追踪可查看请求在系统中的完整调用链路与视图、追踪异常信号的传播路径、监控整个事务的执行过程，从而帮助开发人员了解每个微服务的性能指标，快速、及时定位和解决问题。日志服务通过 Trace 存储提供基于 [OpenTelemetry](https://opentelemetry.io/docs/what-is-opentelemetry/) （简称为 OTel）标准协议的分布式链路追踪能力，适用于性能优化、故障排查、微服务架构监控、服务调用链路分析、分布式事务追踪、安全审计等场景。OpenTelemetry 提供跨语言的标准规范，使所有观测数据有效统一起来，并提供基于 OTel 标准的 API 实现的各种语言的 SDK，支持自定义开发观测数据采集。Trace 数据成功接入日志服务后，日志服务会及时记录全链路的请求及其上下文信息，并将其以统一的标准化格式保存到服务端，以供后续的查询、分析与数据可视化。目前，日志服务通过 Trace 存储提供以下能力： * 各类 Trace 数据接入与存储。 * Trace 数据的在线实时检索与分析。 ## 相关资源 |资源 |说明 | |---|---| |日志主题 |在创建 Trace 实例时，日志服务会同时自动创建 2 个日志主题。日志主题包括：|\ | ||\ | |* `tls_${trace实例名称}-trace`：用于存储采集到的 Trace 原始数据。|\ | |* `tls_${trace实例名称}-dependency`：用于存储从 Trace 原始数据中提取并聚合后的拓扑关系数据。|\ | ||\ | |:::tip|\ | ||\ | |* 不支持手动删除日志主题，但可以修改其配置。|\ | |* Trace 数据在日志主题中的默认保存时间（TTL）为 30 天，您可以按需修改。|\ | ||\ | |:::| |索引 |日志服务默认为 Trace Topic 配置索引，您也可以在默认索引的基础上添加新的字段索引。请勿修改或删除预置的索引字段，否则会导致 Trace 实例功能异常或数据检索异常。 | ## 注意事项 * 日志服务的 Trace 存储免收服务费用，但使用 Trace 存储时涉及的日志主题分区、数据存储、索引存储等资源使用将按照标准的计费模式收费。详细的价格信息请参考[产品计费](/docs/6470/105179)。 * 为保证数据安全，建议您在使用 Trace 存储时，使用火山引擎 IAM 账号进行操作。IAM 子账号应具备操作 Trace 实例和写入数据的权限策略，详细说明请参考[授权策略示例](/docs/6470/812367#%E9%87%87%E9%9B%86-trace-%E6%95%B0%E6%8D%AE)。 ## 使用限制 * 每个火山引擎账号可创建的 Trace 实例数量取决于该 Trace 实例所属日志项目剩余可创建的日志主题数量。 * Trace 功能依赖定时 SQL 任务的调度并发限制。详细说明，请参考[使用限制](/docs/6470/1130971#.5L2_55So6ZmQ5Yi2)。 * Trace 上传吞吐量和 QPS 与 Trace 实例关联的 Topic 对齐，超过对应阈值后，会报错。 * 查询 Trace 时，查询 QPS 和数据量与 Trace 实例关联的 Topic 对齐，超过对应阈值后，会报错。 * Trace 实例关联的 Project、Topic 的名字和Topic 的索引配置不允许修改。 * Span 上传时，单 Span 的大小不能超过 9KiB，单请求最大 4MiB。 ## 接入方案日志服务支持通过原生 OpenTelemetry 协议将 Trace 数据接入到日志服务，推荐的接入方式如下。 |接入方式 |说明 |参考文档 | |---|---|---| |OpenTelemetry SDK |OpenTelemetry 提供基于 OTel 标准的 API 实现的各种语言 SDK，支持 Trace 数据的采集。您可以使用 OpenTelemetry SDK 直接将 Trace 数据写入到日志服务，其中 OpenTelemetry 支持 HTTPS 协议或 gRPC 方式。 |[通过 OpenTelemetry SDK 写入数据](/docs/6470/812322) | :::tip * 推荐使用开源 OpenTelemetry 标准协议、对接 OpenTracing 和 OpenTelemetry 标准，以便快速对接日志服务，并与其他开源系统无缝打通。 * 建议系统中的各个组件、服务使用同样的 Trace 存储接入方式，便于 Trace 数据的一站式完整采集与上传。 :::