查看事件
更新時間 2025-04-23 15:02:54
最近更新時間: 2025-04-23 15:02:54
分享文章
本節主要介紹如何使用API查看事件。
此操作用來查看HBlock事件信息。
說明
系統可以保留6個月的事件。
請求語法
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| number | Integer | 指定最近事件的查詢個數。 取值：[1, 1000]，默認值為1000。 | 否 |
| type | String | 指定事件的類型。 取值：
默認值為user。 | 否 |
響應結果
| 名稱 | 類型 | 描述 |
|---|---|---|
| events | Array of event | 事件信息集合，詳見“表1 響應參數event說明”。 |
表1 響應參數event說明
| 名稱 | 描述 | |
|---|---|---|
| eventId | String | 事件ID。 |
| module | String | 事件所屬模塊。 |
| eventTime | Long | 對于用戶事件：HBlock接收到事件請求的時間，unix時間戳（UTC），精確到毫秒。 對于系統事件：事件發生時間，unix時間戳（UTC），精確到毫秒。 |
| name | String | 事件名稱。 |
| requestId | String | 用戶事件請求ID。 |
| requesterIP | String | 用戶事件中，發起請求的源IP地址。 |
| statusCode | Integer | 用戶事件響應狀態碼。 |
| errorCode | String | 用戶事件錯誤碼。 -：表示無錯誤碼。 |
| errorMessage | String | 用戶事件錯誤信息。 -：表示無錯誤信息。 |
| detail.method | String | 用戶事件的請求方法。 |
| detail.url | String | 用戶事件的URL。 |
| detail.body | String | 事件的請求體。 |
| instanceId | String | 系統事件針對的實例ID。 如果沒有實例ID，則不返回此項。 |
請求示例1
查詢HBlock用戶事件。
GET /rest/v1/system/event?number=2 HTTP/1.1
Date: Thu, 04 Aug 2022 06:12:33 GMT
Authorization: HBlock userName:signature
Host:192.168.0.121:1443響應示例1
HTTP/1.1 200 OK
x-hblock-request-id: d701da5a23c94eef8a8efe0907b12751
Connection: keep-alive
Content-Length: 853
Date: Thu, 04 Aug 2022 06: 12: 33 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"events": [
{
"eventId": "78f85f5e-e8ca-42b9-889d-834a167283cc",
"module": "System",
"eventTime": 1659429529758,
"name": "StartLogCollect",
"requestId": "f630a474bc7e4d9eba75f3b9d28e5d51",
"requesterIP": "36.111.88.33",
"statusCode": 202,
"errorCode": "-",
"errorMessage": "-",
"detail": {
"method": "POST",
"url": "/rest/v1/system/logcollect",
"body": "{\"startTime\":1659422322714,\"endTime\":1659429522714,\"servers\":[\"hblock_1\",\"hblock_2\",\"hblock_3\"],\"logTypes\":[\"Config\",\"System\",\"Data\",\"Coordination\"]}"
}
},
{
"eventId": "37fd582e-6d36-4174-a9bd-94c825316f8a",
"module": "System",
"eventTime": 1659429493016,
"name": "Login",
"requestId": "ab3c00578efb4372b1fd622d827ad97c",
"requesterIP": "36.111.88.33",
"statusCode": 200,
"errorCode": "-",
"errorMessage": "-",
"detail": {
"method": "POST",
"url": "/internal/v1/system/user/login",
"body": "{\"userName\":\"storuser\"}"
}
}
]
}
}請求示例2
查詢HBlock系統事件。
GET /rest/v1/system/event?number=2&type=system HTTP/1.1
Date: Thu, 4 Aug 2022 06:27:30 GMT
Authorization: HBlock userName:signature
Host:192.168.0.121:1443響應示例2
HTTP/1.1 200 OK
x-hblock-request-id: 9199a40fdf4c48c58ec5a4f7a1acda95
Connection: keep-alive
Content-Length: 454
Date: Thu, 4 Aug 2022 06:27:30 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"events": [
{
"eventId": "19cb57dd-5210-45af-a930-3d4cc70fe299",
"module": "System",
"eventTime": 1659343497897,
"name": "DataResumed"
},
{
"eventId": "1843075f-1281-4abc-af22-05a95c3a00ac",
"module": "System",
"eventTime": 1659343497897,
"name": "DataLowRedundancy",
"detail": {
"body": "{\"percent\": \"0%\"}"
}
},
{
"eventId": "6b6d9ec4-4a20-44d2-b00c-f3f154373a11",
"module": "Disk",
"eventTime": 1659343495978,
"name": "PathRemoved",
"instanceId": "hblock_2:/mnt/storage02"
}
]
}
}
