自訂監控警示任務 -

如果您擁有自己的監控系統，且關心與特定業務相關的某些自有監控指標，系統監控警示任務無法滿足您的監控需求。您可以將自訂監控項指標上報到CloudMonitor，然後使用Auto Scaling自訂監控警示任務監控這些監控項。

上報監控資料到CloudMonitor

Auto Scaling自訂監控警示任務是監控自訂監控項的一項功能。在建立自訂監控警示任務之前，您需要提前向CloudMonitor上報自訂監控項。

CloudMonitor自訂監控是提供給您自由定義監控項及警示規則的一項功能。您可以針對自己關心的業務指標進行監控，將採集到監控資料上報至CloudMonitor，由CloudMonitor來進行資料的處理，並根據處理結果進行警示。

CloudMonitor支援使用OpenAPI、Java SDK和阿里雲命令列工具（CLI）三種方式上報監控資料。下面以使用Java SDK為例示範上報監控資料。

在專案中引入相應的jar包。

使用Maven管理專案時，在專案中加入依賴的樣本如下：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>3.2.6</version>
</dependency>
<dependency>
    <groupId>com.aliyun.openservices</groupId>
    <artifactId>aliyun-cms</artifactId>
    <version>0.2.4</version>
</dependency>

向CloudMonitor上報自訂監控項。

樣本如下：

static String endPoint     = "https://metrichub-cms-cn-hangzhou.aliyuncs.com";
CMSClient cmsClient = new CMSClient(endPoint, accAutoScalingKey, accAutoScalingSecret);
CustomMetricUploadRequest request = CustomMetricUploadRequest.builder()
                    .append(CustomMetric.builder()
                    .setMetricName("myCustomMetric")//自訂指標名
                    .setGroupId(54504L)//設定分組ID
                    .setTime(new Date())//時間
                    .setType(CustomMetric.TYPE_VALUE)//類型為原始值
                    .appendValue(MetricAttribute.VALUE, number)//原始值，key只能為這個
                    .appendDimension("key1", "value1")//添加維度
                    .appendDimension("key2", "value2")
                    .build())
                 .build();
            CustomMetricUploadResponse response = cmsClient.putCustomMetric(request);//上報

上述樣本上報了一個資料點到CloudMonitor。上報時必須指定groupId參數，即CloudMonitor應用分組ID，該分組ID可以是已在CloudMonitor中建立的應用分組，或者一個不存在的應用分組，系統會自動建立新的應用分組。

您可以前往CloudMonitor控制台，在應用分組中查看應用分組資訊，在自訂監控中查看上報的自訂監控項（即時間序列）。

建議您向一個CloudMonitor中已經存在的應用分組推送自訂監控資料，CloudMonitor應用分組是針對多種雲產品的邏輯分組，向一個已存在的應用分組推送自訂監控資料將使您在需要使用CloudMonitor等相關功能時保留擴充的能力。

CloudMonitor會自動彙總您上報到CloudMonitor的監控資料，如果您需要推送大量的資料，也可以選擇在本地彙總之後再推送到CloudMonitor。上報監控資料存在使用限制，更多說明和樣本，請參見概覽。