设备数据打印配置

用户在创建边缘网关后，设备数据打印配置默认为关闭状态，此时边缘网关不会在本地记录设备上报的点位数据。用户可以开启或修改该配置对日志进行打印。在数据丢失敏感的高可靠场景下，用户可以通过开启设备数据打印配置来检查边缘网关是否上报数据成功，当点位数据丢失时，方便排查定位上报全链路中的异常点。

当用户启动该配置后，在网关机器上的日志根路径下，系统模块hub会增加一个payload日志子目录，用来记录网关成功上报的点位数据。边缘网关上报的点位数据会在网关机器或者虚机上保存一份副本，形式为.gz后缀的压缩文档。例如：日志根路径为/var/IoTEdge/log，那么记录数据的文件位于/var/IoTEdge/log/sys_edge_hub/log/payload下。

该配置包含三个参数：disk_quota、age、state。

表1 参数说明
参数名称	参数描述
disk_quota	磁盘配额，用于限制设备数据记录消耗磁盘空间的最大值，防止数据量过大，记录数据消耗太多磁盘资源，影响其他应用。数据记录文件超出限制时，边缘网关会主动清理最旧的文件。用户可按照实际情况配置，不可超出实际资源的最大值。
age	老化时间，用于老化数据记录文件，如果旧的数据记录文件超出老化极限，在重新写入新压缩文件时，会清理旧的压缩文件。
state	配置的开关，用于标识配置是否需要生效。

操作步骤

选择需要配置的网关，单击网关名称进入“节点详情”页面。

图1 选择边缘网关
进入“节点详情”后，单击“数据配置”页签。

图2 数据配置页签
开启“设备数据打印配置”开关，填写磁盘配额和老化时间参数，单击“确认”，此时开始记录网关成功上报的点位数据。

磁盘配额：限制记录数据的文件占用的磁盘空间，范围是1024~5120之间的整数，单位为MB。

老化时间：限制记录数据的文件的保存时间，范围是1~7之间的整数，单位为天。

磁盘配额需要根据实际机器资源填写，否则在网关上报数据量较大时，存在磁盘写满，影响机器上其他程序运行的风险。

图3 打开设备数据打印配置开关

图4 开启配置开关后的页面
关闭设备数据打印配置开关。

图5 开关关闭页面

配置开关重新开启可以复用关闭前的配置值。
编辑修改参数，单击“确定”。

新配置代替旧配置生效期间，记录功能会短暂关闭，可能会导致数据漏记，不推荐频繁修改。

图6 编辑配置页面