rrd4j

RRD4J 是一个高性能的时间序列数据记录和绘图系统，用 Java 实现了 RRDTool 的功能。它遵循了与 RRDTool 相似的逻辑，并使用相同的数据源、归档类型和定义。

RRD4J 支持对 Round Robin 数据库（RRD）文件的所有标准操作：CREATE、UPDATE、FETCH、LAST、DUMP、EXPORT 和 GRAPH。RRD4J 的 API 设计适合那些熟悉 RRDTool 概念和逻辑，但更喜欢使用纯 Java 工作的开发者（无需本地函数或库，无需 Runtime.exec()，不需要安装 RRDTool）。我们在这里为用户提供帮助。

构建（可选）

RRD4J 使用 Maven 构建。生成的网站可在这里查看。自动构建的版本上传到了 Sonatype 的仓库。

测试需要一个运行中的 MongoDB 实例才能成功。可以使用以下命令启动：

docker run --rm  -p 27017:27017 mongo:latest

在 Maven 中使用

在项目的 POM 文件中添加以下依赖：

<dependency>
    <groupId>org.rrd4j</groupId>
    <artifactId>rrd4j</artifactId>
    <version>3.9</version>
</dependency>

为什么选择 RRD4J？

文件可移植，RRDTool 文件不可移植
简单的 API
支持与 RRDTool 相同的数据源类型（COUNTER、ABSOLUTE、DERIVE、GAUGE）
支持与 RRDTool 相同的合并函数（AVERAGE、MIN、MAX、LAST），并增加了 TOTAL、FIRST
支持几乎所有 RRDTool RPN 函数（wiki/参见 RPNFuncs）
多种后端，例如可以使用 MongoDB 作为数据存储

使用示例

import java.awt.Color;

import org.rrd4j.core.*;
import org.rrd4j.graph.*;
import static org.rrd4j.ConsolFun.*;

String rrdPath = "my.rrd";

// 首先，定义RRD
RrdDef rrdDef = new RrdDef(rrdPath, 300);
rrdDef.addArchive(AVERAGE, 0.5, 1, 600); // 1步，600行
rrdDef.addArchive(AVERAGE, 0.5, 6, 700); // 6步，700行
rrdDef.addArchive(MAX, 0.5, 1, 600);

// 然后，从定义创建RrdDb并开始添加数据
try (RrdDb rrdDb = RrdDb.getBuilder().setRrdDef(rrdDef).build()) {
    Sample sample = rrdDb.createSample();
    while (...) {
        double inbytes = ...
        double outbytes = ...
        sample.setValue("inbytes", inbytes);
        sample.setValue("outbytes", outbytes);
        sample.update();
    }
}

// 接着创建图表定义
RrdGraphDef gDef = new RrdGraphDef();
gDef.setWidth(500);
gDef.setHeight(300);
gDef.setFilename("inbytes.png");
gDef.setTitle("我的标题");
gDef.setVerticalLabel("字节");
gDef.datasource("inbytes-average", rrdPath, "inbytes", AVERAGE);
gDef.line("inbytes-average", Color.BLUE, "输入字节");
gDef.hrule(2568, Color.GREEN, "水平线");
gDef.setImageFormat("png");

// 最后实际绘制图表
RrdGraph graph = new RrdGraph(gDef); // 将在指定路径创建图表