终端日志排障

最近更新时间:2024-06-07 17:48:41

我的收藏

概述

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

开通产品

第一次使用 TRTC 云助手 时,需开通服务。单击立即开通,即可一键开通 TRTC 云助手的所有服务,马上体验。



当您是使用子账号访问,可能会出现弹框提示您当前没有操作 “TRTC 云助手-DescribeAuthorization” 的权限,您可根据弹框中的提示指引,进行权限申请,权限申请完成后即可正常访问。




操作指引

步骤1:进入 TRTC 云助手控制台

登录 TRTC控制台 前往 TRTC 云助手 > 终端日志排障

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

单击控制台左侧菜单栏终端日志排障,即可体验。




步骤3:获取本地日志

单击如何获取日志,即可查看实时音视频 TRTC 即时通信 IM 的获取日志路径,如下图所示:




实时音视频 TRTC

日志默认存储路径:
iOS&Mac:sandbox的Documents/log
Android:
6.7及之前的版本:/sdcard/log/tencent/liteav
6.8之后的版本:/sdcard/Android/data/包名/files/log/tencent/liteav/
8.5之后的版本:/sdcard/Android/data/包名/files/log/liteav/
Windows:
8.8之前的版本:%appdata%/tencent/liteav/log
8.8以及8.8之后的版本:%appdata%/liteav/log
修改日志路径指引:
iOS&Mac 设置本地日志的保存路径指引:(void)setLogDirPath:(NSString *)path
Android 设置本地日志的保存路径指引:void setLogDirPath(String path)
Windows:
C# 设置本地日志的保存路径指引:void setLogDirPath(String^ path )
C++ 设置本地日志的保存路径指引:void setLogDirPath(const char* path)

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

日志上传有三种方式:

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




日志分析

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



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



3. 房间列表:单击日志分析 > 房间列表,您可以看到日志中的房间号、用户 ID、角色、进房场景、进房时间、退房时间、跳转日志。



4. 房间列表 > 跳转日志:房间列表中,单击对应房间的跳转日志链接后,左侧日志预览会自动跳转到对应日志,并有蓝色背景标记。



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



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