质量数据监控台

简介

网易云信质量数据监控台是面向企业客户开发者、运营人员使用的一套全链路问题定位、可视化数据查询工具。在这里可以查询IM即时通讯、实时音视频等多种产品的非敏感信息,并基于此进行数据分析和问题排查。

其中,IM即时通讯部分围绕账号数据、消息行为、群组和聊天室提供数据查询服务。

用户信息查询

进入质量数据监控台,在IM即时通讯菜单内可找到用户信息查询界面。用于查询基础的、非敏感的用户信息。

查询方式:

参数 说明
应用 在应用列表中根据应用名称选择
ACCID 输入用户账号。调用云信API更新用户名片时所指定的用户唯一标识

点击查询按钮,即可查询该用户对应的相关信息,包括:

参数 说明
用户昵称 用户名片中的name字段
用户头像 用户名片中的icon字段
是否禁用 表明用户是否被封禁,被封禁的用户不能再次登录
是否禁言 表明用户是否被全局禁言,被全局禁言的用户不能发送“点对点”、“群”、“聊天室”消息
创建时间 用户名片的创建时间
更新时间 用户名片的更新时间

用户信息查询中返回的信息,可帮助用户排查基础账号问题,例如:

  1. 无法登录或初始化IM:关注是否被封禁字段
  2. 无法发消息:关注是否被禁言字段

隐私说明:

用户名片内的其他信息,例如邮箱、生日、手机、性别等。考虑到可能涉及的敏感信息,不支持可视化查询。同时,网易云信推荐开发者采用扩展字段填写敏感信息,并在填写前事先加密。

在线状态查询

进入质量数据监控台,在IM即时通讯菜单内可找到在线状态查询界面。用于查询用户当前的在线状态和设备、网络信息。

查询方式:

参数 说明
应用 在应用列表中根据应用名称选择
ACCID 输入用户账号。调用云信API更新用户名片时所指定的用户唯一标识

点击查询按钮,即可查询该用户对应的相关信息,包括:

参数 说明
用户昵称 用户名片中的name字段
用户状态 用户当前的在线状态,分在线和离线
设备类型 在线设备的类型,分桌面端(PC、Web)和移动端(iOS、Android)
登录时间 最近一次登录的登录时间
设备ID 该设备在云信的设备标识符
推送信息 包含推送TokenName和PushToken,标识推送证书信息
网络信息 设备当前所处网络环境和客户端IP信息
是否后台 标识该应用目前是否处于后台运行

注:如果多设备登录中,会分别显示每个设备的在线状态。

用户进行在线状态查询,主要用于排查解决与在线状态相关的问题,例如:

  1. 在线消息收发问题:结合在线状态与网络信息判断。
  2. 离线推送问题:查看推送证书与token信息。
  3. 方便日志拉取:确定用户当前在线以拉取和分析问题日志。

历史消息查询

进入质量数据监控台,在IM即时通讯菜单内可找到历史消息查询界面。历史消息查询用于查询某个会话存储在云端的历史消息详情。以判断定位具体到消息字段的问题。

查询方式:

参数 说明
应用 在应用列表中根据应用名称选择
消息类型 选择P2P消息、群消息或聊天室消息
发送方ACCID 输入用户账号。调用云信API更新用户名片时所指定的用户唯一标识
接收方ID 单聊消息即接收方ACCID群聊消息为群组TID聊天室消息为聊天室ROOMID
查询时段 查询时间范围
筛选选项 支持选择消息列表排列顺序、选择展示的最大消息数、选择需要排除的ID信息等
查找选项 支持关键字查找。可匹配发送方ACCID、接收方ACCID、消息内容字段

点击查询按钮,即可查询对应的相关消息列表,每条消息包含:

参数 说明
发送方ID 发送方ACCID
接收方ID 单聊消息即接收方ACCID群聊消息为群组TID聊天室消息为聊天室ROOMID
消息时间 历史消息在服务器上记录的时间
消息类型 P2P消息、群消息或聊天室消息
客户端消息ID 发送方客户端对应的消息ID
服务端消息ID 服务器对应的消息ID
消息内容 消息体内容
消息详情 消息体包含所有的字段信息

注:只能查询在保存时间范围内的消息。

历史消息查询用于判断定位具体到消息相关的问题。例如:

  1. 消息是否从发送方客户端发送成功?
  2. 消息是否包含违禁内容?
  3. 消息具体对应的ID是多少?
  4. 具体在哪个时间消息发送到服务器?

隐私说明: 历史消息查询功能仅作为测试消息发送、排查定位问题使用,请注意保管好查询结果,避免被用作其他用途。

聊天室信息查询

进入质量数据监控台,在IM即时通讯菜单内可找到聊天室信息查询界面,用于查询聊天室相关的信息。排查聊天室问题。

参数 说明
应用 在应用列表中根据应用名称选择
ROOMID 创建聊天室时生成,聊天室在网易云信的唯一标识

点击查询按钮,即可查询该用户对应的相关信息,包括:

参数 说明
聊天室名称 聊天室当前的名称
开启状态 判断聊天室当前的开启/关闭状态
聊天室公告 聊天室公告信息
整体禁言状态 判断聊天室是否当前处于整体禁言状态
直播URL 聊天室对应的直播流地址
在线设备总数 当前保持连接的设备总数
系统分布 当前保持连接的设备终端系统分布
扩展字段信息 聊天室扩展字段信息
创建人 聊天室创建人的ACCID信息

聊天室信息查询可以查询聊天室相关的问题,例如:

  1. 聊天室无法连接
  2. 聊天室无法发送消息
  3. 查找聊天室创建者、在线用户信息

群组信息查询

进入质量数据监控台,在IM即时通讯菜单内可找到群组信息查询界面,用于查询群组相关的信息。排查群组问题。 | 参数 | 说明 | | ---- | ------------------------------------------ | | 应用 | 在应用列表中根据应用名称选择 | | TID | 创建群组时生成,聊天室在网易云信的唯一标识 |

点击查询按钮,即可查询该用户对应的相关信息,包括:

参数 说明
群组名称 群组当前的名称
群类型 普通群/高级群
创建人ACCID 创建者的ACCID
是否有效 判断群组是否处于有效状态
有效成员 当前群组的总成员数量
创建时间 建群时间
更新时间 群资料最近更新时间
群公告 群组公告
扩展字段 开发者填入的群组扩展字段
头像 群头像URL
进群模式 需要验证/不需要验证
邀请方式 需要被邀请人同意/不需要被邀请人同意
权限信息 邀请入群权限信息修改群资料权限信息

群组信息查询可以查询聊天室相关的问题,例如:

  1. 加群错误:未能成功加群或有不明用户进群,需要验证群人数和群权限等
  2. 查找群主、群组信息等

IM日志拉取

对于较为复杂的问题排查,云信质量数据监控台支持拉取日志交由技术顾问处理。IM日志拉取页面下,可以下发日志拉取命令。当用户在线的情况下,可将相关日志上传。通过日志查询可以查询到日志详情。将相关日志提供给云信技术顾问分析,方便尽快定位问题。

拉取方式:

参数 说明
应用 在应用列表中根据应用名称选择
ACCID 输入用户账号。调用云信API更新用户名片时所指定的用户唯一标识

温馨提示:

  1. 日志拉取工具(内测)致力于帮助客户快速定位问题,用于拉取定位问题所需的用户日志;
  2. 仅当终端用户在线时,方能顺利拉取日志,若出现用户不在线,可联系其上线,日志即可拉取成功;
  3. 请在向技术顾问反馈问题时附上对应日志,共同提高定位问题的效率;
  4. 平台使用若遇到问题,可反馈给对应技术顾问。