starlingx/docs
Code Issues Proposed changes
docs/doc/source/dist_cloud/kubernetes/cli-commands-for-dc-alarms-management.rst
Elisamara Aoki Gonçalves 46630063f4 Distributed Cloud review updates/upgrades - draft (r10,dsR10) 
Fix updates and upgrades in distributed cloud guide
Review of the Distributed Cloud Guide to adjust to USM
Fix merge conflict https://review.opendev.org/c/starlingx/docs/+/937086
Fix merge conflict with https://review.opendev.org/c/starlingx/docs/+/937352
Created Horizon Section for Orchestrate Subcloud Prestage

Change-Id: I8b288e35ec76fcbc11ccbe7715aefff70722094d
Signed-off-by: Elisamara Aoki Gonçalves <elisamaraaoki.goncalves@windriver.com>
2025-01-30 21:35:14 +00:00

4.5 KiB
Raw Blame History

CLI Commands for Distributed Cloud Alarm Management

You can use the CLI to review alarm summaries for the .

  • To show the status of all subclouds, as well as a summary count of alarms and warnings for each one, use the alarm summary command.

    For example:

    ~(keystone_admin)$ dcmanager alarm summary
+------------+-----------------+--------------+--------------+----------+----------+
| NAME       | CRITICAL_ALARMS | MAJOR_ALARMS | MINOR_ALARMS | WARNINGS | STATUS   |
+------------+-----------------+--------------+--------------+----------+----------+
| subcloud-5 |               0 |            2 |            0 |        0 | degraded |
| subcloud-1 |               0 |            0 |            0 |        0 | OK       |
+------------+-----------------+--------------+--------------+----------+----------+

    System Controller alarms and warnings are not included.

    The status is one of the following:

    OK

    There are no alarms or warnings, or only warnings.

    degraded

    There are minor or major alarms.

    critical

    There are critical alarms.

  • To show the count of alarms and warnings for the System Controller, use the fm alarm-summary command.

    For example:

    ~(keystone_admin)$ fm alarm-summary
+-----------------+--------------+--------------+----------+
| Critical Alarms | Major Alarms | Minor Alarms | Warnings |
+-----------------+--------------+--------------+----------+
| 0               | 0            | 0            | 0        |
+-----------------+--------------+--------------+----------+

    The following command is equivalent to the fm alarm-summary, providing a count of alarms and warnings for the System Controller:

    fm --os-region-name RegionOne alarm-summary

  • To show the alarm and warning count for a specific subcloud only, add the --os-region-name parameter and supply the region name:

    For example:

    ~(keystone_admin)$ fm --os-region-name 829881a8077d4a1f997efd30611cf0ab --os-auth-url https://192.168.121.2:5000/v3 --os-endpoint-type public alarm-summary
+-----------------+--------------+--------------+----------+
| Critical Alarms | Major Alarms | Minor Alarms | Warnings |
+-----------------+--------------+--------------+----------+
| 0               | 0            | 0            | 0        |
+-----------------+--------------+--------------+----------+

    Note

    829881a8077d4a1f997efd30611cf0ab is the subcloud region name and it can be retrieved by using the dcmanager subcloud show <subcloud_name/subcloud_id> command. 192.168.121.2 is the external_oam_floating_address of the subcloud.

  • To list the alarms for a subcloud:

    ~(keystone_admin)$ fm --os-region-name 829881a8077d4a1f997efd30611cf0ab --os-auth-url https://192.168.121.2:5000/v3 --os-endpoint-type public alarm-list
+----------+--------------------------------------------+-------------------+----------+-------------------+
| Alarm ID | Reason Text                                | Entity ID         | Severity | Time Stamp        |
+----------+--------------------------------------------+-------------------+----------+-------------------+
| 250.001  | controller-0 Configuration is out-of-date. | host=controller-0 | major    | 2018-02-06T21:37: |
|          |                                            |                   |          | 32.650217         |
|          |                                            |                   |          |                   |
| 250.001  | controller-1 Configuration is out-of-date. | host=controller-1 | major    | 2018-02-06T21:37: |
|          |                                            |                   |          | 29.121674         |
|          |                                            |                   |          |                   |
+----------+--------------------------------------------+-------------------+----------+-------------------+