Search Active Alerts¶

查询当前告警。

请求格式¶

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

请求参数（URI）¶

名称	位置（Path/Query）	是否必须	数据类型	描述
orgId	Query	true	String	资产所属的组织ID。如何获取orgId信息>>

请求参数（Body）¶

名称	是否必须	数据类型	描述
modelId	false	String	资产所属模型ID。如何获取modelId信息>>
assetId	false	String	资产ID。如何获取Asset ID信息>>
measurepointsId	false	String	资产测点ID。如何获取测点（pointId）信息>>
startOccurTime	false	String	查询起始时间，与 `endOccurTime` 配合使用，表示查询该时段内被触发的告警。见 API在使用的时间参数>>
endOccurTime	false	String	查询结束时间，与 `startOccurTime` 配合使用，表示查询该时段内被触发的告警。见 API在使用的时间参数>>
expression	false	String	查询表达式，支持类sql的查询。目前支持查询的字段是 `modelId`、`assetId`、`measurepointId`、`hitRuleId`、`severityId`、`typeId`、`subTypeId`、`contentId`、`eventType`、`eventId`、 `tag` 。支持的算术运算符为=和in，逻辑运算符是and和or。其中 `tag` 支持等于比如 `tag.FLAG = '1'` 和不等于比如 `(!tag.FLAG ='1')`。如何使用查询表达式>>
scope	false	Scope结构体	查询指定资产树或资产树上某资产节点下的告警，并指定是否返回被屏蔽的衍生告警。该参数不可与rootAlert参数同时使用。见 Scope结构体。
rootAlert	false	RootAlert结构体	查询被指定根源告警屏蔽的衍生告警。该参数不可与scope参数同时使用。见 RootAlert结构体。
pagination	false	Pagination请求结构体	随机分页。默认按照 `occurTime` 倒序排列。如未指定，默认分页大小为10。见 Pagination请求结构体>>

Scope结构体 ¶

名称	是否必须	数据类型	描述
treeId	true	String	资产树ID
fromAssetId	false	String	资产ID。可选。当未指定时，返回 `treeId` 指定的资产树内所有节点的告警；当指定时，返回该资产节点下（包含该节点）的所有告警
includeDerivative	false	Boolean	是否返回衍生告警，默认为false，不返回衍生告警

RootAlert结构体 ¶

名称	是否必须	数据类型	描述
treeId	false	String	资产树ID
rootAlertId	true	String	根源告警ID

响应参数¶

名称	数据类型	描述
data	ActiveAlert结构体	当前告警列表。详见 ActiveAlert结构体。

ActiveAlert结构体¶

名称	数据类型	描述
eventId	String	告警ID
orgId	String	资产所属的组织ID
assetId	String	资产ID
modelId	String	资产所属模型ID
modelIdPath	String	模型所属路径
measurepointId	String	资产测点
hitRuleId	String	触发的告警规则的编号
value	Integer/Double/Object	测点值。若告警规则中指定了 `triggeringDelayTimer`，则测点值为 `triggeringDelayTimer` 开始计时时测点的值。参照 ThingModel结构体>>
occurTime	Long	告警发生的时间，以UTC时间表示
localOccurTime	String	告警发生的时间，以本地时间表示
createTime	Long	该告警记录的入库时间，以UTC时间表示
updateTime	Long	该告警记录的更新时间，以UTC时间表示
severityId	String	告警级别标识符
severityDesc	StringI18n	告警级别描述
typeId	String	告警类别标识符
typeDesc	StringI18n	告警类型的具体描述
subTypeId	String	告警子类型
subTypeDesc	StringI18n	告警子类型描述
contentId	String	告警内容标识符
contentDesc	StringI18n	告警内容描述
eventType	Integer	事件类型:0：系统恢复的告警；1：系统触发的告警；2：通过API恢复的告警；3：通过API插入的告警
tag	Tag结构体	告警标签
ruleDesc	StringI18n	规则描述
assetPaths	String Array	根据告警规则的作用域，返回告警资产在资产树上的路径列表。返回格式为：[“treeId1:/assetId1/assetId2/assetIdx”, “treeId2:/assetId3/assetIdx”]
maskedBy	String Array	如果该告警条目是衍生告警，返回导致该告警被屏蔽的根源告警信息。返回格式为：[“treeId1:eventId1”, “treeId1:eventId2”]

输入输出示例¶

请求示例¶

POST http://{apigw-address}/event-service/v2.1/active-alerts?action=search&orgId=1c499110e8800000
{
    "expression": "eventId='20190531b83331a8549e1e956f2413552eda1ec9'",
    "pagination": {
        "pageNo": 1,
        "pageSize": 20
                  }
}

返回示例¶

{
    "pagination": {
        "pageNo": 1,
        "pageSize": 20,
        "totalSize": 1,
        "sortedBy": `{
            "field": "occurTime",
            "order": "DESC"
                     },
            {
            "field": "eventId",
            "order": "DESC"
            }]
                  },
    "code": 0,
    "msg": "OK",
    "requestId": "a9689b9f-0cb6-4e47-a41c-bd459b687309",
    "data": `{
        "eventId": "20190531b83331a8549e1e956f2413552eda1ec9",
        "orgId": "yourOrgId",
        "assetId": "qu5TmJRj",
        "modelId": "Inverter_Model",
        "modelIdPath": "/Inverter_Model",
        "measurepointId": "power",
        "value": "3.5559796405967736",
        "occurTime": 1559304899404,
        "localOccurTime": "2019-06-01 02:14:59",
        "createTime": 1559304899519,
        "updateTime": 1560745022684,
        "severityId": "alert_001",
        "severityDesc": {
            "i18nValue": {
                "en_US": "警告",
                "zh_CN": "警告"
                         }
                        },
        "typeId": "errorType",
        "typeDesc": {
            "i18nValue": {
                "en_US": "errorType desc",
                "zh_CN": ""
                         }
                    },
        "contentId": "001",
        "contentDesc": {
            "i18nValue": {
                "en_US": "001",
                "zh_CN": "001"
                         }
                       },
        "eventType": 1,
        "tag": {
            "Tag999": "999"
               }
            }]
}

Java SDK调用示例¶

public void testSearchActiveAlerts(){
        String accessKey = "4ced4f38-1ced-476e0a446215-a602-4307";
        String secretKey = "0a446215-a602-4307-9ff2-3feed3e983ce";
        SearchActiveAlertRequest request = new SearchActiveAlertRequest();
        request.setOrgId("1c499110e8800000");
        request.setExpression("eventId='20190531b83331a8549e1e956f2413552eda1ec9'");
        Pagination pagination = new Pagination();
        pagination.setPageSize(20);
        pagination.setPageNo(1);
            request.setPagination(pagination);
            request.headerParams().put("apim-accesskey","4ced4f38-1ced-476e0a446215-a602-4307");
            try {
                SearchActiveAlertResponse response = Poseidon.config(PConfig.init().appKey(accessKey).appSecret(secretKey).debug())
                        .url("http://{apigw-address}")
                        .getResponse(request, SearchActiveAlertResponse.class);
                Gson gson = new Gson();
                System.out.println(gson.toJson(response));
            }catch(Exception e){
                System.out.print(e);
            }
}