目录
一、摘要
IEC61850日志服务通常用来记录遥测、遥信等点位变化信息;日志服务可以将这些变化信息持久化保存,在设备停止运行或出现异常时,这些日志信息会存入持久化存储介质。
当设备可能需要追溯点位变化的情况,则可以使用日志服务进行变化日志记录,客户端可以通过日志服务提供的相关命令,进行日志内容查询。
二、IEC61850日志服务介绍
日志服务总共包含五个命令,分别是读日志控制块值(getLCBValues)、设置日志控制块值(setLCBValues)、读日志状态(getLogStatusValues)、按时间查询日志(queryLogByTime)、按条目查询日志(queryLogAfter)。
1. 读日志控制块值(getLCBValues)
1.1 读日志控制块值请求命令携带的参数有:
LCBReference: 日志控制块路径
1.2 读日志控制块值响应携带的参数有:
A.正响应
当请求命令被正确执行时,服务器需要回复正响应。
LogEnable:日志控制块当前的使能状态
DataSetReference:日志控制块绑定的数据集路径
TriggerOptionsEnabled:日志控制块的日志触发项
IntegrityPeriod:周期日志的周期时间ms
LogReference:日志路径(日志分类标识)
OptionalFields:日志可选项(通常不会存在)
BufferTime:日志缓存时间(通常不会存在)
B.负响应
当请求命令未被正确执行时,服务器需要回复负响应,负响应要带上错误原因。
ServiceError:服务错误原因码(枚举类型)
2. 设置日志控制块值(setLCBValues)
2.1 设置日志控制块值请求命令携带参数有:
BufferTime:可设置日志缓存时间(通常不存在)
DataSetReference:可设置日志控制块绑定的数据集路径
IntegrityPeriod:可设置周期日志的周期时间ms
LCBReference:被设置的日志控制块路径
LogEnable:可设置日志控制块当前的使能状态
LogReference:可设置日志路径(日志分类标识)
OptionalFields:可设置日志可选项(通常不存在)
TriggerOptionsEnabled:可设置日志控制块的日志触发项
2.2 设置日志控制块响应携带的参数有:
A.正响应
当请求命令被正确执行时,表明设置成功,回复空的正响应,不需要携带参数。
B.负响应
当请求命令未被正确执行时,服务器需要回复负响应,负响应要带上错误原因。
ServiceError:服务错误原因码(枚举类型)
3. 读日志状态(getLogStatusValues)
3.1 读日志状态请求命令携带的参数有:
LogReference:日志路径(日志分类标识)
3.2 读日志状态响应携带的参数有:
A.正响应
当请求命令被正确执行时,回复正响应,内容含日志状态信息。
OldestEntryTime:旧条目时间(第一条日志条目产生时间)
NewestEntryTime:最新条目时间(最新一条日志条目产生时间)
OldestEntry:旧条目号(第一条日志条目号)
NewestEntry:最新条目号(最新一条日志条目号)
B.负响应
当请求命令未被正确执行时,服务器需要回复负响应,负响应要带上错误原因。
ServiceError:服务错误原因码(枚举类型)
4. 按时间查询日志(queryLogByTime)
4.1 按时间查询日志的请求命令携带的参数有:
LogReference:日志路径(日志分类标识)
RangeStartTime:日志查询条件(时间范围)-开始时间
RangeStopTime:日志查询条件(时间范围)-结束时间
4.2 按时间查询日志响应携带的参数有:
A.正响应:
当请求命令被正确执行时,回复正响应,内容含满足查询条件的所有日志条目信息;当没有设置查询条件时,返回全部的日志条目信息。
ListOfLogEntries:日志条目信息数组
B.负响应:
当请求命令未被正确执行时,服务器需要回复负响应,负响应要带上错误原因。
ServiceError:服务错误原因码(枚举类型)
5. 按条目查询日志(queryLogAfter)
5.1 按条目查询日志的请求命令携带的参数有:
LogReference:日志路径(日志分类标识)
RangeStartTime:日志查询条件(时间范围)-开始时间
Entry:日志查询条件(条目范围)-起始条目号
5.2 按条目查询日志响应携带的参数有:
A.正响应
当请求命令被正确执行时,回复正响应,内容含满足查询条件的所有日志条目信息;当开始时间有效,开始条目无效时,按有效时间返回;当开始时间无效,开始条目有效时,返回空列表;当开始时间有效,开始条目有效时,按两个条件结果集的交集进行返回;当开始时间和开始条目均无效时,返回空列表。
ListOfLogEntries:日志条目信息数组
B.负响应
当请求命令未被正确执行时,服务器需要回复负响应,负响应要带上错误原因。
ServiceError:服务错误原因码(枚举类型)
三、总结
日志业务属于被动业务,其记录的信息需要由客户端进行对应的条件查询才能获得;客户端在进行条件查询日志之前,通常会通过读日志状态命令来获取日志状态信息,以确保能正确携带查询条件。日志业务所产生的日志信息,也会被要求进行持久化保存(存入文件中或持久型数据库中),在需要被查询时,可以完整地支持查询条件。
以上是今日分享,欢迎感兴趣的朋友评论区留言交流。