This is an automated email from the ASF dual-hosted git repository.
rohit pushed a commit to branch 4.19
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.19 by this push:
new c4272e3 Document advance DRS settings (#374)
c4272e3 is described below
commit c4272e3880e62f2d3623c6c8d0b71b31ace5c9c6
Author: Vishesh <[email protected]>
AuthorDate: Tue Feb 13 11:19:10 2024 +0530
Document advance DRS settings (#374)
* Document advance DRS settings
* Update source/adminguide/clusters.rst
Co-authored-by: Suresh Kumar Anaparti <[email protected]>
* Apply suggestions from code review
Co-authored-by: Suresh Kumar Anaparti <[email protected]>
---------
Co-authored-by: Suresh Kumar Anaparti <[email protected]>
---
source/adminguide/clusters.rst | 24 ++++++++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/source/adminguide/clusters.rst b/source/adminguide/clusters.rst
index 7abe52d..12859a3 100644
--- a/source/adminguide/clusters.rst
+++ b/source/adminguide/clusters.rst
@@ -74,6 +74,30 @@ Following are the configuration parameters for DRS.
Very high value for ``drs.max.migrations`` can result in management server
using up all of it's workers for DRS tasks
and not being able to execute other tasks.
+There are some advanced parameters that can be configured for DRS. These
parameters impact the way imbalance is calculated
+for a cluster. Do not change these parameters unless you know what you are
doing.
+
+.. list-table:: Advanced DRS related cluster parameters
+ :header-rows: 1
+
+ * - Parameter
+ - Default
+ - Description
+ * - ``drs.metric.type``
+ - `used`
+ - The metric type used to measure imbalance in a cluster. This can
completely change the imbalance value.
+ Possible values are free, used.
+ * - ``drs.metric.use.ratio``
+ - `true`
+ - Whether to use ratio of selected metric & total. Useful when the
cluster has hosts with different capacities.
+ * - ``drs.imbalance.condensed.skip.threshold``
+ - `0.95`
+ - Threshold to ignore the metric for a host while calculating the
imbalance to decide whether DRS is required for
+ a cluster. This is to avoid cases when the calculated imbalance gets
skewed due to a single host having a very
+ high/low metric value resulting in imbalance being higher than 1. If
``drs.metric.type`` is ``free``, set a lower
+ value and if it is ``used`` set a higher value. The value should be
between `0.0` and `1.0`.
+ This is applicable only for Condensed algorithm.
+
Executing manual DRS on a cluster
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
DRS can also be manually executed for a cluster.
