Arnike/watcher
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update workload balance doc per review comments

Browse Source 
The original documentation update review [1]
had some additional comments for improvements.
The commit adds the suggested changes.

[1] https://review.opendev.org/c/openstack/watcher/+/951025

Change-Id: I4b4624e2dbc4c6a5f888ec77d6a03b8f66ff0a23
This commit is contained in:
Ronelle Landy
2025-06-27 16:46:17 -04:00
parent 76de167171
commit 56d0a0d6ea
1 changed files with 22 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
doc/source/strategies/workload_balance.rst
View File

@@ -14,7 +14,7 @@ Synopsis
Metrics Metrics
******* *******
The *workload_balance* strategy requires the following metrics: The ``workload_balance`` strategy requires the following metrics:
======================= ============ ======= =========== ====================== ======================= ============ ======= =========== ======================
metric service name plugins unit comment metric service name plugins unit comment
@@ -29,17 +29,17 @@ metric service name plugins unit comment
.. _ceilometer: https://docs.openstack.org/ceilometer/latest/admin/telemetry-measurements.html#openstack-compute .. _ceilometer: https://docs.openstack.org/ceilometer/latest/admin/telemetry-measurements.html#openstack-compute
**Notes** .. note::
* The parameters above reference the instance CPU or RAM usage, but
* The parameters above reference the instance CPU or RAM usage, but the threshold calculation is based of the CPU/RAM usage on the
the threshold calculation is based of the CPU/RAM usage on the hypervisor. hypervisor.
* The RAM usage can be calculated based on the RAM consumed by the instance, * The RAM usage can be calculated based on the RAM consumed by the instance,
and the available RAM on the hypervisor. and the available RAM on the hypervisor.
* The CPU percentage calculation relies on the CPU load, but also on the number * The CPU percentage calculation relies on the CPU load, but also on the
of CPUs on the hypervisor. number of CPUs on the hypervisor.
* The memory host metric is calculated by summing the RAM usage of each * The host memory metric is calculated by summing the RAM usage of each
instance on the host. This measure is close to the real usage, but is not instance on the host. This measure is close to the real usage, but is
the exact usage on the host. not the exact usage on the host.
Cluster data model Cluster data model
****************** ******************
@@ -77,7 +77,7 @@ Strategy parameters are:
================ ====== ==================== ================================== ================ ====== ==================== ==================================
parameter type default value description parameter type default value description
================ ====== ==================== ================================== ================ ====== ==================== ==================================
``metrics`` String 'instance_cpu_usage' Workload balance base on cpu or ``metrics`` String instance_cpu_usage Workload balance base on cpu or
ram utilization. Choices: ram utilization. Choices:
['instance_cpu_usage', ['instance_cpu_usage',
'instance_ram_usage'] 'instance_ram_usage']
@@ -111,19 +111,19 @@ to: https://specs.openstack.org/openstack/watcher-specs/specs/mitaka/implemented
How to use it ? How to use it ?
--------------- ---------------
Create and audit template using the Workload Balancing strategy. Create an audit template using the Workload Balancing strategy.
.. code-block:: shell .. code-block:: shell
$ openstack optimize audittemplate create \ $ openstack optimize audittemplate create \
at1 workload_balancing --strategy workload_balance at1 workload_balancing --strategy workload_balance
Run an audit using the Workload Balance strategy where Run an audit using the Workload Balance strategy. The result of
the aim is to get a plan to move VMs from any host where the the audit should be an action plan to move VMs from any host
CPU usage is over the threshold of 26%, to a host where the where the CPU usage is over the threshold of 26%, to a host
utilization of CPU is under the threshold. where the utilization of CPU is under the threshold.
The measurements of CPU utilization are taken from Ceilometer The measurements of CPU utilization are taken from the configured
with an aggregate period of 310. datasouce plugin with an aggregate period of 310.
.. code-block:: shell .. code-block:: shell
@@ -132,8 +132,8 @@ with an aggregate period of 310.
Run an audit using the Workload Balance strategy to Run an audit using the Workload Balance strategy to
obtain a plan to balance VMs over hosts with a threshold of 20%. obtain a plan to balance VMs over hosts with a threshold of 20%.
In this case, the stipulation of the Ceilometer CPU utilization In this case, the stipulation of the CPU utilization metric
metric measurement is a combination of period and granularity. measurement is a combination of period and granularity.
.. code-block:: shell .. code-block:: shell