設備數據上云，解析后的設備數據一般是時序存儲，但純粹的設備時序數據無法給用戶帶來更大的業務價值，需要根據業務需求進行額外的數據統計分析。本文將介紹如何利用ZWS云平臺的自定義統計算法對數據進行統計。

??應用場景

為什么需要自定義統計算法？由于業務需求各式各樣，有的需要求平均值，有的需要求累加值，不同維度需要不同統計算法，開發者可以通過自定義統計算法來滿足對應的項目需求。

??統計數據準備

首先，需要在ZWS云平臺中創建設備并上報設備數據：

??統計算法

ZWS云平臺的統計算法有兩種，分別是內置統計算法和自定義統計算法。

內置算法為云平臺定義好的算法，可以直接關聯設備進行統計，無需關心統計算法內容和過程。

自定義算法可以自己擬定數據統計的方式(例如取某段時間的最大最小值、總和等等)來統計設備數據。

??創建自定義統計算法

不同于內置算法，自定義算法從請求參數、統計過程、統計結果均由用戶自定義，需要開發者編寫腳本。目前自定義統計中支持了Groovy和JavaScript兩種腳本語言解析。

1. 請求參數

類別：云平臺提供給自定義算法的參數；

參數名：參數的別名。

在云平臺中，提供了6種參數給自定義算法的開發者使用：

devType：設備類型；

devId：創建設備定義的ID，可以用于選取一個設備進行統計；

dataSource：設備類型功能塊中的某一個字段；

dataCompareOperation：字段的比較條件，有大于、小于和等于；

dataValue：需要比較的數據值；

group：軟件分組，可以對一整個軟件分組進行統計。

2.算法代碼

統計數據的過程代碼，可以使用Groovy或者JavaScript語言編寫。

3.返回參數

定義統計后結果顯示的字段。

這里以統計一小時內設備的某個數據的總和為例，編寫一個JavaScript腳本：

// 載入需要實現的接口
var DataStatisticScriptMethod = Java.type("com.zlgcloud.iotplatform.iotdata.service.data.statistics.DataStatisticScriptMethod");
// 創建繼承實現接口的類
var JsDataStatisticScriptMethod = Java.extend(DataStatisticScriptMethod);


// 創建func對象
var func = new JsDataStatisticScriptMethod() {
    execute: function(param) {


        //獲取創建算法頁面的請求參數，參數值會由云平臺根據算法實例的選擇項，進行自動填充
        var thirdThingsId = param.get("devId");
        var infoModelId = param.get("devType");
        var property = param.get("property");


        //可以自定義統計時間范圍，如果查詢條件沒有range，則會根據算法實例的數據開始時間和數據結束時間范圍進行統計
        var currentTime = new Date().valueOf();
        var anHourAgo = currentTime - 3600000;


        // 拼裝elasticseach 查詢的dsl
        // 這里根據業務需要設置數據范圍. 查詢時會限制租戶和用戶管理的設備.
        var esParam = {
            "aggregations": {
                "result_in_hour": {
                    "sum": {
                        "field": "data." + property
                    }
                }
            },
            "query": {
                "bool":{
                    "must": [
                        {
                            "term": {
                                    "third_things_id.keyword": thirdThingsId
                            }
                        },
                        {
                           "range": {
                             "timestamp": {
                               "gte": anHourAgo,
                               "lt": currentTime
                             }
                           }
                        }
                    ]
                }
            }
        };
        //獲取統計結果
        var result = Java.super(func).queryEs(infoModelId, esParam);
        var rtn = {"result_in_hour":result['aggregations']['result_in_hour']['value']};
        return rtn;
    }
}

將腳本復制到自定義算法中。

同時創建實例，給設備的數據進行統計。

執行算法過后，可以看到自定義統計結果。

審核編輯：劉清