Java使用示例

本文为您介绍云监控Java SDK的下载地址、安装方式以及代码示例，帮助您快速了解如何使用SDK调用OpenAPI。

前提条件

• 已注册火山引擎账号并完成实名认证。具体步骤，请参见账号注册及实名认证。
• 已获取账号的Access Key。具体步骤，请参见获取Access Key。
• 已安装Java JDK 1.7或以上版本。您可以下载最新版本： http://developers.sun.com/downloads/。

SDK下载地址

Java SDK下载地址：volcengine-java-sdk。

安装SDK

步骤一：设置字节跳动Maven镜像仓库（可选）

• 当SDK版本大于或者等于0.1.28时，volcengine-java-sdk会在Maven中央仓库发布，您无需执行本步骤。

• 当SDK版本小于0.1.28时，volcengine-java-sdk并未在Maven中央仓库发布，而是在字节跳动对外的Maven仓库发布，因此您在使用前，请先在Maven的安装目录conf/settings.xml中，针对字节跳动的Maven仓库进行镜像设置，设置方法如下：

  # 请将如下设置加入到 <mirror>标签中
  
  <mirror>
       <id>bytedanceMaven</id>
       <mirrorOf>my-repo-id</mirrorOf>
       <name>字节跳动maven仓库</name>
       <url>https://artifact.bytedance.com/repository/releases/</url>
  </mirror>
  

  说明

  字节跳动的Maven仓库更新时间比Maven中央仓库提早几个小时，如果以后您需要使用大于或者等于0.1.28的SDK版本时，无需变更镜像仓库。

步骤二：配置Maven项目依赖

新建一个Maven项目，在项目目录下的pom.xml中，添加如下设置，引入服务依赖。引入依赖后，Maven项目管理工具会自动下载相关Jar包。

<dependencies>
    <dependency>
        <groupId>com.volcengine</groupId>
        <artifactId>volcengine-java-sdk-volcobserve</artifactId>
        <version>${project.version}</version>
    </dependency>
</dependencies>

代码示例

新建GetMetricData.java文件，添加如下代码，查询指定指标在指定时间选段内聚合的时序数据。

import com.volcengine.ApiClient;
import com.volcengine.ApiException;
import com.volcengine.sign.Credentials;
import com.volcengine.volcobserve.VolcObserveApi;
import com.volcengine.volcobserve.model.*;

import java.util.ArrayList;
import java.util.List;

public class GetMetricData {
    public static void main(String[] args)throws Exception {
        //设置您的ak
        String ak = "Your AK";
        //设置您的sk
        String sk = "Your SK";
        //设置您要访问的地域
        String region = "cn-beijing";
        //初始化apiclient
        ApiClient apiClient = new ApiClient()
                .setCredentials(Credentials.getCredentials(ak,sk))
                .setRegion(region);
        VolcObserveApi api = new VolcObserveApi(apiClient);
        //创建一个接口入参
        GetMetricDataRequest request = new GetMetricDataRequest();
        //设置接口入参
        request.setStartTime(1671783***);
        request.setEndTime(1671786***);
        request.setNamespace("***");
        request.setSubNamespace("***");
        request.setMetricName("****");
        request.setPeriod("**s");
        DimensionForGetMetricDataInput dimension = new DimensionForGetMetricDataInput();
        dimension.setName("ResourceID");
        dimension.setValue("eip-2d6hpp6bm0tts58o********");
        InstanceForGetMetricDataInput instance = new InstanceForGetMetricDataInput();
        List<DimensionForGetMetricDataInput> dimensionList = new ArrayList<>();
        dimensionList.add(dimension);
        instance.setDimensions(dimensionList);
        List<InstanceForGetMetricDataInput> instanceList = new ArrayList<>();
        instanceList.add(instance);
        request.setInstances(instanceList);

        try {
            //调用接口
            GetMetricDataResponse response = api.getMetricData(request);
            System.out.println(response);
        } catch (ApiException e) {
            System.out.println(e.getResponseBody());
        }
    }
}