转发系统日志到第三方日志服务器
默认情况下,PBX 系统定期会自动删除最早的系统日志。为保证全面记录日志以用于日常故障排除和紧急事件处理,你可以配置 PBX 通过 Syslog 协议,利用 UDP、TCP 或 TLS 传输方式, 将系统日志转发到本地或远程的第三方日志服务器,实现日志的集中记录和长期存储。
使用要求
Yeastar P 系列软件版 的固件为 83.14.0.24 或更高版本。前提条件
你已搭建了一个 Syslog 日志服务器,并获取以下服务器信息:
- IP 地址或主机名
- 支持的传输协议和对应的传输端口
操作步骤
- 登录 PBX 管理网页,进入 。
- 在顶部菜单,点击 远程日志设置。
- 打开 远程日志 开关,并完成以下配置。
- 日志服务器:填写日志服务器的 IP 地址或主机名。
- 端口:填写用于连接日志服务器的端口。
- 传输类型:在下拉列表中,选择日志服务器支持的传输协议。注: 如果要通过 TLS 加密传输,则必须在日志服务器上启用 TLS 加密,并上传需要的证书和密钥。
- 日志范围:在下拉列表中,选择要转发到日志服务器的系统日志范围。注: 系统日志中包含的信息取决于日志级别的设置 (路径: ) 。
下表列举了支持发送的系统日志范围及其对应包含的信息。
范围 说明 pbxlog.log 包含分机注册信息以及 PBX 通话的详细信息 (通话的建立、拨号规则匹配和持续呼叫时间等)。 此日志内容可用于分析通话质量和排查通话问题。
basicsrv.log 包含在使用 PBX 功能 (如话务控制台、队列面板、双机热备和其他非通话的功能) 时产生的逻辑日志。 此日志内容可用于追踪系统运行行为,检测异常情况和进行性能分析。
pbxtunnel.log 包含 Yeastar PBX 隧道相关信息,包括连接建立和心跳检测. 此日志内容可用于监控隧道连接状态、排查连接问题。
openapi.log 包含系统中 API 接口调用信息,包括接口请求、参数传输和响应结果等。 此日志内容可用于追踪 API 调用情况、排查接口问题和分析接口性能。
trace-new.log 包含系统进程运行状态的信息,包括守护进程的启动、关闭和异常退出,以及进程间的通信和协作。 此日志内容可用于调试和追踪。
thridapp.log 包含第三方集成信息 (系统与第三方系统或服务集成的过程和结果),例如 CRM 相关日志记录了 CRM 系统与 PBX 系统之间的数据交互。 此日志内容可用于监控集成中的数据同步和数据交换、排查集成问题等。
- 点击 保存。
执行结果
PBX 系统开始实时向日志服务器转发所选的系统日志。