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