Search History Alerts¶

Search for the past 3 months’ historical alerts.

Request Format¶

POST https://{apigw-address}/event-service/v2.1/history-alerts?action=search

Request Parameters (URI)¶

Name	Mandatory/Optional	Data Type	Description
orgId	Mandatory	String	The organization ID which the asset belongs to. How to get orgId>>

Request Parameters (Body)¶

Name	Mandatory/Optional	Data Type	Description
modelId	Optional	String	The model ID. How to get modelID>>
assetId	Optional	String	The asset ID. How to get assetId>>
measurepointId	Optional	String	The measurement point ID. How to get pointId>>
startOccurTime	Optional	String	The start time for triggering the alert. For more details, see Time parameters used in API.
endOccurTime	Optional	String	The end time for triggering the alert. For more details, see Time parameters used in API.
recoverStartTime	Optional	String	The start time of the alert recovery. To be used with `recoverEndTime`. If left blank, the data within the last week will be searched. For more information, see Time parameters used in API.
recoverEndTime	Optional	String	The end time of the alert recovery. To be used with `recoverStartTime`. If left blank, the data within the last week will be searched. For more information, see Time parameters used in API.
expression	Optional	String	The query expression, which supports sql-like query. The supported logical operators are “and” and “or”, and query fields are as per the below. `deviceStatus`: supports operators “=” and “in”. `modelId`, `assetId`, `measurepointId`, `severityId`, `typeId`, `subTypeId`, `contentId`, `eventType`, `eventId`, `treeId` and `hitRuleId`: support operators “=”, “in”, and “!=”. `assetPath`: supports operator “like”. `tag.*`: supports operators “=”, “in”, “!=”, and “exists”. How to use expression>>
scope	Optional	Scope Struct	Query the alerts in a specified asset tree or in an asset node on the asset tree, and specify whether to return the blocked derivative alerts. This parameter cannot be applied with rootAlert. For more details, see Scope Struct.
rootAlert	Optional	RootAlert Struct	Query the derivative alerts which are blocked by the specified root alert. This parameter cannot be applied with scope. For more details, see RootAlert Struct.
pagination	Optional	Pagination Request Struct	Lists the paging requirements in a request. When not specified, 10 records are displayed per page by default and sorted in descending order by `occurTime`. The maximum records per page is 1000 but for optimal performance, it is recommended to have not more than 50 records per page. `sorters` is not supported to sort the response. For more details, see Pagination Request Struct.

Scope Struct ¶

Name	Mandatory/Optional	Data Type	Description
treeId	Mandatory	String	The asset tree ID.
fromAssetId	Optional	String	Return all alerts of and under the asset node of the specified asset ID. If not specified, the alerts of all the nodes in the specified `treeID` will be returned.
includeDerivative	Optional	Boolean	true = include the derivative alerts in the response false (default) = does not include the derivative alerts

RootAlert Struct ¶

Name	Mandatory/Optional	Data Type	Description
treeId	Optional	String	The asset tree ID.
rootAlertId	Mandatory	String	The root alert ID.

Response Parameters¶

Name	Data Type	Description
data	Array of HistoryAlert Structs	A list of the history alerts returned. For details of a historyAlert struct, see HistoryAlert Struct.

HistoryAlert Struct ¶

Name	Data Type	Description
eventId	String	The alert ID.
orgId	String	The organization ID which the asset belongs to.
assetId	String	The asset ID.
modelId	String	The model ID.
modelIdPath	String	The model ID path.
measurepointId	String	The measurement point ID.
deviceStatus	String	The device status.
hitRuleId	String	The rule ID of the triggered alert.
value	Integer/Double/Object	The measurement point value. If `triggeringDelayTimer` is specified in the alert rule, this value will be when the `triggeringDelayTimer` starts counting.
occurTime	Long	The UTC time when the alert occurs.
localOccurTime	String	The local time when the alert occurs.
recoverTime	Long	The recovery time in UTC format.
localRecoverTime	String	The recovery time in local format.
recoverReason	String	The recovery reason.
createTime	Long	The UTC time when the history alert was created.
updateTime	Long	The UTC time when the history alert was last updated.
severityId	String	The alert severity ID.
severityDesc	StringI18n	The alert severity description.
typeId	String	The alert type ID.
typeDesc	StringI18n	The alert type description.
subTypeId	String	The alert sub-type.
subTypeDesc	StringI18n	The alert sub-type description.
contentId	String	The alert content ID.
contentDesc	StringI18n	The alert description.
eventType	Integer	The event type. 0 = system-recovered alert 1 = system-triggered alert 2 = API-recovered alert 3 = API-inserted alert
tag	Map	User-defined tags. (The Key and Value are of String type.)
ruleDesc	StringI18n	The rule description.
assetPaths	String Array	A path list of the alert assets on the asset tree according to the scope of the alert rule. The format is: [“treeId1:/assetId1/assetId2/assetIdx”, “treeId2:/assetId3/assetIdx”]
maskedBy	String Array	If an alert is a derivative alert, return the root alert that caused the alert to be blocked. The format is: [“treeId1:eventId1”, “treeId1:eventId2”]

Samples¶

Request Sample¶

url: https://{apigw-address}/event-service/v2.1/history-alerts?action=search&orgId=yourOrgId
method: POST
requestBody:
{
    "endOccurTime": "2019-06-15T00:00:00Z",
    "expression": "eventId='20190612cf89cd96b0be4cafcc342d0dc2ac75a4'",
    "pagination": {
        "pageNo": 1,
        "pageSize": 2
    },
    "startOccurTime": "2019-05-20T00:00:00Z",
  "action": "search"
}

Return Sample¶

{
    "pagination":{
        "pageNo":1,
        "pageSize":2,
        "totalSize":1,
        "sortedBy":[
            {
                "field":"occurTime",
                "order":"DESC"
            },
            {
                "field":"eventId",
                "order":"DESC"
            }
        ]
    },
    "code":0,
    "msg":"OK",
    "requestId":"dac2a872-b9b7-460c-992d-0a0c14ea36e9",
    "data":[
        {
            "recoverTime":1560382560000,
            "recoverLocalTime":"2019-06-13 07:36:00",
            "recoverReason":"rule-recover",
            "eventId":"20190612cf89cd96b0be4cafcc342d0dc2ac75a4",
            "orgId":"yourOrgId",
            "assetId":"rQN8IRs4",
            "modelId":"lemo2",
            "modelIdPath":"/lemo2",
            "measurepointId":"lemo_point1_raw",
            "value":"99.06250421",
            "occurTime":1560382380000,
            "localOccurTime":"2019-06-13 07:33:00",
            "createTime":1560382559735,
            "updateTime":1560744923855,
            "severityId":"Urgent",
      "deviceStatus":null,
      "subTypeId":null,
      "subTypeDesc":null,
      "ruleDesc":null,
      "assetPath":null,
      "maskedBy":null,
            "severityDesc":{
                "i18nValue":{
                    "en_US":"紧急告警",
                    "zh_CN":"紧急告警"
                }
            },
            "typeId":"yourTypeId",
            "typeDesc":{
                "i18nValue":{
                    "en_US":"yourAlertType",
                    "zh_CN":"yourAlertTypeInChinese"
                }
            },
            "contentId":"001",
            "contentDesc":{
                "i18nValue":{
                    "en_US":"yourAlertContent",
                    "zh_CN":"yourAlertContentInChinese"
                }
            },
            "eventType":0,
            "tag":{
                "yourTag1":"yourValue1",
                "yourTag2":"yourValue2"
            }
        }
    ]
}

Java SDK Sample¶

public void testSearchHistoryAlerts(){
    String accessKey = "yourAppAccessKey";
    String secretKey = "yourAppSecretKey";
    SearchHistoryAlertRequest request = new SearchHistoryAlertRequest();
    request.setOrgId("yourOrgId");
    request.setStartOccurTime("2019-05-20T00:00:00Z");
    request.setEndOccurTime("2019-06-15T00:00:00Z");
    Pagination pagination = new Pagination();
    pagination.setPageSize(2);
        pagination.setPageNo(1);
        request.setPagination(pagination);
        request.setExpression("eventId='yourEventId'");
        try {
            SearchHistoryAlertResponse response = Poseidon.config(PConfig.init().appKey(accessKey).appSecret(secretKey).debug())
                    .url("https://{apigw-address}")
                    .getResponse(request, SearchHistoryAlertResponse.class);
            Gson gson = new Gson();
            System.out.println(gson.toJson(response));
        }catch(Exception e){
            System.out.print(e);
        }
}