简介
本文介绍客户端 COS SDK 日志上报和分析功能。
功能说明
日志上报功能将客户端 COS SDK 的运行日志，上报至腾讯云日志服务 CLS。您可在 COS 控制台上查看请求成功率、任务次数、错误码以及地域等数据，便于您后续分析和了解业务运行情况。
说明：
日志上报
操作指南
1. 登录 对象存储控制台-客户端日志分析。
?
2. 选择日志上报和存储的地域。关于 CLS 支持的地域，请参见 日志地域说明。
?
3. 点击应用列表的新建按钮。
?
4. 填写要接入的应用名称，创建对应的日志相关资源。
?
应用名称：填写需要接入的应用名称
SDK 类型：目前仅支持 cos sdk
日志主题标签： 选择创建的日志主题对应的标签
?
所属日志集：创建的日志主题所属的日志集（固定为 qcloud_track）
日志主题名称：根据应用名称和 SDK 类型生成 CLS 的日志主题名称
5. 创建成功后，点击应用名称或者配置详情，在左侧点击接入方式，进入该应用的接入方式页面。
?
?
6. 完成相关配置后，如想查看有关信息，可以点击想要查看信息的应用名称或配置详情，进入详情页面，查看基本信息。
注意：
请勿修改日志主题的基础配置和索引配置，否则可能会导致仪表盘的数据丟失或错乱。
?
日志分析
操作指南
从应用列表页面点击查看数据，进入数据详情页面，查看具体的数据。
?
用户可根据核心指标、基础分布、其它等维度进行有关日志分析。
?
筛选
支持任务类型、操作系统、网络类型、运营商、省份、国家、存储桶、region、cos sdk版本的筛选。
?
核心指标
失败率：整体失败率。该指标反映了 COS 操作的失败率。
任务次数：指定时间段的任务次数。您可指定制定段，查询您所需要了解的时间范围内的任务次数。
失败率-运营商分布：运营商维度的失败率分布，便于了解由运营商网络导致的失败。
失败率-省份分布：省份维度的失败率分布，便于了解各个省份的失败率。
失败率-国家分布：国家维度的失败率分布，便于了解各个国家的失败率。推荐海外业务重点关注该指标，因为不同国家的网络等情况差异较大。
失败率-region 分布：region 维度的失败率分布，用于观察各个 region 的失败率。您可根据该指标调整存储桶的 region 分布。
?
?
基础分布
任务次数：所选时间段内整体的 COS 任务次数，包括上传、下载、传输任务以及具体的 COS 请求任务。
用户请求来源分布（中国）：通过地图的方式直观的展示省份的任务次数分布。
region分布：统计出各个 region 对应的任务次数。
用户请求来源分布（世界）：通过地图的方式直观的展示国家的任务次数分布。
bucket分布：统计出各个存储桶对应的任务次数。
基础接口分布（全部任务类型）：具体的 COS 请求任务次数分布（上传、下载、传输任务是由具体的 COS 请求组成的）。
?
?
?
其他
错误详情：查看一条具体的错误信息，包括错误类型、错误码、错误名称、错误描述以及 HTTP 响应码，主要用来结合错误码分布进行错误分析。
?
删除应用
点击应用列表项的删除操作，即可完成应用日志的删除。
注意：
删除应用将删除该应用的所有历史日志数据，且不可恢复。该操作属于高危操作，请您谨慎操作。
?
