介绍

主要功能 操作系统 cpu 内存 jvm 系统 数据查询 等，该模块核心是集成oshi实现对服务器及应用的监控。

第三方组件 oshi 是基于 JNA 的（本地）操作系统和硬件信息库。它不需要安装任何其他额外的本地库，旨在提供一种跨平台的实现来检索系统信息，例如操作系统版本、进程、内存和 CPU 使用率、磁盘和分区、设备、传感器等。

安装

• Maven

<dependency>
  <groupId>com.aizuda</groupId>
  <artifactId>aizuda-monitor</artifactId>
  <version>1.0.0</version>
</dependency>

• Gradle

implementation 'com.aizuda:aizuda-monitor:1.0.0'

演示效果

SpringBoot使用

案例代码

@RequestMapping("/v1/monitor")
public class MonitorController {
    // 注入监控模块 Oshi 调用类
    @Resource
    private OshiMonitor oshiMonitor;

    @PostMapping("/server")
    public Map<String, Object> monitor() {
        Map<String, Object> server = new HashMap<>(5);
        // 系统信息
        server.put("sysInfo", oshiMonitor.getSysInfo());
        // CPU 信息
        server.put("cupInfo", oshiMonitor.getCpuInfo());
        // 内存信息
        server.put("memoryInfo", oshiMonitor.getMemoryInfo());
        // Jvm 虚拟机信息
        server.put("jvmInfo", oshiMonitor.getJvmInfo());
        // 磁盘信息
        List<DiskInfo> diskInfos = oshiMonitor.getDiskInfos();
        server.put("diskInfos", diskInfos);
        if (CollectionUtils.isNotEmpty(diskInfos)) {
            long usableSpace = 0;
            long totalSpace = 0;
            for (DiskInfo diskInfo : diskInfos) {
                usableSpace += diskInfo.getUsableSpace();
                totalSpace += diskInfo.getTotalSpace();
            }
            double usedSize = (totalSpace - usableSpace);
            // 统计所有磁盘的使用率
            server.put("diskUsePercent", oshiMonitor.formatDouble(usedSize / totalSpace * 100));
        }

        // 系统前 10 个进程
        List<OSProcess> processList = oshiMonitor.getOperatingSystem().getProcesses(null,
                OperatingSystem.ProcessSorting.CPU_DESC, 10);
        List<Map<String, Object>> processMapList = new ArrayList<>();
        for (OSProcess process : processList) {
            Map<String, Object> processMap = new HashMap<>(5);
            processMap.put("name", process.getName());
            processMap.put("pid", process.getProcessID());
            processMap.put("cpu", oshiMonitor.formatDouble(process.getProcessCpuLoadCumulative()));
            processMapList.add(processMap);
        }
        server.put("processList", processMapList);
        return server;
    }
}

属性说明

操作系统信息 SysInfo

属性	说明
name	系统名称
ip	系统 ip
osName	操作系统
userDir	项目路径

CPU信息 CpuInfo

属性	说明
physicalProcessorCount	物理处理器数量
logicalProcessorCount	逻辑处理器数量
systemPercent	系统使用率
userPercent	用户使用率
waitPercent	当前等待率
usePercent	当前使用率

磁盘信息 DiskInfo

属性	说明
name	磁盘名称
volume	文件系统的卷名
label	标签
logicalVolume	文件系统的逻辑卷名
mount	文件系统的挂载点
description	文件系统的描述
options	文件系统的选项
type	文件系统的类型（FAT、NTFS、etx2、ext4等）
UUID	UUID/GUID
size	分区大小（字符串类型，例如 1GB）
totalSpace	分区大小（Long类型原始值）
used	已使用（Long类型原始值）
usableSpace	已使用（Long类型原始值）
avail	已使用（字符串类型，例如 1GB）
usePercent	已使用百分比

JVM虚拟机信息 JvmInfo

属性	说明
jdkVersion	jdk版本
jdkHome	jdk安装目录
jdkName	jdk名称
jvmTotalMemory	总内存
maxMemory	Java虚拟机将尝试使用的最大内存量
freeMemory	空闲内存
usedMemory	已使用内存
usePercent	内存使用率
startTime	返回Java虚拟机的启动时间（毫秒）。此属性返回Java虚拟机启动的大致时间。
size	分区大小（字符串类型，例如 1GB）
uptime	返回Java虚拟机的正常运行时间（毫秒）

系统内存信息 MemoryInfo

属性	说明
total	总计内存
used	已使用内存
free	未使用内存
usePercent	使用率

网络带宽信息 NetIoInfo

属性	说明
rxpck	每秒钟接收的数据包,rxpck/s
txpck	每秒钟发送的数据包,txpck/s
rxbyt	每秒钟接收的KB数,rxkB/s
txbyt	每秒钟发送的KB数,txkB/s