本文主要介绍IOS SDK和Android SDK如何开启日志记录功能。
OSSClient作为OSS服务的客户端,它为调用者提供了管理存储空间和文件的方法。在使用SDK发起OSS请求前,需要初始化OSSClient实例,并对其进行一些必要设置。移动端的使用环境比较复杂,部分区域或某个时段会出现无法正常使用OSS SDK的情况。为了进一步定位开发者遇到的问题,OSS SDK在开启日志记录功能后,会将日志信息记录在本地。在使用OSSClient前进行初始化,请您根据实际操作系统,参考以下方法开启日志记录。
//日志的样式 //2017/10/25 11:05:43:863 [Debug]: 第17次:<NSThread: 0x7f8099108580>{number = 3, name = (null)} //2017/10/25 11:05:43:863 [Debug]: 第15次:<NSThread: 0x7f80976052c0> //2017/10/25 11:05:43:863 [Debug]: ----------TestDebug------------ [OSSLog enableLog];//执行该方法,开启日志记录
说明:
- 文件存储在沙盒的
Caches/OSSLogs
文件夹中。- 您可以自行选择将文件上传至服务器,便于进一步追踪问题。或者您还可以接入阿里云日志服务 SLS进行日志文件上传。
//日志的样式 //通过调用OSSLog.enableLog()开启可以在控制台看到日志, //并且会支持写入手机sd卡中的一份日志文件位置在内置sd卡路径\OSSLog\logs.csv,默认为不开启。 //日志会记录OSS操作行为中的请求数据返回数据和异常信息 //例如requestId,response header等,下面是一个日志记录case。 //android_version:5.1 android版本 //mobile_model:XT1085 android手机型号 //network_state:connected 网络状况 //network_type:WIFI 网络连接类型 //具体的操作行为信息: //[2017-09-05 16:54:52] - Encounter local execpiton: //java.lang.IllegalArgumentException: The bucket name is invalid. //A bucket name must: //1) be comprised of lower-case characters, numbers or dash(-); //2) start with lower case or numbers; //3) be between 3-63 characters long. //------>end of log OSSLog.enableLog(); //调用此模块即可开启日志
说明:
- 日志文件内置SD卡路径为
\OSSLog\logs.csv
。- 您可以自行选择将文件上传至服务器,进一步追踪问题。或者您还可以接入阿里云日志服务 SLS进行日志文件上传,详情请参见日志服务 SLS。