Yealink Zoom 设备可以将事件记录到两种不同的日志文件中:启动日志和系统日志。你可以选择在本地生成日志文件,或实时发送到 Syslog 服务器,并使用这些日志文件生成信息、分析和故障排除设备。
配置本地日志
你可以启用本地日志,指定严重级别,并选择将日志保存在本地或上传到配置服务器。本地日志文件可以通过网页用户界面同时导出。
通过设备用户界面
进入 更多 > 设置 > 通用 > 系统设置 > 调试(默认密码:admin)。
启用 日志 并将日志级别设置为 6。
通过网页用户界面
步骤
以管理员身份登录话机网页用户界面。
进入 设置 > 配置 > 本地日志。
启用 本地日志 并将日志级别设置为 6。
(可选)点击 导出 导出本地日志。
通过自动配置
下表列出了可以用于配置本地日志的参数。
static.local_log.enable
static.local_log.level
static.local_log.max_file_size
static.auto_provision.local_log.backup.enable
static.auto_provision.local_log.backup.upload_period
static.auto_provision.local_log.backup.path
static.auto_provision.local_log.backup.append
static.auto_provision.local_log.backup.append.limit_mode
static.auto_provision.local_log.backup.append.max_file_size
static.auto_provision.local_log.backup.bootlog.upload_wait_time
参数
允许值
默认值
描述
static.local_log.enable
0- 禁用,设备将停止记录日志到本地日志文件(<MAC>-boot.log 和 <MAC>-sys.log)。之前记录的日志文件仍保留在设备上。1- 启用,设备将继续记录日志到本地日志文件。你可以将本地日志文件上传到配置服务器或导出到本地系统。
1
启用或禁用设备在本地记录日志。
注意
建议不要禁用此功能。
static.local_log.level
0- 系统不可用 1- 需要立即采取行动 2- 严重情况 3- 错误情况 4- 警告情况 5- 正常但重要情况 6- 信息性
6
配置要记录到 <MAC>-sys.log 文件的最低本地日志信息级别。选择日志级别时,包括所有相同或更高严重级别的事件,并排除较低严重级别的事件。
static.local_log.max_file_size
2048 到 20480 的整数
20480
配置设备上可存储的日志文件的最大大小(以 KB 为单位)。当此大小即将超出时,如果本地日志文件配置为通过参数 static.auto_provision.local_log.backup.enable 上传到服务器,设备将在成功备份后清除设备上的所有本地日志文件。如果 static.auto_provision.local_log.backup.enable 设置为 0(禁用),设备将从设备上最旧的日志信息中删除一半的日志。
static.auto_provision.local_log.backup.enable
0- 禁用 1- 启用,设备将在以下任一情况下将本地日志文件上传到配置服务器或特定服务器以备份这些文件:触发自动配置;本地日志文件的大小达到参数 static.local_log.max_file_size 配置的最大值;根据参数 static.auto_provision.local_log.backup.upload_period 配置的上传周期上传本地日志文件。
0
启用或禁用设备将本地日志文件上传到配置服务器或特定服务器。
注意
上传路径由参数 static.auto_provision.local_log.backup.path 配置。
static.auto_provision.local_log.backup.upload_period
30 到 86400 的整数
30
配置本地日志文件上传到配置服务器或特定服务器的周期(以秒为单位)。
注意
仅在 static.auto_provision.local_log.backup.enable 设置为 1(启用)时有效。
static.auto_provision.local_log.backup.path
最长 1024 个字符的 URL
空
配置本地日志文件的上传路径。如果留空,设备将上传本地日志文件到配置服务器。如果配置相对 URL(例如,/upload),设备将通过从配置服务器的访问 URL 中提取根目录上传本地日志文件。如果配置带协议的绝对 URL(例如,tftp),设备将使用所需协议上传本地日志文件。如果没有协议,设备将使用与自动配置相同的协议上传文件。示例:static.auto_provision.local_log.backup.path = tftp://10.3.6.133/upload/。
注意
仅在 static.auto_provision.local_log.backup.enable 设置为 1(启用)时有效。
static.auto_provision.local_log.backup.append
0- 覆盖 1- 追加(不适用于 TFTP 服务器)
0
配置上传的本地日志文件是覆盖现有文件还是追加到现有文件。
static.auto_provision.local_log.backup.append.limit_mode
0- 追加删除,服务器将删除旧日志,设备将继续上传日志。1- 追加停止,设备将停止上传日志。
0
配置当配置服务器或特定服务器上的本地日志文件达到最大文件大小时的行为。
static.auto_provision.local_log.backup.append.max_file_size
200 到 65535 的整数
1024
配置在配置服务器或特定服务器上可存储的本地日志文件的最大大小(以 KB 为单位)。
static.auto_provision.local_log.backup.bootlog.upload_wait_time
1 到 86400 的整数
120
配置设备在启动后将本地日志文件上传到配置服务器或特定服务器之前的等待时间(以秒为单位)。
查看日志文件
你可以通过以下关键字段验证是否获得了正确的日志:
<0+emerg>
<1+alert>
<2+crit>
<3+error>
<4+warning>
<5+notice>
<6+info>
默认本地日志级别为 6。
下图显示了启动日志文件的一部分(例如,805EC031960A-boot.log):
启动日志文件报告所有严重级别的日志。下图显示了系统日志文件的一部分:
<MAC>-sys.log 文件报告配置的严重级别及更高的日志。例如,如果你将日志的严重级别配置为 4,那么严重级别为 0 到 4 的日志都会被报告。