rknpu-exporter

KO | EN

gitlite — search

#react #llm #go #deep-learning #docker #java #windows #awesome #cli #kubernetes #awesome-list #pytorch #mcp #open-source

(★ 15)

Prometheus exporter for Rockchip NPU load metrics, written in Rust.

rknpu-exporter Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RKNPU Exporter
[![Rust](https://github.com/yinguobing/rknpu-exporter/actions/workflows/rust.yml/badge.svg?branch=main)](https://github.com/yinguobing/rknpu-exporter/actions/workflows/rust.yml)

Prometheus exporter for Rockchip NPU load metrics, written in Rust.

![Grafana Screenshot](https://raw.githubusercontent.com/yinguobing/rknpu-exporter/main/doc/screenshot.jpg)

## How it works
The Rockchip NPU load is available by this command:
```bash
sudo cat /sys/kernel/debug/rknpu/load
# output
NPU load:  Core0:  0%, Core1:  0%, Core2:  0%,
```
With a little help of [Rocket](https://rocket.rs/) and [client_rust](https://github.com/prometheus/client_rust), the load metrics could be parsed and exported for Prometheus.

## Prerequisites
To run the exporter natively:
- RK3588 SoC
- Debian 11

To develop:
- rustc 1.89.0 (29483883e 2025-08-04)

## Install
1. Download the executable binary file from the [Release](https://github.com/yinguobing/rknpu-exporter/releases) page and extract the content.

2. Create a configuration file named `Rocket.toml` in the same directory, and fill
it with your custom settings.
    ```toml
    # Example setup.
    [release]
    address = "0.0.0.0"
    port = 9102
    ```
    
That's all.

Notes

- > The exporter only makes the NPU load metrics available for scraping. 
A working stack of [Prometheus](https://prometheus.io/) and [Grafana](https://prometheus.io/docs/visualization/grafana/) is required for visual inspecting. 
Please refer to their official documents for installation.

- > For full configuration options: https://rocket.rs/v0.5-rc/guide/configuration/

## Run
In the directory where the binary file located
```bash
sudo ./rknpu-exporter
```

A message looks like `🚀 Rocket has launched from http://127.0.0.1:8000` will be printed, then the exporter is ready.

## Quick test
Open a browser and visit `127.0.0.1:9102/metrics`, you shall see the raw metrics.
```
# HELP rockchip_npu_load Rockchip NPU Load.
# TYPE rockchip_npu_load gauge
rockchip_npu_load{manufacturer="rockchip",device="npu",id="1"} 0
rockchip_npu_load{manufacturer="rockchip",device="npu",id="2"} 0
rockchip_npu_load{manufacturer="rockchip",device="npu",id="0"} 28
# EOF
```

If you are running the exporter in a remote machine, replace `127.0.0.1` with actual IP address.

## Run as a systemd service
Consider using a systemd service file.

Modify the following sample so the executable file and the config file locations are correct. Name this service file as you wish (`rkxporter.service` as an example) and put it in directory `/etc/systemd/system`.

```service
# File name: rkxporter.service
# This is a sample file. Please modify before using.
[Unit]
Description=Rockchip NPU Exporter
After=network.target
Before=shutdown.target

[Service]
WorkingDirectory=/usr/local/npuexporter
ExecStart=/usr/local/npuexporter/bin/rknpu-exporter
Type=simple
Restart=always
StandardOutput=syslog
StandardError=syslog

[Install]
WantedBy=multi-user.target
```

Then start it with systemd command.

```bash
sudo systemctl start rkxporter
```
## Run as a Docker container
The Dockerfile is meant to build for/on aarch64. I don't think it would make sense to build this for other architectures.

Make sure to mount `/sys/kernel/debug/rknpu/load` into your container.

## License
See [`LICENSE`](LICENSE) for more information.

## Authors
Yin Guobing (尹国冰) - [yinguobing](https://yinguobing.com/)

rknpu-exporter

rknpu-exporter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

rknpu-exporter

rknpu-exporter Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README