日志服务(SLS)Rust SDK 用于在 Rust 应用中写入、查询日志,以及管理 Project、LogStore 和索引等资源。SDK 由 Client 与 Producer 两个组件构成,两者的运行环境与写入语义不同,选型前需先确认接入前提与数据可靠性约束。
前提条件
接入 SDK 前,需满足以下条件:
访问凭证:使用已授权的 RAM 用户或 RAM 角色访问 SLS,仅授予业务需要的权限。不要将 AccessKey 写入代码或提交到代码仓库。
Endpoint:Endpoint 必须对应 Project 所在地域。建议显式使用
https://;未指定协议时,SDK 默认使用 HTTP。运行环境:Client 的请求需要在 Tokio 异步运行环境中执行,通过
.send().await等待结果。Producer 无需单独创建 Tokio 运行环境,可在普通同步程序或异步程序中使用。
SDK 组成
Rust SDK 包含两个独立安装的组件:
组件 | 安装包 | 职责 |
Client |
| 调用 SLS API,查询日志、管理资源。 |
Producer |
| 持续采集应用日志,在后台批量发送。 |
两个组件不互斥,可在同一应用中同时引入:Producer 承担持续写入,Client 承担日志查询与资源管理。
选择 Client 还是 Producer
两个组件的差异如下:
对比项 | Client | Producer |
适用场景 | 查询日志、管理资源,或自行组织一批日志并等待写入结果。 | 持续采集应用日志。 |
写入方式 | 由调用方攒批日志,通过 | 自动合并日志、压缩、在后台发送,并在失败时按策略重试。应用将日志提交给 Producer 后,可以继续处理业务,通过回调接收最终写入结果。 |
运行环境 | 需在 Tokio 异步运行环境中执行。 | 普通同步程序或异步程序均可使用,无需单独创建 Tokio 运行环境。 |
日志查询与资源管理 | 支持。 | 不支持,需使用 Client。 |
Producer 将待发送日志保存在内存中,不写入本地磁盘。进程异常退出时,尚未发送的日志可能丢失。Producer 不保证日志顺序,网络异常和重试可能导致重复写入;需要去重时,在日志中携带业务唯一标识并由业务处理。
持续写入日志时,建议使用 Producer,减少应用自行处理批量发送和重试的工作。Producer 不提供日志查询或资源管理功能,这些操作请使用 Client。
使用流程
接入 SLS Rust SDK 的流程如下:
步骤 | 文档 | 内容 |
1 | 安装 Rust SDK | 准备 Rust 环境并添加依赖。 |
2 | 初始化 Rust SDK | 配置 Endpoint、访问凭证,创建 Client。 |
3 | Rust SDK 快速入门 | 使用 Client 写入一条日志,再通过查询日志确认写入结果。 |
4 | 使用 Rust Producer 写入日志 | 使用 Producer 批量发送日志,通过回调获取最终写入结果,调整配置并安全退出。 |
实例复用与计费
复用 Client 和 Producer,避免每写入一条日志就创建一个实例。
使用 SLS 产生的写入、存储和查询等费用,按所用资源的计费规则收取。