joularjx下载joularjx源代码下载

joularjx

PowerBuilder

3.0.1

下载

Joularjx？

Joularjx徽标

Joularjx是基于Java的代理，用于在源代码级别上进行软件电源监视。

详细的文档（包括用户和参考指南）可用：https：//joular.github.io/joularjx/。

特征

监视运行时每种方法的功耗
使用Java代理，无需源代码仪器
使用Intel Rapl（PowerCap接口）在GNU/Linux上获得准确的电源读数，我们在Raspberry Pi设备上的基于研究的回归模型以及自定义程序监视器（使用RAPL驱动程序），以便在Windows上进行准确的电源读数
监视在虚拟机中运行的Java应用的能量
提供监视程序中每种方法的实时功耗
为程序退出的每种方法提供总能量

？汇编和安装

要构建Joularjx，您需要Java 11+和Maven，然后构建：

 mvn clean install -DskipTests

另外，您可以将Maven包装器与该项目一起使用：

 Linux: ./mvnw clean install -DskipTests
Windows: ./mvnw.cmd clean install -DskipTests

Joularjx取决于以下软件或软件包，以获取电源阅读：

在Windows上，Joularjx使用一个自定义的电源监视器程序，该程序使用Hubblo的Windows Rapl驱动程序，因此需要先安装驱动程序，并在Intel或AMD CPU上运行（因为Ryzen以来）。
在Windows上，要阅读Rapl驱动程序的数据，我们使用了称为Windows的称为Power Monitor的自定义程序监视器。它曾经是Joularjx的一部分，但现在它是自己的存储库。下载二进制文件（或编译源代码），并在config.properties中指定其路径。
在PC/Server GNU/Linux上，Joularjx通过PowerCap使用Intel Rapl接口，因此需要在Intel CPU或AMD CPU上运行（因为Ryzen）。
在MacOS上，Joularjx使用powermetrics ，这是一种与MacOS捆绑在一起的工具，需要使用sudo Access运行。建议授权当前用户运行/usr/bin/powermetrics而无需通过对sudoers文件进行适当修改而需要密码。
在GNU/Linux上的Raspberry Pi设备上，Joularjx使用我们自己的基于研究的回归模型来估算CPU功耗，并支持以下设备模型（我们支持每个模型阵容的所有修订版本。但是，该模型是在括号中生成和培训的。
- 零W（Rev 1.1），32位OS
- 模型1 B（Rev 2），用于32位OS
- 模型1 B+（Rev 1.2），适用于32位OS
- 模型2 B（Rev 1.1），用于32位OS
- 模型3 B（Rev 1.2），用于32位OS
- 32位OS的模型3 B+（Rev 1.3）
- 32位和64位OS的模型4 B（Rev 1.1和Rev 1.2）
- 400型（Rev 1.0），用于64位OS
- 模型5 B（Rev 1.0），用于64位OS
在虚拟机上，Joularjx从主机和来宾之间共享的文件中读取虚拟机（主机中测量）的功耗。

我们还支持Asus Tinker Board。

用法

Joularjx是Java代理商

 java -javaagent:joularjx-$version.jar YourProgramMainClass

如果您的程序是一个JAR文件，则只需在添加Joularjx时照常运行：

 java -javaagent:joularjx-$version.jar -jar yourProgram.jar

Joularjx将根据配置设置（以config.properties ）生成多个CSV文件，并将在joularjx-results文件夹中创建这些文件。

生成的文件在以下文件夹结构下可用：

Joularjx-results
- appName-pid-start_timestamp
  - 所有（所有方法的功率/能量数据，包括JDK）
    - 运行时（每秒消耗每秒）
      - Calltree（每个呼叫树分支的消费）
      - 方法（每种方法的消耗）
    - 总（总能源消耗，在计划的结尾产生）
      - 卡特里
      - 方法
    - 进化（在应用程序执行过程中，每种方法的功耗演变）
  - App（根据filter-method-names设置，用于监视应用程序的方法的电源/能量数据）
    - 运行时
      - 卡特里
      - 方法
    - 全部的
      - 卡特里
      - 方法
    - 进化

可以通过修改config.properties文件来配置joularjx：

filter-method-names ：将用于过滤受监视方法的字符串列表（有关说明，请参见下面的生成文件）。
save-runtime-data ：在CSV文件中写入运行时方法的功耗。
overwrite-runtime-data ：覆盖运行时电源数据文件，或者如果设置为false，它将为每个监视周期编写新文件。
logger-level ：设置Joularjx在终端中给出的信息级别（允许值：关闭，信息，警告，严重）。
powermonitor-path ：Windows程序的Power Monitor（仅适用于Windows）的完整路径。
track-consumption-evolution ：为每种方法生成CSV文件，其中包含该方法消耗的详细信息。每个消耗值映射到UNIX时间戳。
hide-agent-consumption ：如果设置为真，则不会报告代理线程的能耗。
enable-call-trees-consumption ：计算方法称之为树木的能耗。 CSV文件将在代理执行结束时生成，并将其与每个呼叫树关联到总能量消耗。
在CSV文件中save-call-trees-runtime-data ：编写运行时调用树功耗。对于每个监视周期（1秒），将生成一个新的CSV文件，其中包含呼叫树的运行时功耗。生成的文件将包括其名称中的时间戳。
overwrite-call-trees-runtime-data ：覆盖运行时调用树电源数据文件，或者如果设置为false，它将为每个监视周期编写新文件。
application-server ：正确处理应用程序服务器和框架（Sprig Boot，Tomcat等）。在应用程序服务器上运行时设置true 。如果为错误，则监视循环将检查JVM是否被销毁，因此在应用程序结束时（常规Java应用程序）关闭Joularjx。如果为true，则Joularjx将继续正确监视，因为在应用程序服务器中不会破坏JVM。
vm-power-path ：虚拟机的功耗的路径。在虚拟机中，指示包含VM功耗的文件（通常是与来宾共享的主机中的文件）。
vm-power-format ：共享VM功率文件的功率格式。当前，我们支持两种格式： watts （一个包含一个浮点值的文件，即VM的功耗）和powerjoular （由主机中的PowerJoular生成的CSV文件，包含3列：Timestamp，CPU的VM和VM的CPU使用率）。

您可以随时安装JAR软件包（以及Windows上的PowerMonitor.exe），并使用完整的路径在javaagent中调用它。但是， config.properties必须复制到与运行Java命令的位置相同的文件夹，或者必须使用-Djoularjx.config=/path/to/config.properties属性设置其位置。

在虚拟机中，Joularjx需要两个步骤：

在主机计算机中安装电源监视工具，该工具将每秒监视虚拟机功耗并将其写入文件（将与访客VM共享）。例如，您可以使用我们的PowerJoular。
在指定与主机及其格式共享的电源文件的路径时，请在访客VM中使用joularj。

生成的文件

对于实时功率数据或程序退出的总能量，Joularjx生成了两个CSV文件：

包含所有方法的功率或能量数据的文件，其中包括JDK的功率或能量数据。
仅包括这些过滤方法的功率或能量数据的过滤文件（可以在config.properties中配置）。这些数据不仅是第一个数据文件的子集，而且是Joularjx为提供准确数据的重新计算：以滤波后关键字开头的方法，将被分配给它调用的JDK方法所消耗的功率或能量。

例如，如果Package1.MethodA调用java.io.PrintStream.println将一些文本打印到终端，则我们计算：

在第一个文件中， println与MethodA分开消耗的功率或能量。后一种功耗不包括println消耗的功耗。
在第二个文件中，如果我们从Package1过滤方法，则将println的功耗添加到MethodA功率消耗中，并且该文件仅提供Package1方法的功率或能量。

我们通过分析运行时所有运行线程的堆栈来实现此操作。

Joularjx读者

Joularjx Reader是一个GUI，可以处理，分析和可视化Joularjx生成的能量文件。它可以在此处提供自己的存储库。

？引用这项工作

为了在研究论文中引用我们的作品，请在第18届智能环境国际会议（IE2022）中引用我们的论文。

PowerJoular和Joularjx：多平台软件电源监视工具。阿德尔·诺德丁（Adel Nourddine）。在第18届国际智能环境会议上（IE2022）。法国Biarritz，2022年。

 @inproceedings{noureddine-ie-2022,
  title = {PowerJoular and JoularJX: Multi-Platform Software Power Monitoring Tools},
  author = {Noureddine, Adel},
  booktitle = {18th International Conference on Intelligent Environments (IE2022)},
  address = {Biarritz, France},
  year = {2022},
  month = {Jun},
  keywords = {Power Monitoring; Measurement; Power Consumption; Energy Analysis}
}