简介
本文介绍客户端 COS SDK 日志上报和分析功能。
功能说明
日志上报功能将客户端 COS SDK 的运行日志，上报至腾讯云日志服务 CLS。您可在 COS 控制台上查看请求成功率、任务次数、错误码以及地域等数据，便于您后续分析和了解业务运行情况。
说明：
日志上报
操作指南
1. 进入 对象存储控制台-客户端日志分析，并开通 CLS 日志服务和授权 COS 角色使用腾讯云日志服务。
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 响应码，主要用来结合错误码分布进行错误分析。
删除应用
点击应用列表项的删除操作，即可完成应用日志的删除。
注意：
删除应用将删除该应用的所有历史日志数据，且不可恢复。该操作属于高危操作，请您谨慎操作。
