本文主要介绍云监控服务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, "https://monitor-global.ctapi.ctyun.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));
   
       }

   调用成功后，返回如下结果：