# libcollector

**Repository Path**: mirrors_ARM-software/libcollector

## Basic Information

- **Project Name**: libcollector
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-08-26
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

What
====

libcollector is a library for making performance measurements.

The tool burrow is included to make 200Hz CPU Load measurements for subsequent analysis by
ferret.py.

Build
=====
```
git submodule update --init --recursive
```

Linux
-----

```
mkdir build
cd build
cmake ..
make -j 8
```

Android
-------

You can build for android using ndk-build (deprecated for later android version) or with gradle.
Both require a local checkout of the android-ndk, you should set the ANDROID_NDK environment variable to point to your local android-ndk folder.


Android with ndk-build
-------

```
cd android
ndk-build -j 8
```


Android with gradle
-------

```
cd android/gradle
./gradlew assembleRelease
```


Usage
=====

Direct function calls
---------------------

JSON interface
--------------

Example:

```json
{
    "cpufreq" : {
        "required" : true,
        "threaded" : true,
        "rate": 100,
    }
}
```


Using as a layer (Vulkan only)
==============================

Linux
-----

Once built, the layer and json manifest will be in <build_dir>/implicit_layer.d

Set the following env. vars to enable the layer on linux:

```bash
export VK_LAYER_PATH=<build_dir>/implicit_layer.d
export VK_INSTANCE_LAYERS=VK_LAYER_ARM_libcollector
export VK_DEVICE_LAYERS=VK_LAYER_ARM_libcollector
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$VK_LAYER_PATH
```

Then set the following env var to point to your libcollector JSON configuration file:

```bash
export VK_LIBCOLLECTOR_CONFIG_PATH=<path_to_json>
```

Android
-------

Local file to push to the location on Android specified:

```bash
adb push arm64/libVkLayer_libcollector.so   /data/app/{app_path}/lib/arm64/
adb push layer/libcollector_config.json     /sdcard/Download/
```

Set the following env. vars to enable the layer on Android:

```bash
adb shell setprop debug.vulkan.layer.1   VK_LAYER_ARM_libcollector
```

Then run your app as normal. One result file will be created per device in your application, and by default the results are written to the run directory.
To override this, set the "result_file_basename" field in the config json. Get the result file in the specified location, for example: /sdcard/Download/results_device_0.json

JSON interface (layer specific)
---------------------------

When using the layer, the JSON config has a extended set of configurations options.

Note that all parameters are optional except for the "collectors" field. The values below are the Linux default values given if nothing else is specified.

```json
{
	"collectors": {
		"cpufreq" : {
	        "required" : true,
	        "threaded" : true,
	        "rate": 100,
	    }
	},
	"result_file_basename": "results.json",
	"frame_trigger_function": "vkQueuePresentKHR",
	"num_subframes_per_frame": 1,
	"start_frame": 0,
	"end_frame": 99999
}
```

These are:
 * result_file_basename - The basename for each result file. There will be one per. vulkan device, expanded as: results_device_<n>.json
 * frame_trigger_function - The function call that will trigger a sample for all synchronous collectors.
 * num_subframes_per_frame - The number of times the "frame_trigger_function" must be called before a sample is triggered and a frame is counted. (2 would be every other call, 3 every third call etc.)
 * start_frame - The frame at which sampling will start.
 * end_frame - Stop sampling at this frame