转发系统日志到第三方日志服务器

默认情况下,PBX 系统定期会自动删除最早的系统日志。为保证全面记录日志以用于日常故障排除和紧急事件处理,你可以配置 PBX 通过 Syslog 协议,利用 UDP、TCP 或 TLS 传输方式, 将系统日志转发到本地或远程的第三方日志服务器,实现日志的集中记录和长期存储。

使用要求

Yeastar P 系列软件版 的固件为 83.14.0.24 或更高版本。

前提条件

你已搭建了一个 Syslog 日志服务器,并获取以下服务器信息:
  • IP 地址或主机名
  • 支持的传输协议和对应的传输端口

操作步骤

  1. 登录 PBX 管理网页,进入 维护 > 系统日志
  2. 在顶部菜单,点击 远程日志设置

  3. 打开 远程日志 开关,并完成以下配置。

    • 日志服务器:填写日志服务器的 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 系统之间的数据交互。

      此日志内容可用于监控集成中的数据同步和数据交换、排查集成问题等。

  4. 点击 保存

执行结果

PBX 系统开始实时向日志服务器转发所选的系统日志。