终端日志排障

最近更新时间:2025-05-16 17:39:21

我的收藏

概述

终端日志排障是由 IM 和云助手联合打造的一款基于 SDK 日志进行分析的工具,协助您快速定位问题并进行排障。支持 IM 的 xlog、clog 日志,目前支持以下类型分析结果:
排障时间线:提取日志中的关键节点绘制成时间线,支持点击跳转到日志中的具体位置。
房间列表:分析出日志中所有的进房列表和对应的参数,点击即可跳转进房的具体位置。
注意:在使用终端排障过程中,推荐使用非 IE 内核的主流浏览器,例如 Chrome 浏览器(又称 Google 浏览器)、Safari、Firefox 火狐浏览器等。
原因:终端日志排障使用了 WebAssembly 技术,IE 不支持该特性。

操作指引

步骤1:进入即时通信 IM 控制台

登录 即时通信 IM 控制台,在左侧导航栏消息服务 Chat下单击罗盘,前往终端日志排障

步骤2:进入终端日志排障

单击上方菜单栏终端日志排障,即可体验。


步骤3:获取本地日志

单击如何获取日志,并选择即时通信 IM,即可查看即时通信 IM 的获取日志路径,如下图所示:


即时通信 IM

日志默认存储路径:
iOS&Mac:/Library/Caches/com_tencent_imsdk_log
Android:
4.8.50及之前的版本:/sdcard/tencent/imsdklogs/
4.8.50之后的版本:/sdcard/Android/data/包名/files/log/tencent/imsdk
Windows:Windows 日志默认存储于程序文件的运行目录下,比如:当程序运行在 C:\\App\\ 目录下时,IM SDK 会将日志存储在 C:\\App\\com_tencent_imsdk_log\\ 目录。
修改日志路径指:
Android&iOS&Windows&Mac 参考初始化文档中 配置 V2TIMSDKConfig

步骤4:选择日志进行分析

日志上传有三种方式:

通过手动单击选择日志,上传日志。
通过手动单击点击上传,上传日志。
通过将日志文件拖拽到此区域,完成日志上传。


日志分析

在上一步完成日志上传后,您可以在右侧的日志分析结果区域内,选择合适的工具协助您分析问题:
1. 排障时间线:可以根据当前需要排查的问题进行灵活选择。当时间线分析结果过多时可以输入关键字对结果进行过滤,输入完成后单击搜索图标或者键盘回车键即可触发。

2. 排障时间线 > 日志显示与日志定位:单击排障时间线中的单条日志后,左侧日志预览会自动跳转到对应日志,并有蓝色背景标记。

3. 下载当前日志:单击日志预览 > 下载当前日志,可下载当前日志预览中展示的日志。

4. 选择日志:单击日志预览 > 选择日志,可重新上传日志。