Skip to content

Commit c4272e3

Browse files
Document advance DRS settings (#374)
* Document advance DRS settings * Update source/adminguide/clusters.rst Co-authored-by: Suresh Kumar Anaparti <sureshkumar.anaparti@gmail.com> * Apply suggestions from code review Co-authored-by: Suresh Kumar Anaparti <sureshkumar.anaparti@gmail.com> --------- Co-authored-by: Suresh Kumar Anaparti <sureshkumar.anaparti@gmail.com>
1 parent 6039ccf commit c4272e3

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

source/adminguide/clusters.rst

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,30 @@ Following are the configuration parameters for DRS.
7474
Very high value for ``drs.max.migrations`` can result in management server using up all of it's workers for DRS tasks
7575
and not being able to execute other tasks.
7676

77+
There are some advanced parameters that can be configured for DRS. These parameters impact the way imbalance is calculated
78+
for a cluster. Do not change these parameters unless you know what you are doing.
79+
80+
.. list-table:: Advanced DRS related cluster parameters
81+
:header-rows: 1
82+
83+
* - Parameter
84+
- Default
85+
- Description
86+
* - ``drs.metric.type``
87+
- `used`
88+
- The metric type used to measure imbalance in a cluster. This can completely change the imbalance value.
89+
Possible values are free, used.
90+
* - ``drs.metric.use.ratio``
91+
- `true`
92+
- Whether to use ratio of selected metric & total. Useful when the cluster has hosts with different capacities.
93+
* - ``drs.imbalance.condensed.skip.threshold``
94+
- `0.95`
95+
- Threshold to ignore the metric for a host while calculating the imbalance to decide whether DRS is required for
96+
a cluster. This is to avoid cases when the calculated imbalance gets skewed due to a single host having a very
97+
high/low metric value resulting in imbalance being higher than 1. If ``drs.metric.type`` is ``free``, set a lower
98+
value and if it is ``used`` set a higher value. The value should be between `0.0` and `1.0`.
99+
This is applicable only for Condensed algorithm.
100+
77101
Executing manual DRS on a cluster
78102
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
79103
DRS can also be manually executed for a cluster.

0 commit comments

Comments
 (0)