Server FAQ

1. Q.我部署完成Demo服务后,客户端能登录,但一只显示连接中或未连接?

A. 回答

2. Q.消息存储在数据库中的那张表中

A. 关于消息的表有两个,一个是消息表,这个表里存储着消息的原始数据,另外一张是用户消息表,记录用户的消息记录。使用h2db存储消息时,消息存储在t_message表中,用户消息记录在t_user_message表中;使用mysql存储消息时,消息存储在t_message_X表中,X等于 月份-1+(年份%3)\12* ,例如2019年4月存储在t_message_3表中(4-1+(2019%3)*12)。用户消息记录表是 t_user_message_Y,记录用户和消息的对应关系,分表规则是用户id hash的绝对值再对128去模,比如用户id为 userId1,它的hash绝对值是 -147154261,绝对值取模就是85,所以这个用户的消息记录在t_user_message_85表中。

3. Q.IM服务启动脚本在windows下改过之后,放到linux服务器上运行报错

A. 这是因为Windows下有些编辑器更改完会把脚本转变成DOS格式,linux服务器无法识别DOS格式。解决办法是保存时选择保存为unix格式,或者在linux服务上使用vim打开,然后输入命令:set fileformat=unix,最后保存。

4. Q.为什么数据库中的敏感词数目要比通过API获取到的数目要多

A. 敏感词列表是从网络上搜索出来的,里面有部分重复敏感词。通过server api获取到的敏感词是个集合数据结构,去掉了重复的内容,所以导致了不一致,可以不进行处理,没有任何影响,如果您想清除掉重复内容,请使用下面语句删除重复内容,注意执行时间较长,需要耐心等待

DELETE from  `t_sensitiveword` WHERE `_word` IN (SELECT `_word` FROM (SELECT * from `t_sensitiveword`) as t1 GROUP BY `_word` HAVING count(`_word`) > 1) AND `id` NOT IN (SELECT min(`id`) FROM (SELECT * from `t_sensitiveword`) as t2 GROUP BY `_word` HAVING count(`_word`) > 1);

5. Q.为什么在数据库中添加了一个用户/群组/好友,为啥不起作用?

A. 因为服务使用了大量的缓存,只更新数据库是不能起效果的,另外数据还有完整性需求,直接写数据库可能会出问题。所以可以直接从数据库中读信息,但所有更新操作都 必须只能通过服务API的接口来进行

6. Q.为什么机器人服务部署以后,一直提示加密方式错误?

A. 机器人是个demo服务,为了演示机器人服务收发功能,对接了图灵机器人,客户也可以更换任何的自助问答服务。代码里的图灵机器人配置是无效的,需要可以去图灵注册账户,开通机器人权限,然后更新机器人服务的key。图灵地址在这里

7. Q.怎么修改小火机器人头像名称这些信息?

A. 使用server api的接口或者购买付费的管理后台可以添加或修改机器人。当然也可以在数据库中新建和修改机器人。新建的sql语句如下:

insert into t_user (`_uid`,`_name`,`_display_name`,`_portrait`,`_type`,`_dt`) values ('FireRobot','FireRobot','小火','http://cdn2.wildfirechat.net/robot.png',1,1);

insert into t_robot (`_uid`,`_owner`,`_secret`,`_callback`,`_state`,`_dt`) values ('FireRobot', 'FireRobot', '123456', 'http://127.0.0.1:8883/robot/recvmsg', 0, 1);

新建的机器人是可以立即使用的。也可以修改机器人的user表,修改需要注意两点,一个是_dt字段需要增大以便客户端同步,另外一个就是更新后要重新启动IM服务,这两点不做会不生效。

8. Q.如何删除小火机器人?

A. 将app server的配置文件里面的im.new_user_robot_friend=true,改成false,就不会为新用户自动添加小火机器人为好友了

9. Q.如何做消息审查和过滤?

A. 消息审查和过滤是确保设计软件能够安全运营重要的一环。在野火IM中可以通过如下几种方式:

  1. 使用内置的敏感词过滤。野火IM内置了敏感词,可以针对文本中的敏感词进行过滤。可以通过api接口对敏感词进行管理。命中敏感词时会有不通的策略,在配置文件中有说明(有发送失败,吞掉和替换成*三种策略)。命中敏感词的消息也会存储在一张特殊的消息表中(可以根据表明找出来)。野火IM官方提供的管理后台可以提供这方面的管理,客户也可以自己实现。这种方式的缺点是只能处理文本。
  2. 使用消息转发功能,在野火IM配置文件中配置转发地址,这样客户端所有消息都会被转发到指定审核服务器,当出现违规信息时,使用api中的撤回功能,撤回消息。这种过滤方式可以过滤图片/视频/语音,或其他自定义消息。难点就是处理方式比较难,需要有大量的开发功能。

10. Q.历史消息数据如何清理?

A. 野火IM的消息存放有3种选择。第一种是使用h2db,这种只能用户开发模式,或者用户数极少的情况下,对这种情况下重置数据库就行。第二种方法是使用mysql,其中对message表(t_messages_xxxx)和用户message关系表(t_user_message_xxx)都做了分表,message表是按照月份分的,按照文档说明找到对应的表清空就可以了。用户message关系表,是使用用户ID哈希成128个表,需要对每个表里的数据按照时间进行删除。如果表内数据比较大,需要在业务不繁忙阶段,分表分批次删除,需要部分的开发量。第三种方式就是mongodb的方式,系统会自动过期删除,不用人工干预。

11. Q.服务器一直出现 javax.crypto.BadPaddingException: Given final block not properly padded. Such issues can arise if a bad key is used during decryption. 这个错误提示?

A. 野火IM客户端与服务器保存有每个客户端的密钥,如果因为某种原因服务器没有对应的密钥(更换服务器没有迁移数据或出现异常情况),服务器将与客户端无法进行配合工作。解决办法就是需要在客户端对某些特殊的状态码进行处理,请参考连接状态码有什么需要注意的吗.

12. Q.Windows系统部署,提示时区不合法(The server time zone value 'Öйú±ê׼ʱ¼ä' xxx)

A. 安装Mysql5.7的最新版本,然后参考这个链接

13. Q.服务器端如何发消息?类似问题服务器如何发图片,服务器端如何发自定义消息

A. IM服务的核心功能就是个管道,在管道内传输的不是文本消息,图片消息或自定义消息等具体消息,传输的是Payload。客户端上会定义各种消息,包括文本、语音、图片及自定义消息,在发送时统一编码为Payload,然后再收到后再解码为具体的消息。服务器端发送消息时,首先要确认客户端上编码/解码的规则,发送对应的Payload即可。唯一例外的是Payload字段中的二进制数据需要做base64编码。例如图片消息,在android上的定义如下:

@ContentTag(type = MessageContentType.ContentType_Image, flag = PersistFlag.Persist_And_Count)
public class ImageMessageContent extends MediaMessageContent {

    @Override
    public MessagePayload encode() {
        MessagePayload payload = super.encode();
        payload.searchableContent = "[图片]";

        Bitmap thumbnail = ThumbnailUtils.extractThumbnail(BitmapFactory.decodeFile(localPath), 200, 200);
        ByteArrayOutputStream baos = new ByteArrayOutputStream();
        thumbnail.compress(Bitmap.CompressFormat.JPEG, 75, baos);
        payload.binaryContent = baos.toByteArray();

        return payload;
    }


    @Override
    public void decode(MessagePayload payload) {
        super.decode(payload);
        thumbnailBytes = payload.binaryContent;
    }
  }

  ...
}

public abstract class MediaMessageContent extends MessageContent {

    @Override
    public MessagePayload encode() {
        MessagePayload payload = new MessagePayload();
        payload.localMediaPath = this.localPath;
        payload.remoteMediaUrl = this.remoteUrl;
        payload.mediaType = mediaType;
        return payload;
    }

    @Override
    public void decode(MessagePayload payload) {
        this.localPath = payload.localMediaPath;
        this.remoteUrl = payload.remoteMediaUrl;
        this.mediaType = payload.mediaType;
    }

    ...
}

因此服务器发送图片的参数为

{"payload":{"type":3,"searchableContent":"[图片]","base64edData":"图片缩略图的base64内容","mediaType":1,"remoteUrl":"http://图片的地址"}}

type是消息类型,3(MessageContentType.ContentType_Image)为图片。mediaType是媒体类型,对应文件服务器的bucket,1(MessageContentMediaType.IMAGE)为图片的桶。

14. Q.服务器端存储的离线消息数是多少,能改动吗,怎么改动?

A. 服务器端为每个用户在内存中保存了一个时间线,默认是1024条,当用户有超过1024条消息没有接收时,旧的消息将被抛弃,只保证最新1024条最新消息。这个值可以改大,但改大带来的风险是每个用户的内存占用量会提升很多(每增加1,每个用户的内存占用增加50个字节,需要考虑到用户数和服务器内存大小。专业版不受此影响),另外大量消息的拉取时间也变得很长,影响客户端体验。这个值在配置文件中能找到。

15. Q.敏感词过滤太严格了。

A. 敏感词是社交运营必不可少的一环,国内运营IM必须进行监管,防止触犯法律。现在敏感词设置过于严格而且有些过时,因此客户可以在数据库中删掉现有的敏感词添加自己设置的敏感词(不要修改数据库脚本,因为修改了脚本,升级版本时flyway对数据库的校验会无法通过的,可以等生成了库后再删除),数据库添加的敏感词会在1小时内自动加载生效。另外也可以看一下配置文件,修改敏感词的策略,敏感词只记录下来,不阻拦发送。事后再检查敏感词消息。另外我们提供有管理后台,客户可以购买进行包括敏感词在内的管理.

16. Q.IM服务启动时报错,错误原因是flywayXXXX

A. 野火IM使用了flyway作为数据库migration工具。flyway会对数据库脚本的一致性做校验,如果您改动过sql脚本就会出现校验不过的问题。强烈建议您不要修改sql语句。不要尝试把业务逻辑加到IM服务中。

17. Q.t_messages_xxxx和t_user_messages_xxxx都是做什么用的有什么关系。

A. t_messages是存放消息实体的,每发送一条消息都会存储下来一条;t_user_messages是存放用户消息对应关系的,每条消息的每个目标用户都会存储一条记录。比如在一个1000人的群里发送一条消息,t_messages会存储一条记录,t_user_messages就会存储1000条记录。因此随着时间的增加这两张表的数据内容可能会非常大,因此对这两张表做了分表处理。t_messages的分表可以参加前面问题3,t_user_messages的分表是用户id的hash值对128取模,因此就有128张表。专业版可以选用mongodb存储这两部分内容,mongodb在海量数据时比mysql有着更好的性能表现,使用mongodb时,mysql数据库中还会继续存在这些表,只不过是不使用了,不要删除,保留不变,防止数据库有效性校验出错。

18. Q.禁止多端登录无效!

A. 禁止多端的逻辑是这样的:客户端在login时同时带上clientIdplatform,appserver在获取token时同时带上clientIdplatform,IM服务生产token时会踢掉相同平台的其它设备。IM server中有个配置如下,需要设置为false,如果不生效,则检查appserver和客户端在登录时是否携带了platform

# 是否支持多端登录
server.multi_endpoint false

19. Q.IM服务启动sql语句报错“Specified key was too long; max key length is 767 bytes Location”!

A. 这是因为mysql的版本不够新,mysql的旧版本默认key的最大长度是767字节,如果需要更大的可以手动更改。更简单的办法是升级到mysql5.7.27之后的版本,从5.7.27版本之后默认支持长索引。

20. Q.纯内网环境是否需要部署turn服务器,部署在哪里?

A. 音视频通话是p2p的,需要2端能够建立直接连接。如果2端在不同的NAT后面,就需要turn服务提供穿墙打洞的支持。turn服务不一定要部署在公网,但有个前提条件是 所有客户端能够访问到的IP 才行,turn服务需要放开3478端口(TCP和UDP端口)和所有UDP端口(也可以在turn服务的配置中指定范围)。turn服务器的部署请自行百度解决.

21. Q.如何给IM服务器配置域名

A. 给IM服务器分配个域名是比直接使用IP更好选择,需要注意的事有两点:

  1. 建议使用二级域名,比如您拥有域名example.com,那么可以给你的IM服务器分配域名im.example.comimtest.example.com等。
  2. 域名解析到服务器后,把客户端的IM_SERVER_HOST由IP改为域名,另外就是在服务器配置里的server.ip也改为域名,注意都不要带http头,直接就是im.example.com,服务器配置里的一定要改!

22. Q.数据库里的敏感词删除后,为啥不生效

A. 服务器大概是2个小时更新一下敏感词列表缓存,从数据库里删除后,需要等待2个小时才能确保已经生效。

23. Q.登录时Appserver出错,errorcode是244?

A. 244的意思是server api鉴权失败,需要检查appserver配置文件中的imserver的admin secret是否正确。另外确保两个服务器的时间都是正确的,时间差不要超过2个小时

24. Q. 调用server端管理接口,返回500

A. http 管理接口,默认端口是18080,请确认初始化时,url是否带上端口。

25. Q. 如何做消息数据的迁移?

A. 有客户在使用其它厂商的IM,现在需要迁移到野火IM,用户关系/群组关系/用户信息是比较容易进行迁移的,根据SDK接口同步就行。但消息的迁移无法完美支持,仅能做到在会话内拉取历史消息,未接收的消息无法在野火IM服务上接收 下来。做消息迁移需要理解野火IM的分表规则,能够把消息放入到正确的表中,另外需要理解消息ID的规则,需要保证消息是升序的规则,特别注意旧平台消息和野火IM消息的衔接,因为野火IM历史消息拉取根据消息id的顺序获取的。

26. Q. 登录时AppServer报出异常org.apache.shiro.authc.AuthenticationException: 会话不存在

A. Demo AppSever拥有2个Realm,分别用户移动端登录和扫码登录,登录是Shiro会逐个尝试,如果失败就抛出这个异常,并尝试下一个,如果有一个成功则认为登录成功。所以如果能够最终登录成功就可以忽略掉这个异常。另外如果您有更好的解决办法,欢迎给我们提PR解决这个问题

27. Q. 如何修改默认管理员信息和机器人信息

A. 首先不能改动软件包附带的sql脚本,以免以后升级时出现sql完整性校验失败导致升级失败的问题。修改的方法有两种,1是通过api进行修改,创建和修改用户是同一个接口,需要注意用户类型不能出错;2是直接修改数据库,修改数据库时需要注意把_dt字段加一,然后把服务重启(如果是集群部署,需要全部停掉再启动)才能生效。

28. Q. PC或Web登录后,客户端没有登录提示

A. 该功能默认关闭的,需要修改IM服务的配置如下,并重启服务。

# 是否支持多端登录,为true时支持任意平台任意多个客户端同时登录;为false时每个平台只支持一个端登录,但不同平台可以同时登录。
server.multi_endpoint false

# 多平台连接状态通知(仅当multi_endpoint为false时有效),true时移动端可以收到pc或web端登录的通知。
server.multi_platform_notification true

29. Q. 朋友圈中文乱码

A. 由于服务器不支持中文导致。linux服务器可参考如下步骤处理:

  1. ~/.bashrc最后添加如下两行:
     export LANG='zh_CN.UTF-8'
     export LC_CTYPE='zh_CN.UTF-8'
    
  2. 执行source ~/.bashrc
  3. 执行locale确认LC_CTYPE是否修改为zh_CN.UTF-8
  4. 重启野火IM服务

30. Q. 客户端调用群公告接口失败。

A. 失败常见于iOS端和Web端和PC端,这个接口是调用appserver的,在appserver登录以后会返回cookies。由于网络的安全性问题,这个cookies在iOS和Web有着比较严格的检查,这个是系统(或浏览器)决定的,具体原因请参考这里。检查appserver的配置文件application.properties中的如下配置:

# 是否支持SSL,如果所有客户端调用appserver都支持https,请把下面开关设置为true,否则为false。
# 如果为false,在Web端和wx端的appserve的群公告等功能将不可用。
wfc.all_client_support_ssl=false

如果客户端访问appserver支持https,打开这个开关;否则关闭这个开关。我们建议打开开关并且使用HTTPS。

31. Q. iOS客户端扫码登录PC或者web功能失败

A. 同上个问题

32. Q. IM服务的配置文件中,如何对特殊字符做转义

A. 2021.8.5日以后的版本,配置文件中可以使用任何特殊字符,但注意 配置内容跟注释不能放到一行 ,比如下面:

http_port 80 #端口80,这是一个错误的写法,不能配置和注释放到同一行.

#端口80 这是一个合法的写法
http_port 80

2021.8.5日以前的版本,不支持配置参数内有#符号,避免使用此符号就可以了。

33. Q. Server API如何发某种消息?如何处理消息回调来的消息?

A. 服务和协议栈传输的只有一种类型的数据---消息负载(MessagePayload),在客户端的Client层会实现消息内容与消息负载的互相转换。因此在客户端发送/接收的是消息,而服务接口都是消息负载。如果要想通过Server API发送某种消息,需要去找客户端找到消息内容与消息负载的转换方式,发送正确的消息负载,客户端就会转换为对应的消息。同理服务端收到消息回调也是消息负载,需要与客户端参考对应关系,转为实际的消息。需要有一点注意的是Server API和回调的消息负载binaryContent是经过base64编码的。关于消息/消息内容/消息负载相关知识,请参考基础知识相关部分.

如果从数据库读取消息,也是一样的,先参考 https://gitee.com/wfchat/im-server/blob/wildfirechat/broker/src/main/java/io/moquette/persistence/DatabaseStore.java 文件中的MessageBundle getMessage(long messageId)方法,把数据库中的内容转换成Payload,然后再参考客户端的Client的转换方法来转换成具体的消息类型。

34. Q. 如何转存历史消息

A.

  1. 为什么转存消息:野火默认(最长)保存历史消息是3年,在此之前的消息将被自动清除。在某些特殊用途下,可能需要保存更长的时间,因此需要将消息进行转存。也有可能数据库无法支持保存3年的消息,当数据库能力显著下降又无法对数据库配置升级时,也需要把消息进行转储来降低数据库的压力。
  2. 消息如何存储:关于消息的数据有两类,一类是消息,包括发送者、会话、发送时间、消息内容等,存储在t_messages_x表中,以月来分表存储。另一类是用户消息对应表,记录用户的消息记录,包括用户id、消息id以及会话信息等,存储在t_user_messages_X表中。关于分表规则可见问题2。
  3. 如何转存消息:可以按月来转存消息,按照分表规则把消息表里的整张表的数据进行转存,用户消息表则需要处理每张表,按照数据中的时间戳把对应的时间数据保存到另外的数据库中。注意转存消息需要安排在空闲时段。
  4. 如果读取转存消息:如果读取消息,可以读取转存的消息表数据即可。如果读取用户的消息,就需要先读取转存的用户消息表,拿到该用户的消息ID,再根据消息id去转存的消息表获取消息数据。关于消息的转换,可以参考社区版读取消息的代码。
  5. 如何使用:一种使用是历史审查,这种处理简单一些,能读取出来进行处理就行。另外一种是客户端还想要加载查看,这时需要在业务服务开发对应加载用户会话消息的功能,当客户端本地消息读不到后,就调用获取远程消息的接口获取存储在IM服务的消息,当远程消息获取不到时,再调用转存历史消息接口获取转存的消息。这样就实现了三级的存储结构。
  6. 对象存储的问题:媒体类消息比如图片、语音、文件等都是先上传到对象存储服务,再发送消息链接。因此转存消息时也要考虑到对象存储。如果对象存储超过限制,需要进行清理也需要进程转存对象,并且当查看转存的媒体类消息时,也需要转换对象存储地址。

35. Q. 后台创建群,存在一个管理员用户,能否给屏蔽掉?

A. 野火API接口创建群组,有个operator参数,在前端显示就是这个creator创建了群组。在群组成员参数中,如果所有群组成员都是普通成员,则服务会把operator设置为群主并加入到群成员列表中。如果不想把管理员用户加入到群组成员中,可以在群组成员中指定某个成员为群主,这样成员列表中如果没有管理员就不会把它加入到群成员中了。

36. Q. 消息存储在数据库的那张表里,如果获取消息内容?

A. 在数据库中有两类表,一类是t_messages_x,这个是消息的原始数据表,按照月份分成36张表。另外一类是t_user_messages_y,这个是消息分发表,记录用户的消息记录(只记录属于该用户的消息id),按照用户id hash对128取模分表的。

在t_messages_x表中,字段_data是消息payload序列化后的二进制数据,_searchable_key是payload中的_searchable_key字段,原意是想做服务器端搜索,暂未实现。消息读取方法可以参考社区版IM服务源码文件DatabaseStore.java中的MessageBundle getMessage(long messageId)方法。

在t_user_messages_y表中,记录用户的消息分发请求,其中_mid为消息id,所以如果想要获取用户的信息,可以先从t_user_messages_y中读取消息id列表,然后再去t_messages_x表中获取消息。

可以根据上述信息来开发管理后台来管理消息,野火IM的管理后台也是使用同样的方法实现的,也可以直接购买我们源码节省客户二次开发时间。

37. Q. 如果通过server sdk或者server api发送图片消息?

A. server sdk和server api发送的是消息负载,普通消息如文本之类只要保持跟客户端消息转化的消息负载一致就可以了。但媒体类消息,比如图片/文件/语音/视频等消息稍微不同。在客户端发送媒体类消息,协议栈会把消息中的文件上传到对象存储服务,再把链接放到消息负载中的remoteUrl属性,再发送。因此服务端发送媒体类消息需要首先把文件上传到对象存储服务中,然后把文件地址放入到消息负载的remoteUrl属性,再调用发送接口发送消息负载。

38. Q. 之前服务使用内置文件存储,怎么迁移到专有对象存储服务?

A. 最简单的方法是继续保留内置文件存储的访问,新文件上传到专有对象存储服务。当IM服务配置为专有对象存储后,新的文件都会上传到专有对象存储服务,之前旧的文件还是可以访问的。稍微麻烦一点的办法就是把内置文件存储服务的文件转移到专有对象存储服务,再更新客户端,新客户端端读取到旧地址后映射成新地址。实际操作上可能是两者同时存在,先保证现有客户端能继续访问在内置存储的文件,然后再逐步迁移,发布客户端版本,等所有客户端版本都更新后再删掉内置文件存储的文件和关闭掉/fs路径的访问。

39. Q. java -version 和 $JAVA_HOME/bin/java -version都输出正常,但执行脚本的时候,提示找不到java

A. 可能是因为执行启动脚本时,加了sudo,而 root 用户下没有安装 java

40. Q. 提示 80 端口被占用,但实际没有占用

A. 可能是因为没有 ROOT 权限,如果无法使用ROOT用户运行IM服务,可以为Java设置绑定端口的权限,命令如下:

//java的路径在不同系统上会有变化,请找到正确的java地址来设置
sudo setcap CAP_NET_BIND_SERVICE+eip /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java

41. Q. 如何实现远程搜索

A. 首先远程消息搜索是有意义的,在Web客户端中只能同步少量消息,搜索功能几乎不可用;另外在原生客户端中,即使有本地存储,可能因为更换手机等原因,导致本地存储消息不全。如果实现了远程消息搜索则会提高用户体验,而且这将是超过市面上大部分即时通讯软件的体验。

其次野火没有实现远程搜索:1. 野火支持多种数据库,无法在所有数据库上实现搜索,而且在关系型数据库中搜索功能比较弱,也需要引入像ES之类的搜索数据库。2. 野火消息只存储3年,超过3年的消息需要转储,转储的数据库也是客户自己来实现的,野火无法实现。

这个功能客户可以自己来实现,在3年内的消息存储的关系数据库中,客户可以编写对数据库的简单搜索(注意性能的影响),也可以把数据内容实时同步到ES或者其他对搜索支持更好的数据库。3年之外的消息客户需要自己转储,需要在转储的消息中实现搜索。一旦客户选定数据库,实现还是很简单的。

42. Q. 内置文件存储有什么缺点?为什么不建议线上试用?

A. 野火支持内置文件存储和独立对象存储服务。内置文件存储就是在IM服务中支持文件上传和下载;独立对象存储就是跟IM服务分开,单独为客户端提供文件服务的。社区版IM服务支持七牛云对象存储,专业版IM服务此外还支持主流云服务对象存储和minio私有对象存储。此外也可以对接其他文件存储这里就不做说明了。

内置文件存储设计比较简单,只支持文件的上传和下载,无法提供独立对象存储服务的功能,其中包括集群功能、高可用、水平扩展、自动纠错、后台管理、在线播放等。独立存储服务另外也具有更高的性能。内置对象存储服务要公用IM服务带宽,这样如果有大量文件上下载,可能会影响到IM服务的正常使用。

因此仅建议内置文件存储用于开发测试环境,或者人数较少且对数据丢失(比如磁盘损坏或者误删)敏感性不高的生产环境。

43. Q. 日志怎么改成同步写?怎么样才能高效地抓取问题日志?

A. 野火IM服务都是使用log4j2日志组件的,默认日志是异步写的,这样上线后效率更高,缺点就是日志不是实时写入的,往往要等待一段时间才会写入,这样给查找问题带来了不变。解决这个问题很简单,修改config/log4j2.xml文件,把下面这个immediateFlush属性的值从false改成true

<RollingRandomAccessFile name="RollingFileInfo" immediateFlush="true"
                         fileName="${MSG_LOG_HOME}/wildfirechat.log"
                         filePattern="${MSG_LOG_HOME}/backup/wildfirechat.%d{yyyyMMddHHmm}.zip">

不需要重启,等待3分钟后,日志就会变成同步的了,可以操作一下客户端,看看是不是有对应的日志。注意上线时要改回false,这样才不会影响性能。

一般使用野火IM的问题都是在刚开始接入的时候,有时需要抓取日志给野火来分析,一个高质量的日志对解决问题是非常有帮助的。最好是能够同时抓取客户端和服务器的日志,避免掉无效的日志干扰。可以把日志改成同步以后,使用命令tail -f logs/wildfirechat.log实时观察日志,然后操作客户端等操作结束后,ctrl+c结束日志。屏幕上的日志就是操作时打印的IM服务的日志,把这段日志和客户端日志一起发给我们。

2018 © wildfirechat.net 京ICP备18060403号-1 all right reserved,powered by Gitbook该文件修订时间: 2023-11-21 14:25:14

results matching ""

    No results matching ""