数据转发至 LogBamboo¶

LogBamboo 支持在本地或自有云环境中留存数据。将日志、指标、链路等数据转发至 LogBamboo 后，您可通过控制台查询历史记录，用于问题排查和业务复盘。

前提条件¶

开始配置前，请确认：

已部署 LogBamboo，并创建用于接收数据的目标索引；
已获取服务地址和写入 Token。如需在控制台查询历史数据，还需获取独立的查询 Token；
已请部署管理员确认，转发服务能够访问 LogBamboo；
已完成规则名称与过滤条件的设置。

服务地址、Token 和所需证书请向 LogBamboo 管理员获取，详见准备连接信息。如需了解部署和接入方案，请联系销售。

开始配置¶

第一步：选择转发目的地¶

在选择转发目的地中选择 LogBamboo。

选择后，填写服务连接信息即可。LogBamboo 的存储配置由其管理员维护，无需在转发规则中填写存储桶或选择存储格式。

第二步：填写连接信息¶

配置项	是否必填	说明
服务地址	是	LogBamboo 服务地址，例如 `https://logbamboo.example.com:8080`。仅填写根地址，不附加写入接口路径
目标索引	是	填写已在 LogBamboo 创建的索引名。支持英文字母、数字、英文句点、下划线或短横线，长度为 1–128 个字符，不能为 `.` 或 `..`
写入 Token	是	用于向 LogBamboo 写入数据。保存后不显示明文
查询 Token	查询时必填	用于在控制台查询已转发的数据。仅转发时可不填，且不能与写入 Token 相同
信任证书	否	如部署管理员要求配置信任证书，展开 HTTPS 证书设置，填写其提供的 PEM 格式证书内容

请使用 LogBamboo 管理员提供的 Token，不要填写工作空间 Token 或登录密码。

第三步：测试连接¶

点击测试连接。如检查未通过，根据页面提示核对服务地址、Token 和目标索引。

检查通过后继续保存规则，再按验证转发结果确认数据是否正常转发。

第四步：设置数据查看权限并保存¶

需要在控制台查询数据时，填写查询 Token，并按数据查看权限设置工作空间内的查看范围：

无限制：工作空间所有成员均可查看该规则的转发数据；
自定义：仅指定角色的成员可查看。

完成配置后保存规则，确认规则已启用。后续符合条件的数据会按规则转发。

验证转发结果¶

确认已有符合转发条件的数据，且规则处于启用状态；
等待 LogBamboo 完成数据处理；
进入数据转发 > 数据查看，选择对应规则；
按 LogBamboo 接收数据的时间选择查询范围，输入关键词查询；
核对结果中是否包含预期数据。如未查询到，可参考下方说明和常见问题排查。

何时可以查到数据¶

数据转发后，需要等待 LogBamboo 处理完成，才能查询。默认生产配置下，数据量较小时可能需要等待约一小时或更久，具体以实际部署的处理周期为准。

暂时查不到刚转发的数据时，请先确认查询规则和时间范围，稍后重试。不要因暂时查不到而重复发送同一批数据。

应选择哪个查询时间¶

按 LogBamboo 接收数据的时间查询，而不是原始数据的发生时间。

例如，将昨天产生的数据在今天转发到 LogBamboo，应选择今天的接收时间查询。原始发生时间仍可在数据内容中查看。

若页面提示可继续查询，请继续获取后续结果。

容量与购买¶

社区版默认提供 5 TB 数据保留容量，按未压缩内容计算。达到容量上限时，会自动清理较早的数据。使用前，请与管理员确认存储容量和保留策略。

如需更多容量，请联系销售了解商业授权及购买方式。授权费用说明见数据转发 FAQ。

常见问题¶

现象	排查方向
服务地址不可达	核对服务地址和端口，并请管理员确认转发服务能够访问 LogBamboo
认证失败	确认 Token 填写正确。如管理员更换了 Token，请同步编辑转发规则
目标索引不可用	请管理员确认索引已创建，且当前 Token 有权访问
证书校验失败	请管理员检查 HTTPS 证书；如需配置信任证书，填写其提供的证书内容
测试连接通过，但查不到数据	确认规则已启用、有符合条件的数据、已填写查询 Token，并按接收时间查询；刚转发的数据可稍后重试
查询提示等待恢复	按提示等待数据恢复完成，再重新查询
容量不足或授权异常	请管理员核对可用容量、保留策略和授权状态

修改与停用规则¶

管理员更换 Token 后，需同步更新转发规则中的对应 Token；
修改规则名称或转发目标后，不会自动查询修改前的数据。修改前请确认旧数据的查询方式；
停用或删除规则不会清理 LogBamboo 中已保存的历史数据。数据保留与清理由 LogBamboo 管理员维护。