详解C-Lodop云服务中AO打印的监控功能
 
    由于单台C-Lodop打印服务器挂接的AO端桥/AO打印机数量越来越多,有些用户已一台挂几百台,

从C-Lodop6.594版开始,增加了Web方式监控,便于管理者深入分析,同时避免了分析时干扰系统运行,

因此建议监控分析时尽量使用本文所述Web页面,别再用服务程序的弹窗界面啦!相关说明如下:

1、进入途径

1.1、系统监控采用Web方式进入,具体路径为

   安装成功且启动界面 -> 去了解C-Lodop -> 欢迎页面-> 查看系统信息 -> [More>>]  

   或者直接用Web地址进入:
   http://demo.lodop.net:8000/c_sysmessage?subopt=help  (以"demo.lodop.net"这台AO服务器为例)
   http://localhost:8000/c_sysmessage?subopt=help   (如果是本机)

   进入时需要登录信息,登录用户名是管理员admin ,初次密码为空(密码修改在欢迎页面第二步"设置密码")

1.2、监控功能分如下四部分:

   AO打印的总体情况 [AO-Print Total]查看AO设备现状及任务统计数据,适合概况分析,查询对服务无影响

   AO打印的详细信息 [AO-Print TaskMessage]查看任务详细数据,适合明细分析,量大查询对服务稍微影响

   当前系统运行记录 [System RunLog]查看程序运行记录,适合辅助打印开发和任务追踪

   系统故障出错信息 [System Error]查看出错信息,适合故障排查和产品改进

   下面对它们分别介绍:

2、AO打印的总体情况

2.1、[AO-Server] 当前服务器现状及服务主参数

   AO-Server(Port:9200) Running: AO服务器(端口:9200)运行状态:启动ON  停止OFF

   Server StartTime: 服务器启动时间:2024-01-27 03:00:23

   Server StopTime  服务器停止时间:(若这期间曾停止过)

   AO_Heartbeat_TimeOut(HTO): (定义)打印机心跳超时秒数:50 secs  

     一个打印机50秒无心跳就算死机,主动对其断线处理,这项设置简称HTO,该值的修改操作需另外途径:

     启动界面 -> 设置 -> 扩展功能 -> AO打印服务 -> 服务选项 -> 服务选项设置

   AO_Print_TimeOut(PTO) (定义)打印指令超时的秒数:60 secs

     任务发送60秒后无返回结果算超时,放弃等待,继续下一个,该设置简称PTO,其修改操作也在 服务选项设置

   AO_Task_ReserveTime(TRT) 打印任务保留秒数:7200 secs

     每个打印任务保留7200秒(2小时),以便于打印排队和查询,该设置简称TRT,其修改操作途径同上,

     超出该保留时间,没有打印的任务会被放弃,打印过的也看不到明细,但累计数据依旧。

   AO_UpdateBridge(UPB) 是否检查端桥的版本:是truefalse

     当端桥的软件版本需要统一升级时设置true,其修改操作途径同上,

     升级时要把新版本的安装程序压缩放置在 Rootdir\CLodop_Setup.zip文件里(Rootdir在Lodop主目录下)。

   AO_ReplaceSameConnect(RSO) 是否覆盖相同链接:是truefalse

     当AO端桥/AO打印机网络不稳时,设置“覆盖(DEVID)相同链接”为true,可剔除因反复连接产生的垃圾链接,

     其修改操作在以上 服务选项设置 窗口的右键菜单里

   AO_RetryforSending(RFS) 正发送过程中的任务重连后是否补打:是truefalse  

     当AO打印机确实因网络原因丢单时,这个设置有用,其修改操作也在以上右键菜单里

   AO_RetryforSendNoBack(RFN) 已发送无结果的任务重连后是否补打:是truefalse 功能和操作同上。

   AO_Printer_Keys(KEY) AO打印机握手密钥AO_KEY: (例如 ABC 或者多秘钥 ABC;RPP )

     该秘钥是为了阻挡非法AO打印机链接本服务用的,适合专门系统,需要AO打印机端通讯程序的配合,

     秘钥用任意字母组成,分号分隔多秘钥,如"Dscm;RPP"可同时允许带Dscm秘钥和RPP秘钥的两款打印机连接。

     秘钥提前设置在Lodop主Ini文件里,重启后生效,具体途径为:

     SetupOption\MainOption.ini -> [MainService] -> ao_printer_keys

     例如:
     [MainService]

     ao_printer_keys=Dscm;RPP

2.2、[AO-Printer Total Count] 客户端AO设备及打印任务总数

   Printers MaxCount: 在线AO端桥/AO打印机最大个数,这是开机后的历史最大值。

   AllOK TaskCount: 已经成功打印的打印任务累计数。

   AllSend TaskCount: 已转发出去的打印任务累计数,其中含失败的任务。

   NoSend TaskCount:(各种原因)未转发出去的任务累计数,它与前者相加是总任务数。

2.3、CurrentList 当前在线AO设备清单 (PrinterCount: 正常AO设备数/网络Socket连接数, TaskCount:打印任务总数)

   清单中每个条目的数据定义如下:

   序号: 
   [ 设备驱动名 ][ 设备编号 ][ 设备标识名 ] [ 设备IP地址 ]
   [ 端桥版本号 ][ 通讯版本号 ][ 字符编码 ] [ 设备状态 ] [ 子状态 ] [ 上线时间 ] [ 最后活跃时间 ]
   [ RelinkTimes:网络重连次数 ][ HistIPs:历史IP清单 ]
   TaskCount:打印任务数

   示例:

   CurrentList: ( PrinterCount:150/165 , TaskCount:1060 )

   1: [ (AO)Client-Bridge Driver ][ C0889098332 ][ 我的端桥001 ] [ 222.132.137.165 ]
   [ CB6.6.0.7 ][ VER1.0 ][ UTF-8 ][ Ready ][ ][ 24-10-29 10:28:36 ][ 24-10-29 10:32:15 ]
   [ReLinkTimes:2 ] [HistIPs:222.132.137.165 ]
   TaskCount:3

   2: [ (AO)Client-Bridge Driver ][ C7896816805 ][ 容大物联test01 ] [ 175.30.75.183 ]
   [ CB3.0.7.5 ][ VER1.0 ][ UTF-8 ][ Ready ][ ][ 24-10-31 13:06:05 ][ 24-10-31 13:19:14 ]
   [ReLinkTimes:12 ] [HistIPs:175.30.75.183 ]

   3: [ DASCOM DL-310Z ][ 123456789012 ][ DASCOM310型01号AO打印机 ] [ 222.132.137.165 ]
   [ VER1.0;ZPLⅡ ][ UTF-8 ][ Ready ][ 子状态也ok ]
   [ KEY: Dscm ][ HTO: 300 ][ PTO: 60 ][ RSO: 1 ][ RFS: 1 ][ RFN: 1 ][ 24-10-31 13:26:56 ][ 24-10-31 13:26:58 ]
   [ReLinkTimes:9 ] [HistIPs:222.132.137.165 ]

   ...

   每个条目含多项信息,其中粗体部分是可识别设备的关键信息,目前设备分AO端桥AO打印机两大类,

   (AO)Client-Bridge DriverAO端桥专用驱动名,而AO打印机的驱动名是传统打印机驱动名称(或集合);

   业务系统管理者应保证设备编号+设备标识名唯一性;设备编号(DEVID)是RSO的依据;字符编码是AO打印机端

   要求AO服务器传送字符前的编码格式,而AO端桥的字符编码固定为UTF-8;设备状态反应是否缺纸、有没准备好,

   该值来源于远端,默认是Ready ,远端可自定义该值,[ ]表示没有返回信息,状态未知;子状态同理;

   通讯版本号默认是VER1.0,目前远端可选的版本还有 VER1.1 和 VER1.11,服务端同时支持这些版本;

   如果这里出现 HTO: PTO: RSO: RFS: RFN 关键字项,说明对应的服务主参数被远端重新定义了新值,

   注意这里逻辑参数值true是1,false是0,此时AO服务器会针对该AO设备单独执行新的服务策略。

   KEY:是远端报送来的握手秘钥,显然它不能被远端重定义,只能与服务器预设的握手秘钥AO_KEY进行匹配;

   网络重连次数ReLinkTimes反应该设备的网络稳定性;历史IP HistIPs 能看出(移动)设备跨网游走情况;

   TaskCount是该设备所执行打印任务的累计数,设备断网后重连不影响继续累计。

   如果出现网络Socket连接数甚至该数比正常AO设备数大很多,说明本服务主机受网络恶意骚扰严重。

2.4、HistoryList 历史AO设备清单

   历史设备是指已经断线的AO端桥/AO打印机,其数据定义同上,不再累述,历史数据保留时间也受TRT控制。

3、AO打印的详细信息

3.1、[AO-Printer TaskMessage] AO打印的详细条目信息

   先看下示例:

   1: [ (AO)Client-Bridge Driver ][ C0889098332 ][ 我的端桥001 ]
   TaskCount:2
   TaskID:582AABE102730_1 LastTime:10-29 10:27:52 Status:Sended OK
   TaskID:582AABE102731_2 LastTime:10-29 10:27:52 Status:Sended OK


   2: [ DASCOM DL-310Z ][ 123456789012 ][ DASCOM310型01号AO打印机 ]
   TaskCount:5
   TaskID:582AABQ103111_1 LastTime:10-29 10:31:36 Status:Sended OK
   TaskID:582AABQ103120_2 LastTime:10-29 10:31:45 Status:Sended OK
   TaskID:582AABQ103120_3 LastTime:10-29 10:31:46 Status:Sended OK
   TaskID:582AABQ103121_4 LastTime:10-29 10:31:46 Status:Sended OK
   TaskID:582AABQ103121_5 LastTime:10-29 10:31:47 Status:Send over,wait reply

   ...

   每个条目含三项信息,其中任务编号TaskID是唯一性识别串,该字符串的结尾是小范围顺序号;

   时间戳LastTime是任务最后活跃时间,多数是打印成功后返回结果的时间;

   任务状态Status值有如下几种:

   NO send 未发送
   Sending 正发送
   Send over,wait reply 发送完毕,等待反馈
   Timeout for sending 发送超时
   Sended OK 发送完毕并成功
   unknown 未知(错误)

4、当前系统运行记录

  [System RunLog] 当前系统运行记录

   注意运行记录仅保留最后500条,以保护服务器持续运行性能,最常见运行事件如下:

   Request 打印请求事件
   Done   打印完成事件(接收完毕)
   unDone  打印未完成事件(接收出错)
   AO_HTO  心跳超时事件
   AO_DisAll 清理所有链接事件
   AO_BadKEY 错误的AO握手秘钥事件
   AO_RSO    覆盖相同链接事件
   AO_Clear  清理超出TRT值的打印任务事件
   DLFileOK_ 下载文件成功事件
   DLFileError 下载文件失败事件

   更详细的说明略。

5、系统故障出错信息

  [System Error] 系统故障出错信息

  该信息为Lodop产品研发人员分析使用,相关说明略。

<完>  

<<转到博文目录