| 索引号 | 11330300MB15308713/2023-00044 | ||
| 组配分类 | 其他文件 | 发布机构 | 温州市大数据发展管理局 |
| 成文日期 | 2023-08-23 | 公开方式 | 主动公开 |
| 文号 | 温数函〔2023〕5号 | 有效性 | 有效 |
市各有关单位，各县（市、区）财政局、大数据中心：
现将《温州市市本级党政机关信息化应用日志建设指南》印发给你们，请认真组织实施，确保应用系统日志建设规范、数据归集准确，全面支撑运行指标的在线监测和应用绩效的综合分析，以评促建提升应用系统实战实效水平。
温州市大数据发展管理局 温州市财政局
2023年8月23日
温州市市本级党政机关信息化应用
日志建设指南
根据《温州市市本级党政机关信息化项目建设管理办法》（温政发〔2021〕19号）精神，为提升应用系统绩效评价工作的完整性、准确性和及时性，更好提升应用系统实战实效能力和建设管理规范化水平，制定本指南。
一、建设目标
围绕应用绩效评价指标体系，规范应用日志建设，实现应用日志完整采集和集中管理，为绩效评价提供数据支撑。
二、适用范围
2023年以来市本级各单位新建或迭代升级的应用，以及2021年以来在国家、省级获奖的优秀应用。
各县（市、区）相关应用可参照执行。
三、建设规范
日志是记录应用系统在运行中发生事件的数据文件，其中用户行为日志指用户在系统中进行相关操作行为的记录，如对数据进行增删改及进行相应的业务操作等，字段包括用户标识、用户类型、地区编码、操作类型、操作标识、事件类型、办理时长、操作时间、操作时长、操作状态等；应用指标日志是指应用系统的基本信息和预期目标，字段包括应活跃率、年新增关键业务数据条数、业务指标、应用编码等。
（一）用户行为日志字段规范
中文名 | 英文名 | 数据类型 | 描述 | 示例 |
用户标识 | userId | 字符串 | 用户id，原则上为浙政钉id或浙里办id | 5630839 |
用户类型 | userRole | 字符串 | 目前限定为群众、企业、政府工作人员、第三方 | 政府工作人员 |
地区编码 | areaCode | 字符串 | 前六位行政区划代码 | 330102 |
操作类型 | actionType | 数字 | 字典定义为：1-登录 2-离开 3-办事开始 4-办事结束 5-进入某功能模块 | 1 |
操作标识 | actionId | 字符串 | 当actionType为3 - 办事开始、4 – 办事结束时，actionId用来对某一次办事进行唯一标识，一般为事件的id； 当actionType为5-进入某功能模块时，actionId为该功能模块的名称，可以中文表示 | a01dfb8581fe/统计分析 |
事件类型 | eventType | 字符串 | 当actionType为3 - 办事开始、4 – 办事结束时，用eventType对事件类型进行唯一标识，一般为中文 | 申报审批 |
办理时长 | processingTime | 数字 | 当actionType为4 – 办事结束时，需要记录总办理时长，单位为秒 | 900 |
操作时间 | actionTime | 字符串 | 用户操作发生时间，精确到秒，字段标准格式为yyyy-MM-dd HH:mm:ss | 2023-04-11 10:01:04 |
操作时长 | actionDuration | 数字 | 处理用户操作的时长，即后端接口接受到请求到返回的用时，单位为毫秒 | 838 |
操作状态 | actionStatus | 数字 | 应用系统处理用户操作的结果状态，字典定义为：0-成功 1-失败 | 0 |
应用编码 | appCode | 字符串 | 应用系统在IRS上注册后的应用编码 | A3300001000002021050041X |
示例：
{
"userId": "5630839"，
"userRole": "政府工作人员"，
"areaCode": "330302"，
"actionType": 3，
"actionId": "475613813"，
"eventType":"申报审批"，
"processingTime":""，
"actionTime": "2023-04-27 10:11:31"，
"actionDuration": 58，
"actionStatus": 0，
"appCode":"A330302305457202111000005"
}，{
"userId": "5630839"，
"userRole": "政府工作人员"，
"areaCode": "330302"，
"actionType": 5，
"actionId": "表单创建"，
"eventType":""，
"processingTime":""，
"actionTime": "2023-04-27 10:11:35"，
"actionDuration": 40，
"actionStatus": 0，
"appCode":"A330302305457202111000005"
}
（二）应用指标日志字段规范
中文名 | 英文名 | 格式 | 描述 | 示例 |
应活跃率 | activeRate | 字符串 | 由各单位根据应用类型确定分地区和分用户群体的预期应活跃率 | 100% |
年新增关键业务数据条数 | businessData | 数字 | 年新增关键业务数据条数 | 50000 |
业务指标 | ext | 字符串 | 数组集合，各单位需根据实际业务确定其多个业务指标，在此字段中以键值对的形式传递 | [{“key”:”表单数”，”value”:”1000”}] |
应用编码 | appCode | 字符串 | 应用系统在IRS上注册后的应用编码 | A3300001000002021050041X |
示例：
{
"activeRate": "100%"，
"businessData": 50000，
"ext": [{"key":"表单发布数"，"value":"1000"}，{"key":"表单填报数"，"value":"2000"}]，
"appCode":"A330302305457202111000005"
}
四、日志归集
各单位在建设应用时，应按照日志建设规范生成应用日志文件或数据表，并采用日志归集组件（对应日志文件形式）或库表对接（对应数据表形式）方式将日志数据归集至日志数据仓，实现集中展示和分析。
（一）归集组件
该方式适用于没有开发采集操作日志功能的应用系统或已经有日志文件但需要按日志规范改造的应用系统。
1.命名规范
各应用日志文件应按照“日志类型_应用编码_log”格式命名。其中，日志类型：00表示用户行为日志，01表示应用指标日志；应用编码为IRS应用编码。示例：某应用的用户行为日志文件命名则为00_A330000220510202205016994_log。
2.实施步骤
（1）组件下载。各单位登录PLMS下载归集组件压缩包。
（2）文件配置。解压组件压缩包，会出现一个可执行文件和一个配置文件夹conf。打开conf文件夹里的cfg.ini文件，并按照如下内容进行配置：
[Kafka]
addr=10.36.128.101:9092
username=username
password=password
[CollectPath]
Path=/path/to/collect1/.*，/path/collect2/.*
其中，addr表示推送的消息队列地址，username和password表示账号密码；path是要采集的应用日志文件存储路径，如有多个路径应以英文逗号分隔；多个日志文件可以使用正则匹配。
（3）归集数据。执行命令./logsh完成配置，开始归集数据。
（4）数据校验。归集组件自动对归集数据格式进行校验，符合格式要求的数据才能推送成功。
（二）库表对接
该方式适用于用数据表或数据库形式保存日志的应用。
1.命名规范
参照公共数据平台编目规范要求对用户行为日志表和应用指标日志表进行命名。
2.实施步骤
（1）日志入库。各单位根据日志建设规范要求，在数据库中设置对应的日志数据表（包括用户行为日志表和应用指标日志表），并实时将日志数据写入表内。
（2）数据归集。各单位根据公共数据平台编目要求编制应用日志数据目录，并按照规定周期将日志数据（用户行为日志和应用指标日志）归集至公共数据平台。
五、实战实效分析
根据应用绩效评价“4+25+X”指标体系（见附件），日志归集将同系统填报、系统对接的采集的数据，一并作为绩效评价的基础数据，实现应用运行指标的在线监测、应用绩效的综合分析，以评促建推动应用系统实战实效。
“4 25 X”绩效评价指标说明.docx