OSHI介紹
OSHI是一個基于JNA的免費的本地作業系統和Java的硬體資訊庫。它不需要安裝任何額外的本機庫，旨在提供跨平台的實作來檢索系統資訊，如作業系統版本、程序、記憶體和CPU使用情況、磁盤和分區、裝置、傳感器等。
支援的功能
- 計算機系統和固件，底闆
- 作業系統和版本/内部版本
- 實體（核心）和邏輯（超線程）CPU，處理器組，NUMA節點
- 系統和每個處理器的負載，使用情況滴答計數器，中斷，正常運作時間
- 程序正常運作時間，CPU，記憶體使用情況，使用者/組，指令行參數，線程詳細資訊
- 已使用/可用的實體和虛拟記憶體
- 挂載的檔案系統（類型，可用空間和總空間，選項，讀取和寫入）
- 磁盤驅動器（型号，序列号，大小，讀取和寫入）和分區
- 網絡接口（IP，帶寬輸入/輸出），網絡參數，TCP / UDP統計資訊
- 電池狀态（電量百分比，剩餘時間，電量使用情況統計資訊）
- USB裝置
- 連接配接的顯示器（帶有EDID資訊），圖形和聲霸卡
- 某些硬體上的傳感器（溫度，風扇速度，電壓）
使用說明
第一步：SpringBoot項目添加依賴：
<!-- 擷取系統資訊 -->
<dependency>
<groupId>com.github.oshi</groupId>
<artifactId>oshi-core</artifactId>
<version>3.9.1</version>
</dependency>
建立CPU，虛拟機，記憶體，系統，系統檔案等系統基礎類：
CPU：package com.company.api.server;
import com.company.util.Arith;
/**
* CPU相關資訊
* @author zengxueqi
* @since 2020/07/14
*/
public class Cpu {
/**
* 核心數
*/
private int cpuNum;
/**
* CPU總的使用率
*/
private double total;
/**
* CPU系統使用率
*/
private double sys;
/**
* CPU使用者使用率
*/
private double used;
/**
* CPU目前等待率
*/
private double wait;
/**
* CPU目前空閑率
*/
private double free;
public int getCpuNum() {
return cpuNum;
}
public void setCpuNum(int cpuNum) {
this.cpuNum = cpuNum;
}
public double getTotal() {
return Arith.round(Arith.mul(total, 100), 2);
}
public void setTotal(double total) {
this.total = total;
}
public double getSys() {
return Arith.round(Arith.mul(sys / total, 100), 2);
}
public void setSys(double sys) {
this.sys = sys;
}
public double getUsed() {
return Arith.round(Arith.mul(used / total, 100), 2);
}
public void setUsed(double used) {
this.used = used;
}
public double getWait() {
return Arith.round(Arith.mul(wait / total, 100), 2);
}
public void setWait(double wait) {
this.wait = wait;
}
public double getFree() {
return Arith.round(Arith.mul(free / total, 100), 2);
}
public void setFree(double free) {
this.free = free;
}
}
package com.company.api.server;
import com.company.util.Arith;
import com.company.util.util.DateUtils;
import java.lang.management.ManagementFactory;
/**
* JVM相關資訊
* @author zengxueqi
* @since 2020/07/14
*/
public class Jvm {
/**
* 目前JVM占用的記憶體總數(M)
*/
private double total;
/**
* JVM最大可用記憶體總數(M)
*/
private double max;
/**
* JVM空閑記憶體(M)
*/
private double free;
/**
* JDK版本
*/
private String version;
/**
* JDK路徑
*/
private String home;
public double getTotal() {
return Arith.div(total, (1024 * 1024), 2);
}
public void setTotal(double total) {
this.total = total;
}
public double getMax() {
return Arith.div(max, (1024 * 1024), 2);
}
public void setMax(double max) {
this.max = max;
}
public double getFree() {
return Arith.div(free, (1024 * 1024), 2);
}
public void setFree(double free) {
this.free = free;
}
public double getUsed() {
return Arith.div(total - free, (1024 * 1024), 2);
}
public double getUsage() {
return Arith.mul(Arith.div(total - free, total, 4), 100);
}
/**
* 擷取JDK名稱
*/
public String getName() {
return ManagementFactory.getRuntimeMXBean().getVmName();
}
public String getVersion() {
return version;
}
public void setVersion(String version) {
this.version = version;
}
public String getHome() {
return home;
}
public void setHome(String home) {
this.home = home;
}
/**
* JDK啟動時間
*/
public String getStartTime() {
return DateUtils.parseDateToStr(DateUtils.YYYY_MM_DD_HH_MM_SS, DateUtils.getServerStartDate());
}
/**
* JDK運作時間
*/
public String getRunTime() {
return DateUtils.getDatePoor(DateUtils.getNowDate(), DateUtils.getServerStartDate());
}
}
package com.company.api.server;
import com.company.util.Arith;
/**
* 內存相關資訊
* @author zengxueqi
* @since 2020/07/14
*/
public class Mem {
/**
* 記憶體總量
*/
private double total;
/**
* 已用記憶體
*/
private double used;
/**
* 剩餘記憶體
*/
private double free;
public double getTotal() {
return Arith.div(total, (1024 * 1024 * 1024), 2);
}
public void setTotal(long total) {
this.total = total;
}
public double getUsed() {
return Arith.div(used, (1024 * 1024 * 1024), 2);
}
public void setUsed(long used) {
this.used = used;
}
public double getFree() {
return Arith.div(free, (1024 * 1024 * 1024), 2);
}
public void setFree(long free) {
this.free = free;
}
public double getUsage() {
return Arith.mul(Arith.div(used, total, 4), 100);
}
}
package com.company.api.server;
/**
* 系統相關資訊
* @author zengxueqi
* @since 2020/07/14
*/
public class Sys {
/**
* 伺服器名稱
*/
private String computerName;
/**
* 伺服器Ip
*/
private String computerIp;
/**
* 項目路徑
*/
private String userDir;
/**
* 作業系統
*/
private String osName;
/**
* 系統架構
*/
private String osArch;
public String getComputerName() {
return computerName;
}
public void setComputerName(String computerName) {
this.computerName = computerName;
}
public String getComputerIp() {
return computerIp;
}
public void setComputerIp(String computerIp) {
this.computerIp = computerIp;
}
public String getUserDir() {
return userDir;
}
public void setUserDir(String userDir) {
this.userDir = userDir;
}
public String getOsName() {
return osName;
}
public void setOsName(String osName) {
this.osName = osName;
}
public String getOsArch() {
return osArch;
}
public void setOsArch(String osArch) {
this.osArch = osArch;
}
}
package com.company.api.server;
/**
* 系統檔案相關資訊
* @author zengxueqi
* @since 2020/07/14
*/
public class SysFile {
/**
* 盤符路徑
*/
private String dirName;
/**
* 盤符類型
*/
private String sysTypeName;
/**
* 檔案類型
*/
private String typeName;
/**
* 總大小
*/
private String total;
/**
* 剩餘大小
*/
private String free;
/**
* 已經使用量
*/
private String used;
/**
* 資源的使用率
*/
private double usage;
public String getDirName() {
return dirName;
}
public void setDirName(String dirName) {
this.dirName = dirName;
}
public String getSysTypeName() {
return sysTypeName;
}
public void setSysTypeName(String sysTypeName) {
this.sysTypeName = sysTypeName;
}
public String getTypeName() {
return typeName;
}
public void setTypeName(String typeName) {
this.typeName = typeName;
}
public String getTotal() {
return total;
}
public void setTotal(String total) {
this.total = total;
}
public String getFree() {
return free;
}
public void setFree(String free) {
this.free = free;
}
public String getUsed() {
return used;
}
public void setUsed(String used) {
this.used = used;
}
public double getUsage() {
return usage;
}
public void setUsage(double usage) {
this.usage = usage;
}
}
封裝伺服器監控系統：
package com.company.api.server;
import com.company.util.Arith;
import com.company.util.util.IpUtils;
import oshi.SystemInfo;
import oshi.hardware.CentralProcessor;
import oshi.hardware.CentralProcessor.TickType;
import oshi.hardware.GlobalMemory;
import oshi.hardware.HardwareAbstractionLayer;
import oshi.software.os.FileSystem;
import oshi.software.os.OSFileStore;
import oshi.software.os.OperatingSystem;
import oshi.util.Util;
import java.net.UnknownHostException;
import java.util.LinkedList;
import java.util.List;
import java.util.Properties;
/**
* 伺服器相關資訊
* @author zengxueqi
* @since 2020/07/14
*/
public class Server {
private static final int OSHI_WAIT_SECOND = 1000;
/**
* CPU相關資訊
*/
private Cpu cpu = new Cpu();
/**
* 內存相關資訊
*/
private Mem mem = new Mem();
/**
* JVM相關資訊
*/
private Jvm jvm = new Jvm();
/**
* 伺服器相關資訊
*/
private Sys sys = new Sys();
/**
* 磁盤相關資訊
*/
private List<SysFile> sysFiles = new LinkedList<SysFile>();
public Cpu getCpu() {
return cpu;
}
public void setCpu(Cpu cpu) {
this.cpu = cpu;
}
public Mem getMem() {
return mem;
}
public void setMem(Mem mem) {
this.mem = mem;
}
public Jvm getJvm() {
return jvm;
}
public void setJvm(Jvm jvm) {
this.jvm = jvm;
}
public Sys getSys() {
return sys;
}
public void setSys(Sys sys) {
this.sys = sys;
}
public List<SysFile> getSysFiles() {
return sysFiles;
}
public void setSysFiles(List<SysFile> sysFiles) {
this.sysFiles = sysFiles;
}
public void copyTo() throws Exception {
SystemInfo si = new SystemInfo();
HardwareAbstractionLayer hal = si.getHardware();
setCpuInfo(hal.getProcessor());
setMemInfo(hal.getMemory());
setSysInfo();
setJvmInfo();
setSysFiles(si.getOperatingSystem());
}
/**
* 設定CPU資訊
*/
private void setCpuInfo(CentralProcessor processor) {
// CPU資訊
long[] prevTicks = processor.getSystemCpuLoadTicks();
Util.sleep(OSHI_WAIT_SECOND);
long[] ticks = processor.getSystemCpuLoadTicks();
long nice = ticks[TickType.NICE.getIndex()] - prevTicks[TickType.NICE.getIndex()];
long irq = ticks[TickType.IRQ.getIndex()] - prevTicks[TickType.IRQ.getIndex()];
long softirq = ticks[TickType.SOFTIRQ.getIndex()] - prevTicks[TickType.SOFTIRQ.getIndex()];
long steal = ticks[TickType.STEAL.getIndex()] - prevTicks[TickType.STEAL.getIndex()];
long cSys = ticks[TickType.SYSTEM.getIndex()] - prevTicks[TickType.SYSTEM.getIndex()];
long user = ticks[TickType.USER.getIndex()] - prevTicks[TickType.USER.getIndex()];
long iowait = ticks[TickType.IOWAIT.getIndex()] - prevTicks[TickType.IOWAIT.getIndex()];
long idle = ticks[TickType.IDLE.getIndex()] - prevTicks[TickType.IDLE.getIndex()];
long totalCpu = user + nice + cSys + idle + iowait + irq + softirq + steal;
cpu.setCpuNum(processor.getLogicalProcessorCount());
cpu.setTotal(totalCpu);
cpu.setSys(cSys);
cpu.setUsed(user);
cpu.setWait(iowait);
cpu.setFree(idle);
}
/**
* 設定記憶體資訊
*/
private void setMemInfo(GlobalMemory memory) {
mem.setTotal(memory.getTotal());
mem.setUsed(memory.getTotal() - memory.getAvailable());
mem.setFree(memory.getAvailable());
}
/**
* 設定伺服器資訊
*/
private void setSysInfo() {
Properties props = System.getProperties();
sys.setComputerName(IpUtils.getHostName());
sys.setComputerIp(IpUtils.getHostIp());
sys.setOsName(props.getProperty("os.name"));
sys.setOsArch(props.getProperty("os.arch"));
sys.setUserDir(props.getProperty("user.dir"));
}
/**
* 設定Java虛拟機
*/
private void setJvmInfo() throws UnknownHostException {
Properties props = System.getProperties();
jvm.setTotal(Runtime.getRuntime().totalMemory());
jvm.setMax(Runtime.getRuntime().maxMemory());
jvm.setFree(Runtime.getRuntime().freeMemory());
jvm.setVersion(props.getProperty("java.version"));
jvm.setHome(props.getProperty("java.home"));
}
/**
* 設定磁盤資訊
*/
private void setSysFiles(OperatingSystem os) {
FileSystem fileSystem = os.getFileSystem();
OSFileStore[] fsArray = fileSystem.getFileStores();
for (OSFileStore fs : fsArray) {
long free = fs.getUsableSpace();
long total = fs.getTotalSpace();
long used = total - free;
SysFile sysFile = new SysFile();
sysFile.setDirName(fs.getMount());
sysFile.setSysTypeName(fs.getType());
sysFile.setTypeName(fs.getName());
sysFile.setTotal(convertFileSize(total));
sysFile.setFree(convertFileSize(free));
sysFile.setUsed(convertFileSize(used));
sysFile.setUsage(Arith.mul(Arith.div(used, total, 4), 100));
sysFiles.add(sysFile);
}
}
/**
* 位元組轉換
* @param size 位元組大小
* @return 轉換後值
*/
public String convertFileSize(long size) {
long kb = 1024;
long mb = kb * 1024;
long gb = mb * 1024;
if (size >= gb) {
return String.format("%.1f GB", (float) size / gb);
} else if (size >= mb) {
float f = (float) size / mb;
return String.format(f > 100 ? "%.0f MB" : "%.1f MB", f);
} else if (size >= kb) {
float f = (float) size / kb;
return String.format(f > 100 ? "%.0f KB" : "%.1f KB", f);
} else {
return String.format("%d B", size);
}
}
}
建立浮點數運算工具類：
package com.company.util;
import java.math.BigDecimal;
import java.math.RoundingMode;
/**
* 精确的浮點數運算
* @author zengxueqi
* @since 2020/07/14
*/
public class Arith {
/**
* 預設除法運算精度
*/
private static final int DEF_DIV_SCALE = 10;
/**
* 這個類不能執行個體化
*/
private Arith() {
}
/**
* 提供精确的加法運算。
* @param v1 被加數
* @param v2 加數
* @return 兩個參數的和
*/
public static double add(double v1, double v2) {
BigDecimal b1 = new BigDecimal(Double.toString(v1));
BigDecimal b2 = new BigDecimal(Double.toString(v2));
return b1.add(b2).doubleValue();
}
/**
* 提供精确的減法運算。
* @param v1 被減數
* @param v2 減數
* @return 兩個參數的差
*/
public static double sub(double v1, double v2) {
BigDecimal b1 = new BigDecimal(Double.toString(v1));
BigDecimal b2 = new BigDecimal(Double.toString(v2));
return b1.subtract(b2).doubleValue();
}
/**
* 提供精确的乘法運算。
* @param v1 被乘數
* @param v2 乘數
* @return 兩個參數的積
*/
public static double mul(double v1, double v2) {
BigDecimal b1 = new BigDecimal(Double.toString(v1));
BigDecimal b2 = new BigDecimal(Double.toString(v2));
return b1.multiply(b2).doubleValue();
}
/**
* 提供（相對）精确的除法運算，當發生除不盡的情況時，精确到
* 小數點以後10位，以後的數字四舍五入。
* @param v1 被除數
* @param v2 除數
* @return 兩個參數的商
*/
public static double div(double v1, double v2) {
return div(v1, v2, DEF_DIV_SCALE);
}
/**
* 提供（相對）精确的除法運算。當發生除不盡的情況時，由scale參數指
* 定精度，以後的數字四舍五入。
* @param v1 被除數
* @param v2 除數
* @param scale 表示表示需要精确到小數點以後幾位。
* @return 兩個參數的商
*/
public static double div(double v1, double v2, int scale) {
if (scale < 0) {
throw new IllegalArgumentException(
"The scale must be a positive integer or zero");
}
BigDecimal b1 = new BigDecimal(Double.toString(v1));
BigDecimal b2 = new BigDecimal(Double.toString(v2));
if (b1.compareTo(BigDecimal.ZERO) == 0) {
return BigDecimal.ZERO.doubleValue();
}
return b1.divide(b2, scale, RoundingMode.HALF_UP).doubleValue();
}
/**
* 提供精确的小數位四舍五入處理。
* @param v 需要四舍五入的數字
* @param scale 小數點後保留幾位
* @return 四舍五入後的結果
*/
public static double round(double v, int scale) {
if (scale < 0) {
throw new IllegalArgumentException(
"The scale must be a positive integer or zero");
}
BigDecimal b = new BigDecimal(Double.toString(v));
BigDecimal one = new BigDecimal("1");
return b.divide(one, scale, RoundingMode.HALF_UP).doubleValue();
}
}
建立api接口：
package com.company.mission.controller;
import com.company.api.base.ResultT;
import com.company.api.server.Server;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
/**
* 伺服器監控
* @author zengxueqi
* @since 2020/07/14
*/
@RestController
@RequestMapping("/monitor")
public class ServerController {
/**
* 擷取伺服器監控資訊
* @param
* @return com.company.api.base.ResultT<com.company.api.server.Server>
* @author zengxueqi
* @since 2020/7/14
*/
@PostMapping("/server")
public ResultT<Server> getInfo() throws Exception {
Server server = new Server();
server.copyTo();
return ResultT.ok(server);
}
}
啟動SpringBoot服務，通路API位址：
API位址(根據自己的項目來)：http://127.0.0.1:9004/mission/monitor/server
API接口響應資料如下：
{
"code": 0,
"msg": "業務處理成功",
"content": {
"cpu": {
"cpuNum": 8,
"total": 80300.0,
"sys": 4.61,
"used": 13.45,
"wait": 0.0,
"free": 81.94
},
"mem": {
"total": 8.0,
"used": 6.22,
"free": 1.78,
"usage": 77.71
},
"jvm": {
"total": 656.0,
"max": 1820.5,
"free": 161.44,
"version": "1.8.0_191",
"home": "/Library/Java/JavaVirtualMachines/jdk1.8.0_191.jdk/Contents/Home/jre",
"name": "Java HotSpot(TM) 64-Bit Server VM",
"startTime": "2020-07-14 10:30:46",
"usage": 75.39,
"used": 494.56,
"runTime": "0天1小時5分鐘"
},
"sys": {
"computerName": "zengxueqis-MacBook-Air.local",
"computerIp": "127.0.0.1",
"userDir": "/Users/zengxueqi/IdeaProjects/mission",
"osName": "Mac OS X",
"osArch": "x86_64"
},
"sysFiles": [
{
"dirName": "/",
"sysTypeName": "apfs",
"typeName": "mac os",
"total": "79.4 GB",
"free": "24.0 GB",
"used": "55.4 GB",
"usage": 69.8
},
{
"dirName": "/System/Volumes/Data",
"sysTypeName": "apfs",
"typeName": "mac os - 資料",
"total": "79.4 GB",
"free": "24.0 GB",
"used": "55.4 GB",
"usage": 69.8
},
{
"dirName": "/private/var/vm",
"sysTypeName": "apfs",
"typeName": "VM",
"total": "79.4 GB",
"free": "24.0 GB",
"used": "55.4 GB",
"usage": 69.8
},
{
"dirName": "/Volumes/Untitled",
"sysTypeName": "ntfs",
"typeName": "Untitled",
"total": "38.3 GB",
"free": "17.2 GB",
"used": "21.0 GB",
"usage": 54.94
},
{
"dirName": "/Volumes/Untitled 1",
"sysTypeName": "ntfs",
"typeName": "Untitled 1",
"total": "38.7 GB",
"free": "19.7 GB",
"used": "19.0 GB",
"usage": 48.97
},
{
"dirName": "/Volumes/軟體",
"sysTypeName": "ntfs",
"typeName": "軟體",
"total": "171.0 GB",
"free": "163.4 GB",
"used": "7.6 GB",
"usage": 4.46
},
{
"dirName": "/Volumes/other",
"sysTypeName": "apfs",
"typeName": "other",
"total": "170.1 GB",
"free": "164.6 GB",
"used": "5.5 GB",
"usage": 3.22
},
{
"dirName": "/Volumes/文檔",
"sysTypeName": "ntfs",
"typeName": "文檔",
"total": "170.0 GB",
"free": "166.9 GB",
"used": "3.1 GB",
"usage": 1.81
},
{
"dirName": "/Volumes/娛樂",
"sysTypeName": "ntfs",
"typeName": "娛樂",
"total": "170.0 GB",
"free": "159.8 GB",
"used": "10.2 GB",
"usage": 5.98
},
{
"dirName": "/Volumes/辦公",
"sysTypeName": "ntfs",
"typeName": "辦公",
"total": "170.0 GB",
"free": "168.9 GB",
"used": "1.1 GB",
"usage": 0.63
}
]
}
}
通過API接口傳回的資料可以看出，OSHI擷取到的伺服器資料還是非常的詳細的，OSHI可以跨平台檢視伺服器資訊，其中cpu負載資訊為目前占用CPU的時間。需要在一段時間内擷取兩次，然後相減得出這段時間内所占用的時間。這段時間除以總占用時間就是占用百分比。