快速开始
更新时间：2025-11-14
简介
本文档主要介绍百度智能云日志服务 iOS SDK的安装和使用
本文档假设您已经开通了百度智能云日志服务
如果您还没有开通或者还不了解日志服务，请登录 日志服务产品主页 获取更多的帮助。
环境要求
- iOS系统版本：9.0及以上
- 必须注册有百度智能云用户账户，并开通日志服务
安装SDK工具包
安装步骤
- 在 百度智能云开发者中心 的 客户端 SDK 列表找到百度日志服务，下载SDK压缩包，解压得到BDLogServiceSDK.framework。
- 根据需要将framework复制到您的Xcode工程目录下，例如lib目录。
- 在Xcode右键工程->Add files to "your project"，导入您刚才复制的framework。
SDK目录结构
Plain Text
1|_BDLogServiceSDK.framework // BLS SDK
2| |____Headers
3| |____BDLogServiceSDK.h // BLS 头文件说明
4| |____BDLogServiceConfig.h // BLS 配置类
5| |____BDLogServiceClient.h // BLS 客户端类
6| |____BDLogServiceClient+LogStore.h // BLS 日志集相关接口类
7| |____BDLogServiceClient+LogStream.h // BLS 日志流相关接口类
8| |____BDLogServiceClient+LogRecord.h // BLS 读写日志相关接口类
9| |____BDLogServiceClient+FastQuery.h // BLS 快速查询相关接口类
10| |____BDLogServiceClient+Index.h // BLS 索引相关接口类
11| |____BDLogServiceClient+LogShipper.h // BLS 日志投递相关接口类
12| |____LogStore.h // BLS 日志集 Model 类
13| |____LogStream.h // BLS 日志流 Model 类
14| |____LogRecord.h // BLS 日志记录 Model 类
15| |____FastQuery.h // BLS 快速查询 Model 类
16| |____LogStoreIndex.h // BLS 日志集索引 Model 类
17| |____LogShipper.h // BLS 日志投递 Model 类
18| |____BDLogServiceConstants.h // BLS 常量定义
19| |____BDCloudSigner.h // BLS AK、SK签名类SDK使用
示例1：上传日志
- 初始化设置ak/sk，Endpoint，创建 BDLogServiceClient 对象。（可用的 Endpoint 可以在 API参考-服务域名查看）
ObjectiveC
1//初始化AK SK
2NSString *ak = @"<access key>";
3NSString *sk = @"<secret key>";
4NSString *endpoint = @"<endpoint>";
5BDLogServiceConfig *config = [[BDLogServiceConfig alloc] initWithEndpoint:endpoint accessKey:ak secretKey:sk];
6BDLogServiceClient *client = [[BDLogServiceClient alloc] initWithConfig: config];-
调用 pushLogRecord 接口上传日志
日志记录的格式可以是 TEXT，也可以是 JSON 格式。如果是 TEXT，则不对日志进行解析；如果是 JSON 格式，可以自动发现 JSON 字段（仅支持首层字段发现，暂不支持嵌套类型字段的自动发现）。
如果既想上传日志原文，又想上传解析出的具体字段，可以使用 JSON 格式进行上传，并在 JSON 中包含日志原文（使用 @raw 作为key，日志原文作为 value）。 BLS 解析到 @raw 的时候，会将其内容作为日志原文处理。
例如：
- TEXT 类型
ObjectiveC1 LogRecord *logRecord = [[LogRecord alloc] initWithMessage: @"this is log."]- JSON 类型
ObjectiveC1 LogRecord *logRecord = [[LogRecord alloc] initWithMessage: @"{\"level\":\"info\", \"status\": 200, \"cost\": 304.87}"]- JSON 类型，包括日志原文
ObjectiveC1 LogRecord *logRecord = [[LogRecord alloc] initWithMessage: @"{\"@raw\":\"info 200 304.87ms this is log.\", \"level\":\"info\", \"status\": 200, \"cost\": 304.87}"]
ObjectiveC
1//配置参数，请求接口
2NSString *logStoreName = @"<自定义名称>";
3NSString *logStreamName = @"<自定义名称>";
4NSInteger time = (NSInteger)([NSDate date].timeIntervalSince1970 * 1000); //日志时间戳，不能大于当前时间戳，单位毫秒
5NSString *type = @"TEXT"; //日志记录格式，支持 JSON/TEXT，默认为 TEXT，详情请参考上述日志记录格式说明，一次上传请求的日志记录都要是同一种格式
6NSArray *logRecords = @[
7 @{
8 @"message":@"<日志内容，可以是文本内容，或者 JSON 字符串，参考上述日志记录格式说明>",
9 @"timestamp":[NSNumber numberWithInteger:time]
10 },
11 @{
12 @"message": @"<日志内容，可以是文本内容，或者 JSON 字符串，参考上述日志记录格式说明>",
13 @"timestamp": [NSNumber numberWithInteger:time]
14 }
15]; //日志记录
16__weak typeof(self) weakSelf = self;
17[client pushLogRecordWithLogStoreName:logStoreName logStreamName:logStreamName type:type logRecords:logRecords completion:^(NSDictionary * _Nonnull resultDic, NSError * _Nonnull error) {
18//resultDic返回服务器返回的数据结果
19 if(error){ //失败
20 NSLog(@"%@ %@", resultDic[@"message"], error);
21 } else { //成功
22 NSLog(@"推送日志记录成功");
23 }
24}];示例2：创建日志集
- 初始化设置ak/sk，Endpoint，创建 BDLogServiceClient 对象。（可用的 Endpoint 可以在 API参考-服务域名查看）
ObjectiveC
1//初始化AK SK
2NSString *ak = @"<access key>";
3NSString *sk = @"<secret key>";
4NSString *endpoint = @"<endpoint>";
5BDLogServiceConfig *config = [[BDLogServiceConfig alloc] initWithEndpoint:endpoint accessKey:ak secretKey:sk];
6BDLogServiceClient *client = [[BDLogServiceClient alloc] initWithConfig: config];- 调用 createLogStore 接口创建日志集
ObjectiveC
1//配置参数，请求接口
2NSString *logStoreName = @"<自定义名称>";
3NSString *retention = @"10"; // 日志集的租期，单位：天数
4__weak typeof(self) weakSelf = self;
5[client createLogStoreWithLogStoreName:logStoreName retention:[retention intValue] completion:^(NSDictionary * _Nonnull resultDic, NSError * _Nonnull error) {
6//resultDic返回服务器返回的数据结果
7 if(error){ //失败
8 NSLog(@"%@ %@", resultDic[@"message"], error);
9 } else { //成功
10 NSLog(@"创建LogStore成功");
11 }
12}];其他服务接口的调用过程与示例相似。关于 SDK 使用到的 API 具体用法，可以参考：API 参考 - 概览