starlingx/docs
Code Issues Proposed changes

Configure collectd to store host performance data

Browse Source 
Continuation of https://review.opendev.org/c/starlingx/docs/+/819157 based on PV
inputs.
Minor change to command format port/host enumeration.

Story: 2009018
Task: 43991

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I26c2332321d03c2498a1cec3c398890933806e5d
This commit is contained in:
Ron Stone 2021-12-13 14:02:04 -05:00
parent c57acadd8b
commit fe5c60167b
1 changed files with 141 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

136
doc/source/system_configuration/kubernetes/configure-collectd-to-store-host-performance-data-caf7802851bc.rst
View File

@ -55,7 +55,7 @@ Add collectd configuration parameters
.. code-block:: none .. code-block:: none
platform collectd network_servers=<host>:<port>,<host>:<port>,...,<hostN>:<portN> system service-parameter-add platform collectd network_servers=<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>
where: where:
@ -118,15 +118,51 @@ Add collectd configuration parameters
| 3346bec7... | radosgw | config | service_enabled | false | None | None | | 3346bec7... | radosgw | config | service_enabled | false | None | None |
+-------------+------------+----------+-----------------+--------------------------+-------------+----------+ +-------------+------------+----------+-----------------+--------------------------+-------------+----------+
#. Lock and unlock the controller to have your changes take effect: #. (AIO-SX only) Lock and unlock the controller to have your changes take
effect:
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system host-lock controller-0 ~(keystone_admin)]$ system host-lock controller-0
~(keystone_admin)]$ system host-unlock controller-0 ~(keystone_admin)]$ system host-unlock controller-0
#. (AIO-DX or Standard systems) Lock and unlock controller-1.
.. code-block:: none
~(keystone_admin)]$ system host-lock controller-1
~(keystone_admin)]$ system host-unlock controller-1
This step can take up to 10 minutes. This step can take up to 10 minutes.
#. Make controller-1 active.
.. code-block::
~(keystone_admin)]$ system host-swact controller-0
#. Log in to controller-1.
#. Lock and unlock controller-0.
.. code-block::
~(keystone_admin)]$ system host-lock controller-1
~(keystone_admin)]$ system host-unlock controller-1
This step can take up to 10 minutes.
#. Set controller-0 as the active controller.
Swact to controller-0.
.. code-block::
~(keystone_admin)]$ system host-swact controller-1
This step can take up to 10 minutes.
Edit collectd configuration parameters Edit collectd configuration parameters
====================================== ======================================
@ -144,17 +180,17 @@ existing collectd configuration.
~(keystone_admin)]$ system service-parameter-modify platform collectd network_servers=192.168.1.200:25000,influxdb-host:25826 ~(keystone_admin)]$ system service-parameter-modify platform collectd network_servers=192.168.1.200:25000,influxdb-host:25826
+-------------+--------------------------------------+ +-------------+-----------------------------------------+
| Property | Value | | Property | Value |
+-------------+--------------------------------------+ +-------------+-----------------------------------------+
| uuid | 69553a96-1f73-4e7c-8fd0-1235c0aa1771 | | uuid | 69553a96-1f73-4e7c-8fd0-1235c0aa1771 |
| service | platform | | service | platform |
| section | collectd | | section | collectd |
| name | network_servers | | name | network_servers |
| value | 192.168.1.200:25000,controller:25826 | | value | 192.168.1.200:25000,influxdb-host:25826 |
| personality | None | | personality | None |
| resource | None | | resource | None |
+-------------+--------------------------------------+ +-------------+-----------------------------------------+
#. |optional| Persist the new parameter: #. |optional| Persist the new parameter:
@ -162,13 +198,52 @@ existing collectd configuration.
~(keystone_admin)]$ system service-parameter-apply platform ~(keystone_admin)]$ system service-parameter-apply platform
#. Lock and unlock the controller to have your changes take effect: #. (AIO-SX only) Lock and unlock the controller to have your changes take
effect:
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system host-lock controller-0 ~(keystone_admin)]$ system host-lock controller-0
~(keystone_admin)]$ system host-unlock controller-0 ~(keystone_admin)]$ system host-unlock controller-0
#. (AIO-DX or Standard systems) Lock and unlock controller-1.
.. code-block:: none
~(keystone_admin)]$ system host-lock controller-1
~(keystone_admin)]$ system host-unlock controller-1
This step can take up to 10 minutes.
#. Make controller-1 active.
.. code-block::
~(keystone_admin)]$ system host-swact controller-0
#. Log in to controller-1.
#. Lock and unlock controller-0.
.. code-block::
~(keystone_admin)]$ system host-lock controller-1
~(keystone_admin)]$ system host-unlock controller-1
This step can take up to 10 minutes.
#. Set controller-0 as the active controller.
Swact to controller-0.
.. code-block::
~(keystone_admin)]$ system host-swact controller-1
This step can take up to 10 minutes.
This step can take up to 10 minutes. This step can take up to 10 minutes.
Remove collectd configuration parameters Remove collectd configuration parameters
@ -186,12 +261,12 @@ existing collectd configuration.
~(keystone_admin)]$ system service-parameter-list ~(keystone_admin)]$ system service-parameter-list
+--------------------------------------+------------+----------+-----------------+-----------------------+-------------+----------+ +--------------------------------------+------------+----------+-----------------+--------------------------+-------------+----------+
| uuid | service | section | name | value | personality | resource | | uuid | service | section | name | value | personality | resource |
+--------------------------------------+------------+----------+-----------------+-----------------------+-------------+----------+ +--------------------------------------+------------+----------+-----------------+--------------------------+-------------+----------+
| 17d024d1-55d3-4bc9-a490-2eda6e19e6d1 | horizon | auth | lockout_retries | 3 | None | None | | 17d024d1-55d3-4bc9-a490-2eda6e19e6d1 | horizon | auth | lockout_retries | 3 | None | None |
| bf3cefdb-3b27-4dd0-aa77-47f362a23db2 | horizon | auth | lockout_seconds | 300 | None | None | | bf3cefdb-3b27-4dd0-aa77-47f362a23db2 | horizon | auth | lockout_seconds | 300 | None | None |
| 69553a96-1f73-4e7c-8fd0-1235c0aa1771 | platform | collectd | network_servers | controller:25826,192. | None | None | | 69553a96-1f73-4e7c-8fd0-1235c0aa1771 | platform | collectd | network_servers | influxdb-host:25826,192. | None | None |
| | | | | 168.1.123:25826 | | | | | | | | 168.1.123:25826 | | |
| | | | | | | | | | | | | | | |
| d574763b-e90b-4cca-a577-03269f1fc473 | radosgw | config | fs_size_mb | 25 | None | None | | d574763b-e90b-4cca-a577-03269f1fc473 | radosgw | config | fs_size_mb | 25 | None | None |
@ -199,7 +274,7 @@ existing collectd configuration.
| 1bbdb378-a1d6-4eb0-b210-73d573954b8d | http | config | https_port | 8443 | None | None | | 1bbdb378-a1d6-4eb0-b210-73d573954b8d | http | config | https_port | 8443 | None | None |
| 8dc30732-b617-4ddd-aa97-69edd25e4075 | kubernetes | config | pod_max_pids | 10000 | None | None | | 8dc30732-b617-4ddd-aa97-69edd25e4075 | kubernetes | config | pod_max_pids | 10000 | None | None |
| 3346bec7-3b57-4f21-a571-24d39f27dd0b | radosgw | config | service_enabled | false | None | None | | 3346bec7-3b57-4f21-a571-24d39f27dd0b | radosgw | config | service_enabled | false | None | None |
+--------------------------------------+------------+----------+-----------------+-----------------------+-------------+----------+ +--------------------------------------+------------+----------+-----------------+--------------------------+-------------+----------+
In this example, the |UUID| for collectd is ``69553a96-1f73-4e7c-8fd0-1235c0aa1771``. In this example, the |UUID| for collectd is ``69553a96-1f73-4e7c-8fd0-1235c0aa1771``.
@ -229,11 +304,48 @@ existing collectd configuration.
Note that collectd is no longer listed in the :guilabel:`section` column. Note that collectd is no longer listed in the :guilabel:`section` column.
#. Lock and unlock the controller to have your changes take effect: #. (AIO-SX only) Lock and unlock the controller to have your changes take
effect:
.. code-block:: none .. code-block:: none
~(keystone_admin)]$ system host-lock controller-0 ~(keystone_admin)]$ system host-lock controller-0
~(keystone_admin)]$ system host-unlock controller-0 ~(keystone_admin)]$ system host-unlock controller-0
#. (AIO-DX or Standard systems) Lock and unlock controller-1.
.. code-block:: none
~(keystone_admin)]$ system host-lock controller-1
~(keystone_admin)]$ system host-unlock controller-1
This step can take up to 10 minutes. This step can take up to 10 minutes.
#. Make controller-1 active.
.. code-block::
~(keystone_admin)]$ system host-swact controller-0
#. Log in to controller-1.
#. Lock and unlock controller-0.
.. code-block::
~(keystone_admin)]$ system host-lock controller-1
~(keystone_admin)]$ system host-unlock controller-1
This step can take up to 10 minutes.
#. Set controller-0 as the active controller.
Swact to controller-0.
.. code-block::
~(keystone_admin)]$ system host-swact controller-1
This step can take up to 10 minutes.