1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
# Automatic Priority Daemon
Aprio was developed to enable systems administrators to automatically renice abusive, long running, CPU intensive
processes. In a shared high-computing environment, users may feel it is necessary to "compete" with each other's
programs, which often times leads to kernel load averages far exceeding an individual server's capabilities.
# Usage Output
```
usage: aprio.py [-h] [--daemon] [--logfile LOGFILE] [--user USER]
[--cpu-threshold CPU_THRESHOLD]
[--cputime-threshold CPUTIME_THRESHOLD]
[--load-threshold LOAD_THRESHOLD] [--time-scale TIME_SCALE]
[--poll POLL] [--test] [--verbose] [--quiet]
optional arguments:
-h, --help show this help message and exit
--daemon, -d Fork into background (default: False)
--logfile LOGFILE, -L LOGFILE
Log output to filename (default: None)
--user USER, -u USER Limit to specific user (default: None)
--cpu-threshold CPU_THRESHOLD, -c CPU_THRESHOLD
Trigger after n% (default: 50.0)
--cputime-threshold CPUTIME_THRESHOLD, -t CPUTIME_THRESHOLD
Trigger after {n}{smdwMy} (default: 30m)
--load-threshold LOAD_THRESHOLD, -l LOAD_THRESHOLD
Trigger after n load average (default: 4)
--time-scale TIME_SCALE, -s TIME_SCALE
Scale by which nice values are calculated {n}{smdwMy}
(default: 1w)
--poll POLL, -p POLL Wait n seconds between polling processes (default: 3)
--test, -T Do not modify processes; report only. (default: False)
--verbose, -v Verbose output (default: False)
--quiet, -q Suppress output (default: False)
```
## Examples
### As a daemon process
```bash
aprio --daemon --cpu-threshold=85.0 --cputime-threshold=2h --load-threshold=10.0 --time-scale=2w
```
### As a foreground process
The default loglevel is INFO. Aprio will only report changes to process priority.
```bash
aprio --cpu-threshold=85.0 --cputime-threshold=2h --load-threshold=10.0 --time-scale=2w
INFO:2014-04-14 09:31:18,872:renice:13481:Priority modified (0 -> 20)
```
### Controlling a single user
The `--user` or `-u` argument allows you to target a user's processes.
```bash
aprio --user=foo --cpu-threshold=85.0 --cputime-threshold=2h --load-threshold=10.0 --time-scale=2w
```
|
