创建 SessionStore-日志服务(SLS)-阿里云帮助中心

创建 SessionStore 时，您需要选择原始数据格式和来源，并配置数据保存策略。本文介绍创建步骤、主要参数及失败后的处理方式。

前提条件

已完成准备工作与授权服务，并确认使用直写还是引用方式。两种方式的区别见 SessionStore 概述。

重要

数据格式、接入方式和引用的数据源创建后不能修改。不要先选择任意格式创建，再计划通过修改页面切换。

参数	说明	默认值或要求
SessionStore 名称	用于在当前 Project 中识别资源	必填，当前输入框最多 63 个字符；使用未被占用的名称，服务端还会校验名称合法性。
原始数据格式	决定采用哪一类数据解释方式	默认 OpenTelemetry Trace；还可选 OpenTelemetry Log Ebpf、OpenTelemetry Log AI Gateway。
原始数据来源	选择新数据直写或引用已有日志	默认“直写SessionStore”。
源 Project	引用数据所属的 Project	仅“关联已有 LogStore”时需要。必须与目标 Project 同账号、同地域。
源 LogStore	实际产生原始数据的普通 LogStore	仅引用方式需要；请确认实际数据格式与所选格式一致。
服务授权	允许日志服务读取原始数据并生成结果	必须完成默认角色检查。

说明：直写方式不需要选择源 LogStore。引用方式不会替您修改源 LogStore 的采集配置、索引或保存时间。

默认保存 30 天，全部使用热存储。可以选择“限定天数”或“永久保存”。

“限定天数”表示超过保留期的数据按保存策略过期。“永久保存”表示不按有限天数自动过期，不表示不产生存储费用。

重要

当前控制台将 3650 作为永久保存的特殊值，输入该值时会要求确认。不要将其理解为保存 10 年后自动删除。需要有限保留期时，请选择实际的限定天数。

适合近期频繁查询、远期偶尔回溯的数据。根据实际需求选择热存储转低频存储、热存储转归档存储，或热存储转低频后再转归档。

当前控制台的配置要求如下。

永久保存时，按页面配置最终保留的存储层，不再按有限总天数计算到期删除。

说明：切换“限定天数”和“永久保存”会重置分层配置，请重新检查各层设置。低频、归档适合不同访问频率，选择前应了解相关查询性能和计费规则，不要假设各层性能相同。

引用方式下，以上设置只调整 SessionStore 自身处理结果的保存策略，不修改源 LogStore 的原始日志保存时间。

参数	用途	默认值
Shard 数目	设置初始分区数量	2；当前表单允许 1～64 的整数。创建后不能在资源修改页直接修改此值。
自动分裂 Shard	根据服务能力启用自动分裂	开启。
最大分裂数	自动分裂启用时的上限配置	64；当前表单允许 1～64 的整数。
WebTracking	按采集方案需要启用 WebTracking	关闭；普通初次接入无需为了创建成功而打开。

表单输入范围不代表账号资源配额或吞吐保证。容量规划仍需结合实际流量和服务配额。

结果	建议操作
创建成功	打开概览核对配置，然后接入数据。
明确提示参数或权限错误	保留表单，按错误原因修正后重试。
提示资源创建结果尚未确认	先到列表核查同名资源是否已存在，必要时联系管理员；不要连续重复创建。
资源已创建，但字段配置失败	保留当前面板，按提示“重试字段配置”或“重新读取配置”，详见自定义字段章节。

如出现失败，请保留错误码、提示和页面可用的请求 ID。不要向他人提供 Cookie、AccessKey 或完整敏感日志。