云监控
云监控
云监控
文档指南
请输入
产品动态
历史功能发布记录
云产品指标变更公告
用户指南
云产品监控
告警中心
通知
可视化开发
最佳实践
API 参考
告警联系组
告警联系人
查询云产品监控指标或事件
屏蔽策略
告警模板
通知模板
- 文档首页
云监控SDK 参考Java 使用示例
复制全文
下载 pdfJava 使用示例
文档反馈
问问助手本文为您介绍云监控 Java SDK 的下载地址、安装方式以及代码示例，帮助您快速了解如何使用 SDK 调用 OpenAPI。
前提条件
- 已获取账号的 Access Key。具体步骤，请参见 获取Access Key。
- 已安装 Java JDK 1.7 或以上版本。您可以下载最新版本 http://developers.sun.com/downloads/。
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-cloudmonitor</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.cloudmonitor.CloudmonitorApi;
import com.volcengine.cloudmonitor.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);
CloudmonitorApi api = new CloudmonitorApi(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());
}
}
}
最近更新时间：2025.12.04 16:05:37
这个页面对您有帮助吗？
有用
有用
无用
无用