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

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

使用要求

Yeastar P 系列 IPPBX 的固件为37.21.0.117或更高版本。

前提条件

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

操作步骤

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

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

    • 日志服务器:填写日志服务器的 IP 地址或主机名。
    • 端口:填写用于连接日志服务器的端口。
    • 传输类型:在下拉列表中,选择日志服务器支持的传输协议。
      注: 如果要通过 TLS 加密传输,则必须在日志服务器上启用 TLS 加密,并上传需要的证书和密钥。
    • 日志范围:在下拉列表中,选择要转发到日志服务器的系统日志范围。
      注: 系统日志中包含的信息取决于日志级别的设置 (路径:维护 > 系统日志 > 日志级别) 。

      下表列举了支持发送的系统日志范围及其对应包含的信息。

      范围 说明
      pbxlog.log 包含分机注册信息以及 PBX 通话的详细信息 (通话的建立、拨号规则匹配和持续呼叫时间等)。

      此日志内容可用于分析通话质量和排查通话问题。

      basicsrv.log 包含在使用 PBX 功能 (如话务控制台、队列面板、双机热备和其他非通话的功能) 时产生的逻辑日志。

      此日志内容可用于追踪系统运行行为,检测异常情况和进行性能分析。

      pbxtunnel.log 包含 PBX 隧道相关信息,包括连接建立和心跳检测。

      此日志内容可用于监控隧道连接状态、排查连接问题。

      openapi.log 包含系统中 API 接口调用信息,包括接口请求、参数传输和响应结果等。

      此日志内容可用于追踪 API 调用情况、排查接口问题和分析接口性能。

      trace-new.log 包含系统进程运行状态的信息,包括守护进程的启动、关闭和异常退出,以及进程间的通信和协作。

      此日志内容可用于调试和追踪。

      thridapp.log 包含第三方集成信息 (系统与第三方系统或服务集成的过程和结果),例如 CRM 相关日志记录了 CRM 系统与 PBX 系统之间的数据交互。

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

      apigateway.log API 网关日志记录其内部处理流程,包括当 PBX 系统接收大量 API 请求时触发的限流和熔断机制。

      此日志可用于监控流量控制策略的执行情况以及熔断操作的触发与恢复过程。

      cdrlog.log

      记录通话记录相关的事件,从通话建立、通话阶段、直至通话结束的全流程。

      此日志可用于追踪单个通话的完整生命周期,并分析通话行为。

      analytics.log 记录通话记录的数据处理情况,包括数据清洗、查询以及新数据结构下的通话处理过程。

      此日志可用于排查和追踪通话记录的数据处理问题。

  4. 点击 保存

执行结果

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