This commit is contained in:
Robin Appelman 2026-04-06 22:30:53 +02:00
commit 40560f2129
11 changed files with 68 additions and 69 deletions

View file

@ -1,4 +1,4 @@
# Palantir
# Sidewindow
Opinionated system metrics exporter for prometheus
@ -14,11 +14,11 @@ Opinionated system metrics exporter for prometheus
## Usage
- Download the binary for your architecture from the
[releases](https://github.com/icewind1991/palantir/releases/) and place it at
`/usr/local/bin/palantir`
- Place the [palantir.service](palantir.service) file in `/etc/systemd/system/`
- Create the `palantir` user: `sudo useradd -m palantir`
- Start enable enable the server: `sudo systemctl enable --now palantir`
[releases](https://codeberg.org/icewind/sidewindow/releases/) and place it at
`/usr/local/bin/sidewindow`
- Place the [sidewindow.service](sidewindow.service) file in `/etc/systemd/system/`
- Create the `sidewindow` user: `sudo useradd -m sidewindow`
- Start enable enable the server: `sudo systemctl enable --now sidewindow`
- Metrics will be available at `localhost:5665/metrics`
Some stats require additional permissions described below.
@ -27,7 +27,7 @@ Some stats require additional permissions described below.
In recent kernel versions, precise power monitoring is only accessible to root
users to prevent using it as a side-channel attack. In order to get the power
monitoring output you'll need to give the `palantir` user access to this data
monitoring output you'll need to give the `sidewindow` user access to this data
using the following steps.
- Create a group using
@ -52,26 +52,26 @@ using the following steps.
- Add your user to the group
```
sudo usermod -a -G powermonitoring palantir
sudo usermod -a -G powermonitoring sidewindow
```
- Verify that you can read energy usage
```
sudo su - palantir -c 'cat /sys/class/powercap/intel-rapl:0:0/energy_uj'
sudo su - sidewindow -c 'cat /sys/class/powercap/intel-rapl:0:0/energy_uj'
```
## Docker monitoring permissions
To enable monitoring of docker containers, add the `palantir` user to the
To enable monitoring of docker containers, add the `sidewindow` user to the
`docker` group
```bash
sudo usermod -a -G docker palantir
sudo usermod -a -G docker sidewindow
```
## Windows support
Palantir has limited windows support out of the box, additional sensors can be
Sidewindow has limited windows support out of the box, additional sensors can be
enabled by running
[LibreHardwareMonitor](https://github.com/LibreHardwareMonitor/LibreHardwareMonitor).