如何查看ejabberd服务器存储于Mnesia数据库中的历史记录

ejabberd写入Mnesia的历史记录主要分为两类：mod_mam模块存储的全量消息归档（存在archive表）、未投递的离线消息（存在spool表），系统管理员可以通过以下三种方式查看，优先推荐使用官方自带工具操作，避免直接操作数据库导致损坏：

方法1：使用ejabberdctl内置命令查询（最安全，推荐优先使用） #

不需要进入数据库交互层，直接调用官方封装的接口即可查询，不会破坏数据结构：

• 操作前先切换到ejabberd的运行用户（默认一般是ejabberd用户），避免权限校验失败
• 查看指定用户指定时间范围的MAM归档历史，执行命令：

  ejabberdctl get_mam_messages <用户名> <域名> <起始Unix时间戳(秒)> <结束Unix时间戳(秒)>
  

  示例：查询user1@example.com在2024年1月1日到2024年6月1日的历史记录，对应命令为ejabberdctl get_mam_messages user1 example.com 1704067200 1717200000
• 查看历史记录表的存储统计（总条数、占用空间等），执行ejabberdctl mnesia info archive即可
• 查看待投递的离线消息，执行ejabberdctl get_offline_messages <用户名> <域名>

方法2：进入Erlang控制台直接查询Mnesia表（适合自定义筛选场景） #

如果需要做复杂条件的筛选查询，可以进入ejabberd的live控制台直接操作Mnesia：

• 执行以下命令进入交互控制台：

  ejabberdctl live
  

• 查询archive表前10条记录，在控制台输入以下Erlang代码回车执行：

  mnesia:transaction(fun() -> mnesia:select(archive, [{'$1', [], ['$1']}], 10, read) end).
  

• 按用户JID匹配查询对应历史，替换代码中的JID即可：

  mnesia:transaction(fun() -> mnesia:match_object({archive, <<"user1@example.com">>, '_', '_', '_', '_', '_'}) end).
  

注意：进入控制台后禁止执行写入、删除、表结构修改类操作，操作前建议先备份Mnesia数据目录（默认路径为/var/lib/ejabberd/），避免数据丢失。如果要查询离线消息，把上述代码中的表名archive替换为spool即可。

方法3：导出数据离线查询（适合批量分析，不影响线上服务） #

如果需要对全量历史做批量统计分析，建议先导出数据副本，在测试环境操作不占用线上资源：

• 执行导出命令生成Mnesia数据备份文件：

  ejabberdctl export /opt/ejabberd_backup/ ejabberd_history.dump
  

• 把导出的dump文件拷贝到本地测试的ejabberd环境，加载到本地Mnesia实例后再做查询、解析即可，不会对线上服务造成任何影响。

内容的提问来源于stack exchange，提问作者Ivan