github/nohang
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update conf

Browse Source
This commit is contained in:
Alexey Avramov 2020-07-03 23:59:00 +09:00
parent c3c0b510a8
commit bcd28996b3
1 changed files with 211 additions and 412 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

623
conf/nohang/nohang.conf.in
View File

@ -1,562 +1,361 @@
This is the configuration file of the nohang daemon. ## This is the configuration file of the nohang daemon.
The configuration includes the following sections:
1. Common zram settings ## The configuration includes the following sections:
2. Common PSI settings ## 1. Common zram settings
3. Poll rate ## 2. Common PSI settings
4. Warnings and notifications ## 3. Poll rate
5. Soft (SIGTERM) threshold ## 4. Warnings and notifications
6. Hard (SIGKILL) threshold ## 5. Soft (SIGTERM) threshold
7. Customize victim selection: adjusting badness of processes ## 6. Hard (SIGKILL) threshold
8. Customize soft corrective actions ## 7. Customize victim selection: adjusting badness of processes
9. Misc settings ## 8. Customize soft corrective actions
10. Verbosity, debug, logging ## 9. Misc settings
## 10. Verbosity, debug, logging
WARNING! ## WARNING!
- Lines starting with #, tabs and whitespace characters are comments. ## - Lines starting with #, tabs and whitespace characters are comments.
- Lines starting with @ contain optional parameters that may be repeated. ## - Lines starting with @ contain optional parameters that may be repeated.
- All values are case sensitive. ## - All values are case sensitive.
- nohang doesn't forbid you to shoot yourself in the foot. Be careful! ## - nohang doesn't forbid you to shoot yourself in the foot. Be careful!
- Restart the daemon after editing the file to apply the new settings. ## - Restart the daemon after editing the file to apply the new settings.
- You can find the file with default values here: :TARGET_DATADIR:/nohang/nohang.conf ## - You can find the file with default values here: :TARGET_DATADIR:/nohang/nohang.conf
## To find config keys descriptions see man(8) nohang
############################################################################### ###############################################################################
1. Common zram settings ## 1. Common zram settings
Key: zram_checking_enabled
Description:
Type: boolean
Valid values: True | False
Default value: False
zram_checking_enabled = False zram_checking_enabled = False
## Type: boolean, valid values: True | False
## Default value: False
############################################################################### ###############################################################################
2. Common PSI settings ## 2. Common PSI settings
Key: psi_checking_enabled
Description:
Type: boolean
Valid values: True | False
Default value: False
psi_checking_enabled = False psi_checking_enabled = False
## Type: boolean, valid values: True | False
Key: psi_path ## Default value: False
Description:
Type: string
Valid values: any string
Default value: /proc/pressure/memory
psi_path = /proc/pressure/memory psi_path = /proc/pressure/memory
## Type: string; valid values: any string
Key: psi_metrics ## Default value: /proc/pressure/memory
Description:
Type: string
Valid values: some_avg10, some_avg60, some_avg300,
full_avg10, full_avg60, full_avg300
Default value: some_avg10
psi_metrics = some_avg10 psi_metrics = some_avg10
## Type: string; valid values: some_avg10, some_avg60, some_avg300,
Key: psi_excess_duration ## full_avg10, full_avg60, full_avg300
Description: ## Default value: some_avg10
Type: float
Valid values: >= 0
Default value: 30
psi_excess_duration = 30 psi_excess_duration = 30
## Type: float; valid values: >= 0
Key: psi_post_action_delay ## Default value: 30
Description:
Type: float
Valid values: >= 10
Default value: 15
psi_post_action_delay = 15 psi_post_action_delay = 15
## Type: float; valid values: >= 10
## Default value: 15
############################################################################### ###############################################################################
3. Poll rate ## 3. Poll rate
Key: fill_rate_mem
Description:
Type: float
Valid values: >= 100
Default value: 6000
fill_rate_mem = 6000 fill_rate_mem = 6000
## Type: float; valid values: >= 100
Key: fill_rate_swap ## Default value: 6000
Description:
Type: float
Valid values: >= 100
Default value: 2000
fill_rate_swap = 2000 fill_rate_swap = 2000
## Type: float; valid values: >= 100
Key: fill_rate_zram ## Default value: 2000
Description:
Type: float
Valid values: >= 100
Default value: 4000
fill_rate_zram = 4000 fill_rate_zram = 4000
## Type: float; valid values: >= 100
Key: max_sleep ## Default value: 4000
Description:
Type: float
Valid values: >= 0.01 and >= min_sleep
Default value: 3
max_sleep = 3 max_sleep = 3
## Type: float; valid values: >= 0.01 and >= min_sleep
Key: min_sleep ## Default value: 3
Description:
Type: float
Valid values: >= 0.01 and <= max_sleep
Default value: 0.1
min_sleep = 0.1 min_sleep = 0.1
## Type: float; valid values: >= 0.01 and <= max_sleep
## Default value: 0.1
############################################################################### ###############################################################################
4. Warnings and notifications ## 4. Warnings and notifications
4.1. GUI notifications after corrective actions ## 4.1. GUI notifications after corrective actions
Key: post_action_gui_notifications
Description:
Type: boolean
Valid values: True | False
Default value: False
post_action_gui_notifications = False post_action_gui_notifications = False
## Type: boolean; valid values: True | False
Key: hide_corrective_action_type ## Default value: False
Description:
Type: boolean
Valid values: True | False
Default value: False
hide_corrective_action_type = False hide_corrective_action_type = False
## Type: boolean; valid values: True | False
## Default value: False
4.2. Low memory warnings
Key: low_memory_warnings_enabled ## 4.2. Low memory warnings
Description:
Type: boolean
Valid values: True | False
Default value: False
low_memory_warnings_enabled = False low_memory_warnings_enabled = False
## Type: boolean; valid values: True | False
Key: warning_exe ## Default value: False
Description:
Type: string
Valid values: any string
Default value: (empty string)
warning_exe = warning_exe =
## Type: string; valid values: any string
## Default value: (empty string)
Key: warning_threshold_min_mem
Description:
Type: float (with % or M)
Valid values: from the range [0; 100] %
Default value: 20 %
warning_threshold_min_mem = 20 % warning_threshold_min_mem = 20 %
## Type: float (with % or M); valid values: from the range [0; 100] %
Key: warning_threshold_min_swap ## Default value: 20 %
Description:
Type: float (with % or M)
Valid values: [0; 100] % or >= 0 M
Default value: 20 %
warning_threshold_min_swap = 25 % warning_threshold_min_swap = 25 %
## Type: float (with % or M); valid values: [0; 100] % or >= 0 M
Key: warning_threshold_max_zram ## Default value: 20 %
Description:
Type: float (with % or M)
Valid values: from the range [0; 100] %
Default value: 45 %
warning_threshold_max_zram = 45 % warning_threshold_max_zram = 45 %
## Type: float (with % or M); valid values: from the range [0; 100] %
Key: warning_threshold_max_psi ## Default value: 45 %
Description:
Type: float
Valid values: from the range [0; 100]
Default value: 10
warning_threshold_max_psi = 10 warning_threshold_max_psi = 10
## Type: float; valid values: from the range [0; 100]
## Default value: 10
Key: min_post_warning_delay
Description:
Type: float
Valid values: >= 1
Default value: 60
min_post_warning_delay = 60 min_post_warning_delay = 60
## Type: float; valid values: >= 1
Key: env_cache_time ## Default value: 60
Description:
Type: float
Valid values: >= 0
Default value: 300
env_cache_time = 300 env_cache_time = 300
## Type: float; valid values: >= 0
## Default value: 300
############################################################################### ###############################################################################
5. Soft threshold (thresholds for sending the SIGTERM signal or ## 5. Soft threshold (thresholds for sending the SIGTERM signal or
implementing other soft corrective action) ## implementing other soft corrective action)
Key: soft_threshold_min_mem
Description:
Type: float (with % or M)
Valid values: from the range [0; 50] %
Default value: 5 %
soft_threshold_min_mem = 5 % soft_threshold_min_mem = 5 %
## Type: float (with % or M); valid values: from the range [0; 50] %
Key: soft_threshold_min_swap ## Default value: 5 %
Description:
Type: float (with % or M)
Valid values: [0; 100] % or >= 0 M
Default value: 10 %
soft_threshold_min_swap = 10 % soft_threshold_min_swap = 10 %
## Type: float (with % or M); valid values: [0; 100] % or >= 0 M
Key: soft_threshold_max_zram ## Default value: 10 %
Description:
Type: float (with % or M)
Valid values: from the range [10; 90] %
Default value: 55 %
soft_threshold_max_zram = 55 % soft_threshold_max_zram = 55 %
## Type: float (with % or M); valid values: from the range [10; 90] %
Key: soft_threshold_max_psi ## Default value: 55 %
Description:
Type: float
Valid values: from the range [5; 100]
Default value: 40
soft_threshold_max_psi = 40 soft_threshold_max_psi = 40
## Type: float; valid values: from the range [5; 100]
## Default value: 40
############################################################################### ###############################################################################
6. Hard threshold (thresholds for sending the SIGKILL signal) ## 6. Hard threshold (thresholds for sending the SIGKILL signal)
Key: hard_threshold_min_mem
Description:
Type: float (with % or M)
Valid values: from the range [0; 50] %
Default value: 2 %
hard_threshold_min_mem = 2 % hard_threshold_min_mem = 2 %
## Type: float (with % or M); valid values: from the range [0; 50] %
Key: hard_threshold_min_swap ## Default value: 2 %
Description:
Type: float (with % or M)
Valid values: [0; 100] % or >= 0 M
Default value: 4 %
hard_threshold_min_swap = 4 % hard_threshold_min_swap = 4 %
## Type: float (with % or M); valid values: [0; 100] % or >= 0 M
Key: hard_threshold_max_zram ## Default value: 4 %
Description:
Type: float (with % or M)
Valid values: from the range [10; 90] %
Default value: 60 %
hard_threshold_max_zram = 60 % hard_threshold_max_zram = 60 %
## Type: float (with % or M); valid values: from the range [10; 90] %
Key: hard_threshold_max_psi ## Default value: 60 %
Description:
Type: float
Valid values: from the range [5; 100]
Default value: 90
hard_threshold_max_psi = 90 hard_threshold_max_psi = 90
## Type: float; valid values: from the range [5; 100]
## Default value: 90
############################################################################### ###############################################################################
7. Customize victim selection: adjusting badness of processes ## 7. Customize victim selection: adjusting badness of processes
7.1. Ignore positive oom_score_adj ## 7.1. Ignore positive oom_score_adj
Key: ignore_positive_oom_score_adj
Description:
Type: boolean
Valid values: True | False
Default value: False
ignore_positive_oom_score_adj = False ignore_positive_oom_score_adj = False
## Type: boolean; valid values: True | False
7.2.1. Matching process names with RE patterns change their badness ## Default value: False
Syntax:
@BADNESS_ADJ_RE_NAME badness_adj /// RE_pattern
New badness value will be += badness_adj
It is possible to compare multiple patterns
with different badness_adj values.
Example:
@BADNESS_ADJ_RE_NAME 200 /// ^Web Content$
7.2.2. Matching CGroup_v1-line with RE patterns
@BADNESS_ADJ_RE_CGROUP_V1 -50 /// ^/system\.slice/
@BADNESS_ADJ_RE_CGROUP_V1 50 /// /foo\.service$
@BADNESS_ADJ_RE_CGROUP_V1 -50 /// ^/user\.slice/
7.2.3. Matching CGroup_v2-line with RE patterns
@BADNESS_ADJ_RE_CGROUP_V2 100 /// ^/workload
7.2.4. Matching eUIDs with RE patterns
@BADNESS_ADJ_RE_UID -100 /// ^0$
7.2.5. Matching /proc/[pid]/exe realpath with RE patterns
Example:
@BADNESS_ADJ_RE_REALPATH 900 /// ^(/usr/bin/stress|/usr/bin/stress-ng)$
7.2.6. Matching /proc/[pid]/cwd realpath with RE patterns
@BADNESS_ADJ_RE_CWD 200 /// ^/home/
7.2.7. Matching cmdlines with RE patterns
WARNING: using this option can greatly slow down the search for a victim
in conditions of heavily swapping.
Prefer Chromium tabs and Electron-based apps
@BADNESS_ADJ_RE_CMDLINE 200 /// --type=renderer
Prefer Firefox tabs (Web Content and WebExtensions)
@BADNESS_ADJ_RE_CMDLINE 100 /// -appomni
@BADNESS_ADJ_RE_CMDLINE -200 /// ^/usr/lib/virtualbox
7.2.8. Matching environ with RE patterns
WARNING: using this option can greatly slow down the search for a victim
in conditions of heavy swapping.
@BADNESS_ADJ_RE_ENVIRON 100 /// USER=user
Note that you can control badness also via systemd units via ## 7.2. Matching process properties with regular expressions to change their
OOMScoreAdjust, see ## badness.
www.freedesktop.org/software/systemd/man/systemd.exec.html#OOMScoreAdjust=
## Syntax:
## @BADNESS_ADJ_RE_PROPERTY badness_adj /// RE_pattern
## New badness value will be added to process's badness_adj
## It is possible to compare multiple patterns
## with different badness_adj values.
## 7.2.1. Matching process names with RE patterns to change their badness
## Example:
# @BADNESS_ADJ_RE_NAME 200 /// ^Web Content$
## 7.2.2. Matching CGroup_v1-line with RE patterns
# @BADNESS_ADJ_RE_CGROUP_V1 50 /// /foo\.service$
# @BADNESS_ADJ_RE_CGROUP_V1 -50 /// ^/user\.slice/
## 7.2.3. Matching CGroup_v2-line with RE patterns
# @BADNESS_ADJ_RE_CGROUP_V2 100 /// ^/workload
## 7.2.4. Matching eUIDs with RE patterns
# @BADNESS_ADJ_RE_UID -100 /// ^0$
## 7.2.5. Matching /proc/[pid]/exe realpath with RE patterns
## Example:
# @BADNESS_ADJ_RE_REALPATH 900 /// ^(/usr/bin/stress|/usr/bin/stress-ng)$
## 7.2.6. Matching /proc/[pid]/cwd realpath with RE patterns
# @BADNESS_ADJ_RE_CWD 200 /// ^/home/
## 7.2.7. Matching cmdlines with RE patterns
## WARNING: using this option can greatly slow down the search for a victim
## in conditions of intense swapping.
## Prefer Chromium tabs and Electron-based apps
# @BADNESS_ADJ_RE_CMDLINE 200 /// --type=renderer
## Prefer Firefox tabs (Web Content and WebExtensions)
# @BADNESS_ADJ_RE_CMDLINE 100 /// -appomni
## Avoid Virtualbox processes
# @BADNESS_ADJ_RE_CMDLINE -200 /// ^/usr/lib/virtualbox
## 7.2.8. Matching environ with RE patterns
## WARNING: using this option can greatly slow down the search for a victim
## in conditions of heavy swapping.
# @BADNESS_ADJ_RE_ENVIRON 100 /// USER=user
# Note that you can control badness also via systemd units via
# OOMScoreAdjust, see
# www.freedesktop.org/software/systemd/man/systemd.exec.html#OOMScoreAdjust=
############################################################################### ###############################################################################
8. Customize soft corrective actions ## 8. Customize soft corrective actions
Run the command instead of sending a signal with at soft corrective action ## Run the command instead of sending a signal with at soft corrective action
if the victim's name or cgroup matches the regular expression. ## if the victim's name or cgroup matches the regular expression.
Syntax: ## Syntax:
KEY REGEXP SEPARATOR COMMAND ## KEY REGEXP SEPARATOR COMMAND
@SOFT_ACTION_RE_NAME ^foo$ /// kill -USR1 $PID # @SOFT_ACTION_RE_NAME ^foo$ /// kill -USR1 $PID
@SOFT_ACTION_RE_CGROUP_V1 ^/system\.slice/ /// systemctl restart $SERVICE # @SOFT_ACTION_RE_CGROUP_V1 ^/system\.slice/ /// systemctl restart $SERVICE
@SOFT_ACTION_RE_CGROUP_V2 /foo\.service$ /// systemctl restart $SERVICE # @SOFT_ACTION_RE_CGROUP_V2 /foo\.service$ /// systemctl restart $SERVICE
$PID will be replaced by process PID. ## $PID will be replaced by process PID.
$NAME will be replaced by process name. ## $NAME will be replaced by process name.
$SERVICE will be replaced by .service if it exists (overwise it will be ## $SERVICE will be replaced by .service if it exists (overwise it will be
relpaced by empty line) ## relpaced by empty line)
############################################################################### ###############################################################################
9. Misc settings ## 9. Misc settings
Key: max_soft_exit_time
Description:
Type: float
Valid values: >= 0.1
Default value: 10
max_soft_exit_time = 10 max_soft_exit_time = 10
## Type: float; valid values: >= 0.1
Key: post_kill_exe ## Default value: 10
Description:
Type: string
Valid values: any string
Default value: (empty string)
post_kill_exe = post_kill_exe =
## Type: string; valid values: any string
Key: min_badness ## Default value: (empty string)
Description:
Type: integer
Valid values: >= 1
Default value: 1
min_badness = 1 min_badness = 1
## Type: integer; valid values: >= 1
Key: post_soft_action_delay ## Default value: 1
Description: ## nohang will do nothing if the badness of all processes is below min_badness
Type: float ## (actualy it will spam to stdout/log)
Valid values: >= 0.1
Default value: 3
post_soft_action_delay = 3 post_soft_action_delay = 3
## Type: float; valid values: >= 0.1
Key: post_zombie_delay ## Default value: 3
Description:
Type: float
Valid values: >= 0
Default value: 0.1
post_zombie_delay = 0.1 post_zombie_delay = 0.1
## Type: float; valid values: >= 0
Key: victim_cache_time ## Default value: 0.1
Description:
Type: float
Valid values: >= 0
Default value: 10
victim_cache_time = 10 victim_cache_time = 10
## Type: float; valid values: >= 0
Key: exe_timeout ## Default value: 10
Description:
Type: float
Valid values: >= 0.1
Default value: 20
exe_timeout = 20 exe_timeout = 20
## Type: float; valid values: >= 0.1
## Default value: 20
############################################################################### ###############################################################################
10. Verbosity, debug, logging ## 10. Verbosity, debug, logging
Key: print_config_at_startup
Description:
Type: boolean
Valid values: True | False
Default value: False
print_config_at_startup = False print_config_at_startup = False
## Type: boolean; valid values: True | False
Key: print_mem_check_results ## Default value: False
Description:
Type: boolean
Valid values: True | False
Default value: False
print_mem_check_results = False print_mem_check_results = False
## Type: boolean; valid values: True | False
Key: min_mem_report_interval ## Default value: False
Description:
Type: float
Valid values: >= 0
Default value: 60
min_mem_report_interval = 60 min_mem_report_interval = 60
## Type: float; valid values: >= 0
Key: print_proc_table ## Default value: 60
Description:
Type: boolean
Valid values: True | False
Default value: False
print_proc_table = False print_proc_table = False
## Type: boolean; valid values: True | False
Key: extra_table_info ## Default value: False
Description:
WARNING: using "cmdline" or "environ" keys can greatly slow down
the search for a victim in conditions of heavy swapping.
Type: string
Valid values: None, cgroup_v1, cgroup_v2, realpath,
cwd, cmdline, environ
Default value: None
extra_table_info = None extra_table_info = None
## Type: string; valid values: None, cgroup_v1, cgroup_v2, realpath, cwd,
Key: print_victim_status ## cmdline, environ
Description: ## Default value: None
Type: boolean ## WARNING: using "cmdline" or "environ" keys can greatly slow down the search
Valid values: True | False ## for a victim in conditions of heavy swapping.
Default value: True
print_victim_status = True print_victim_status = True
## Type: boolean; valid values: True | False
Key: print_victim_cmdline ## Default value: True
Description:
Type: boolean
Valid values: True | False
Default value: False
print_victim_cmdline = False print_victim_cmdline = False
## Type: boolean; valid values: True | False
Key: max_victim_ancestry_depth ## Default value: False
Description:
Type: integer
Valid values: >= 1
Default value: 3
max_victim_ancestry_depth = 3 max_victim_ancestry_depth = 3
## Type: integer; valid values: >= 1
Key: print_statistics ## Default value: 3
Description:
Type: boolean
Valid values: True | False
Default value: True
print_statistics = True print_statistics = True
Key: debug_psi ## Type: boolean; valid values: True | False
Description: ## Default value: True
Type: boolean
Valid values: True | False
Default value: False
debug_psi = False debug_psi = False
## Type: boolean; valid values: True | False
Key: debug_gui_notifications ## Default value: False
Description:
Type: boolean
Valid values: True | False
Default value: False
debug_gui_notifications = False debug_gui_notifications = False
## Type: boolean; valid values: True | False
Key: debug_sleep ## Default value: False
Description:
Type: boolean
Valid values: True | False
Default value: False
debug_sleep = False debug_sleep = False
## Type: boolean; valid values: True | False
Key: debug_threading ## Default value: False
Description:
Type: boolean
Valid values: True | False
Default value: False
debug_threading = False debug_threading = False
## Type: boolean; valid values: True | False
Key: separate_log ## Default value: False
Description:
Type: boolean
Valid values: True | False
Default value: False
separate_log = False separate_log = False
## Type: boolean; valid values: True | False
## Default value: False
############################################################################### ###############################################################################
Use cases, feature requests and any questions are welcome: ## Use cases, feature requests and any questions are welcome:
https://github.com/hakavlad/nohang/issues ## https://github.com/hakavlad/nohang/issues
##