Get Event Record
更新时间: 2025/06/26
在Gitcode上查看源码40h-查询告警记录(Get-Event-Record)
修订记录
| openUBMC版本号 | 修订日期 | 修订内容 |
|---|---|---|
| 25.06 | 2025/06/26 | 初稿,新增命令详情 |
基本信息
功能说明
查询告警信息。
权限
ReadOnly
命令信息
请求信息
| 字节顺序 | 域取值说明 |
|---|---|
| NetFn | 30h |
| CMD | 94h |
| 1:3 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 |
| 4 | Sub command,子命令=40h |
| 5 | 低四位:request type,请求类型, 0-当前存在的告警;高四位:format,返回信息类型,0-为精简信息,目前仅支持0 1-查询历史事件;高四位:format,返回信息类型,0-为精简信息,目前仅支持0 |
| 6:7 | event index,一定条件过滤出多个事件时,查询事件起始编号,从0开始。 当查询到的事件信息单个消息容纳不下,则需要多次获取,第N次获取的偏移序号为0~N-1次查询到的事件数总和 |
| 8 | severity,严重等级,位图形式,bit0-normal,bit1-minor,bit2-major,bit3-critical,当对应bit为0时不包含该严重级别的事件,为1时表示包含该级别的事件;0xFF表示不指定等级 |
| 9 | subject type,主体类型,0xFF表示不指定主体类型 |
| (10) | request type=1时,有效: direction,事件方向,1-产生事件,0-恢复事件,0xFF-不指定方向 |
| (11:14) | request type=1时,有效: start time,起始时间戳(单位:秒),0xFFFFFFFF表示从最早的事件开始 |
| (15:18) | request type=1时,有效: end time,终点时间戳(单位:秒),0xFFFFFFFF表示到当前时间 |
响应信息
| 字节顺序 | 域取值说明 |
|---|---|
| 1 | Completion Code,异常返回码参见 Completion Code说明 |
| 2:4 | Manufacturer ID,LS Byte first。长度固定3个字节,例如,某厂家ID是2011,对应十六进制为0x0007DB,则字节序为第1个字节为DBh、第2个字节为07h、第3个字节为00h。 |
| 5:6 | total event num,事件总数量 |
| 7 | msg event num,本消息事件数量 |
| 8 | rev,填0 |
| 9:12 | event code,告警码 |
| 13:16 | time stamp,事件发生时间戳 |
| 17 | severity,严重等级,0-normal,1-minor,2-major,3-critical |
| 18 | subject type,主体类型 |
| 19 | device num,当主体类型下存在多个设备,表明部件设备Number,从0开始编号,0xFF为无效值。 |
| 20:23 | rev1,填0 |
| …… | …… |
| N+1:N+4 | event code |
| N+5:N+8 | time stamp |
| N+9 | severity |
| N+10 | subject type |
| N+11 | device num |
| N+12:N+15 | rev1,填0 |
Completion Code说明
|响应码|含义|建议| |COMP_CODE_SUCCESS 0x00|成功,并无数据待返回|等待下一轮发起请求| |COMP_CODE_BUSY 0xC0|失败,但可能存在数据待返回|立即重新发起请求| |COMP_CODE_DATA_TRUNCATED 0xC6|成功,并还有数据待返回|继续发起请求待返回数据| |COMP_CODE_OUTOF_RANGE (0xC9)|失败,并无待返回数据|检查请求参数| |其它|失败|检查请求参数|
命令样例
请求类型为0是,查询当前告警信息
请求:
ipmitool raw 0X30 0X94 0XDB 0X07 0X00 0X40 0X00 0x00 0x00 0x04 0xFF响应:
db 07 00 01 00 01 00 01 00 00 28 ff ff ff ff 02
28 01 00 00 00 00请求类型为1是,查询历史事件信息
请求:
ipmitool raw 0X30 0X94 0XDB 0X07 0X00 0X40 0X01 0x00 0x00 0x04 0XFF 0xFF 0XFF 0XFF 0XFF 0XFF 0XFF 0XFF 0XFF 0XFF响应:
db 07 00 13 00 0f 00 02 00 00 28 0c 0b d4 65 02
28 ff 00 00 00 00 01 00 00 28 71 0d d4 65 02 28
ff 00 00 00 00 02 00 00 28 53 9d d5 65 02 28 ff
00 00 00 00 01 00 00 28 6a 9d d5 65 02 28 ff 00
00 00 00 02 00 00 28 f3 a8 d6 65 02 28 ff 00 00
00 00 01 00 00 28 09 a9 d6 65 02 28 ff 00 00 00
00 02 00 00 28 63 b5 d6 65 02 28 ff 00 00 00 00
01 00 00 28 25 b8 d6 65 02 28 ff 00 00 00 00 02
00 00 28 6d e4 d6 65 02 28 ff 00 00 00 00 01 00
00 28 53 e8 d6 65 02 28 ff 00 00 00 00 02 00 00
28 49 f8 d6 65 02 28 ff 00 00 00 00 01 00 00 28
2f fc d6 65 02 28 ff 00 00 00 00 02 00 00 28 c2
ff d6 65 02 28 ff 00 00 00 00 01 00 00 28 b4 02
d7 65 02 28 ff 00 00 00 00 57 00 00 01 c5 69 da
65 02 01 ff 00 00 00 00