本文主要介紹云監控服務Java SDK接入指南。

一、前言

安裝使用JAVA SDK可以幫助開發者快速接入并使用天翼云的監控服務相關功能。

二、使用條件

2.1 先決條件

用戶需要具備以下條件才能夠使用LTS SDK Java版本：

1. 開通了天翼云的云監控服務。

2. 已獲取AccessKey 和 SecretKey。

3. 已安裝JDK1.8及以上環境。

2.2 下載及安裝

安裝jar包有如下兩種方式：

1、源碼編譯：下載 ctyun-monitor-java-sdk-1749785225503.zip 壓縮包，放到相應位置后并解壓，把包放在本地目錄：<base_path>。如果您想直接使用SDK，可以不做修改，直接使用SDK源碼，示例代碼為example/SamplePutlogs.java。

1. 把SDK源碼構建成jar包，可通過構建工具構建

2. 把生成的jar包引入本地maven倉庫。可以通過例如idea的maven工具install 到maven倉庫。或者通過命令構建安裝（在jar包所在目錄執行下面命令）。

// 構建 jar 命令（保證已經到 ctyun-monitor-java-sdk-1749785225503 工程根目錄）
mvn clean package -am -amd -Dmaven.test.skip=true -Dcheckstyle.skip=true
// 將生成的jar包引入本地maven倉庫
mvn install:install-file -Dfile=./target/ctyun-java-sdk-1.0.0-SNAPSHOT.jar -DgroupId=com.ctyun -DartifactId=ctyun-java-sdk -Dversion=1.0.0-SNAPSHOT -Dpackaging=jar

其中：

-Dfile 指定 jar 文件的路徑。

2、直接聯系天翼云客戶經理獲取jar包，拿到 jar 包后使用如下命令將 jar 包引入本地maven倉庫

// 將生成的jar包引入本地maven倉庫
mvn install:install-file -Dfile=xxx/ctyun-java-sdk-1.0.0-SNAPSHOT.jar -DgroupId=com.ctyun -DartifactId=ctyun-java-sdk -Dversion=1.0.0-SNAPSHOT -Dpackaging=jar

其中：

-Dfile 指定 jar 文件的路徑。

執行上述命令后，如果成功會出現如下提示：

2.3 編碼開發

1. 在您的maven工程的pom.xml文件中增加配置

   <dependencies>
   
       <!-- 引入 ctyun 依賴 -->
   	<dependency>
   		<groupId>com.ctyun</groupId>
   		<artifactId>ctyun-java-sdk</artifactId>
   		<version>1.0.0-SNAPSHOT</version>
   	</dependency>
   
   	<!-- OkHttp3 依賴 -->
   	<dependency>
   		<groupId>com.squareup.okhttp3</groupId>
   		<artifactId>okhttp</artifactId>
   		<version>4.9.0</version> <!-- 請檢查最新版本 -->
   	</dependency>
   
       <!-- 根據實際情況引入所需 jar 包 -->
   
   </dependencies>

2. 示例代碼：歷史監控數據：查詢v4.2。接口入參根據您的實際情況調整。

   public static void main(String args[]) throws CtyunRequestException {
           String accessKey = "your ak";
           String secretKey = "your sk";
           Endpoint endpoint = new Endpoint(Apis.ENDPOINT_NAME, "//monitor-global.ctapi.daliqc.cn");
   
           CtyunClient testClient = new CtyunClient(CtyunClient.clientConfigForProd());
           testClient.registerEndpoint(endpoint);
           Credential testCredential = new Credential(accessKey, secretKey);
   
           MonitorDescribeHistoryMetricDataVdbApi testApi = new MonitorDescribeHistoryMetricDataVdbApi(testClient);
           MonitorDescribeHistoryMetricDataVdbApi.DescribeHistoryMetricDataVdbRequest testRequest = new MonitorDescribeHistoryMetricDataVdbApi.DescribeHistoryMetricDataVdbRequest();
           testRequest.setRegionID("bb9fdb42056f11eda1610242ac110002");
           testRequest.setService("ecs");
           testRequest.setDimension("ecs");
           testRequest.setItemNameList(Collections.singletonList("cpu_util"));
           testRequest.setStartTime(1749760249);
           testRequest.setEndTime(1749803449);
           testRequest.setFun("avg");
           testRequest.setPeriod(300);
           MonitorDescribeHistoryMetricDataVdbApi.DescribeHistoryMetricDataVdbDimensionsRequest dimensionsRequest = new MonitorDescribeHistoryMetricDataVdbApi.DescribeHistoryMetricDataVdbDimensionsRequest();
           dimensionsRequest.setName("uuid");
           dimensionsRequest.setValue(Collections.singletonList("350b58e8-bc7f-b1ec-11b4-455c4f656a22"));
           testRequest.setDimensions(Collections.singletonList(dimensionsRequest));
           List<MonitorDescribeHistoryMetricDataVdbApi.DescribeHistoryMetricDataVdbDimensionsRequest> dimensions = Collections.singletonList(dimensionsRequest);
           MonitorDescribeHistoryMetricDataVdbApi.DescribeHistoryMetricDataVdbResponse testResponse = testApi.send(testCredential, testRequest);
           System.out.println("test: " + JacksonUtil.writeValueAsString(testResponse));
   
       }

   調用成功后，返回如下結果：