VOS3000 操作指南
VOS3000 CDR 文本文件
除了数据库之外,VOS3000 还可以每小时将所有通话写入一个纯文本文件,供您自己的计费或分析脚本使用。
更新于 · 作者:VOS3000 Web 团队
简要回答:将软交换参数 SS_CDR_RECORD_TO_FILE 设为开启后,VOS3000 还会将每条 CDR 写入文本文件,每小时一个文件,命名为 YYYYMMDDHH.txt,位于安装目录的 cdr 文件夹中。每行是一通电话,包含 19 个字段,从主叫、被叫到结束原因和 PDD。
- 开启
- SS_CDR_RECORD_TO_FILE = 开启
- 文件名
- YYYYMMDDHH.txt,每小时一个
- 通话时长
- 单位为毫秒
- 零秒通话
- 仅在开启 SS_CDR_RECORD_NONCONNECT 时
开启它
在 VOS3000 桌面客户端中,打开业务管理 → 软交换管理 → 补充设置 → 系统参数,将 SS_CDR_RECORD_TO_FILE 设为开启。如需包含通话时长为 0 秒的呼叫(失败和未接听的呼叫),还需将 SS_CDR_RECORD_NONCONNECT 设为开启。
文件位置
软交换将文件写入其安装目录下的 cdr 文件夹,每小时一个文件,命名为 YYYYMMDDHH.txt。文件 2026112114.txt 保存 2026 年 11 月 21 日 14:00 至 15:00 之间结束的通话。
字段说明
每行是一通电话,字段按以下顺序排列:
| # | 字段 | 含义 |
|---|---|---|
| 1 | callerE164 | 主叫号码 |
| 2 | calleeE164 | 被叫号码 |
| 3 | startTime | 开始时间,例如 2026-11-21 14:20:18 |
| 4 | stopTime | 结束时间 |
| 5 | holdTime | 通话时长(毫秒) |
| 6 | endReason | 结束原因代码;参见查询工具 |
| 7 | endDirection | 挂断方:0 主叫,1 被叫,2 服务器 |
| 8 | callerGatewayId | 主叫(对接)网关 |
| 9 | calleeGatewayId | 被叫(落地)网关 |
| 10 | callerIp | 主叫 IP |
| 11 | calleeIp | 被叫 IP |
| 12 | callerAccessE164 | 收到的主叫号码 |
| 13 | calleeAccessE164 | 收到的被叫号码 |
| 14 | callerToGatewayE164 | 送出的主叫号码 |
| 15 | calleeToGatewayE164 | 送出的被叫号码 |
| 16 | calleeBilling | 计费方:0 主叫,1 被叫 |
| 17 | billingMode | -1 不计费,0 话机号码,1 网关 ID,3 电话卡 |
| 18 | callerPdd | 从收到呼叫到接通的时间 |
| 19 | calleePdd | 从发出呼叫到路由响应的时间 |
第 12 至 15 个字段展示了拨号方案的效果:比较收到的号码与送出的号码。
使用这些文件
- 每小时将上一个完整小时的文件复制到您的计费或分析系统。
- 注意磁盘空间:这些文件不是您的计费记录,请归档或删除旧文件。
- SERVER_CDR_FILE_WRITE_INTERVAL 和 SERVER_CDR_FILE_WRITE_MAX 控制由 VOS3000 服务器写入的第二组可选 CDR 文件:新文件的生成间隔(60 至 86400 秒)以及保留的文件数量(默认 2048)。
关于查询 CDR、导出到 Excel 以及供您自有系统使用的 CDR 链接,请参见VOS3000 CDR。
关于本主题的常见问题
如何将 VOS3000 CDR 自动导出为文本文件?
将软交换参数 SS_CDR_RECORD_TO_FILE 设为开启。VOS3000 随后会在其安装目录的 cdr 文件夹中每小时写入一个文本文件。
holdTime 的单位是秒吗?
不是,单位是毫秒。除以 1000 即为秒。
CDR 文本文件中包含失败的通话吗?
通话时长为 0 秒的呼叫,只有在开启 SS_CDR_RECORD_NONCONNECT 时才会写入。