Skip to content

Commit 00cdbed

Browse files
authored
Add tracking of configurable VM limits to operations checklist (OpenRiak#116)
* Add tracking of configurable VM limits to operations checklist * Add proc (for vm_proc_percent) * Change words to reflect differences between process monitoring and other stats The ets limit is no longer a hard limit. the atom count and port count growing is probably an indication of an issue - i.e. unlike the process count it should not need to be increased with scale.
1 parent db22b38 commit 00cdbed

File tree

2 files changed

+6
-1
lines changed

2 files changed

+6
-1
lines changed

.wordlist.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -222,6 +222,7 @@ erlef
222222
eval
223223
priv
224224
env
225+
proc
225226

226227
# Computing terminology
227228
incast

docs/OperationsAndTroubleshootingGuide.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -773,7 +773,11 @@ Monitoring of activity related to these issues is important. Further, it is vit
773773
- Memory used by the Riak process,
774774
- Low thresholds for memory should be used because of the value in over-provisioning memory, and the possibility for large requests to trigger volatile changes in memory demand.
775775
- Open file descriptors.
776-
- Utilisation limits should be monitored for trends that cluster expansion is required, due to repeated breaches of thresholds in:
776+
- Limits on the Erlang Virtual Machine should be monitored
777+
- <span>Available from Riak 3.4.1</span>{: .label .label-purple }The [Riak stats endpoint](#riak-stats) directly reports the percentage utilisation of key virtual machine statistics.
778+
- `vm_proc_percent` - controlled via the hidden configuration option `erlang.process_limit` in `riak.conf`. The underlying numbers are reported in `vm_proc_count` and `vm_proc_limit`. The number of processes will expand with the size of the store in keys per-node - in particular when using the leveled backend - so the limit may require reconfiguration as nodes vertically scale.
779+
- Also tracked are the hard limits on ports (`vm_port_percent`) and atoms (`vm_atom_percent`), and the soft limit on ETS tables (`vm_ets_percent`). These numbers should not normally increase significantly as the key count expands.
780+
- Infrastructure utilisation limits should be monitored for trends that cluster expansion is required, due to repeated breaches of thresholds in:
777781
- Interface bandwidth.
778782
- CPU utilisation.
779783
- Disk I/O operations (especially when I/O is limited by cloud providers).

0 commit comments

Comments
 (0)