vmware-cloud-foundation-health-monitoring 2.2.0.1003

Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations

Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations

        

Table of Contents

• Python Module for VMware Cloud Foundation Health Monitoring in VMware Aria Operations
  • Table of Contents
  • Introduction
  • Requirements
    • Platforms
    • Operating Systems
    • Python Version
    • Python Libraries
    • PowerShell Editions and Versions
    • PowerShell Modules
  • Implementation
  • Install the Python Module in a Disconnected Environment
    • For Photon OS
    • For Windows Server
  • Updating the Python Module to the Latest Version
    • For Photon OS
    • For Windows Server
  • VMware Aria Operations Dashboards Preview
  • Known Issues
  • Support
  • License

Introduction

This content supports the Health Reporting and Monitoring for VMware Cloud Foundation validated solution which enables the user to monitor the operational state of your VMware Cloud Foundation environment through custom dashboards, alerts, and notifications. These custom dashboards are intended to serve as an extension to native VMware Aria Operations dashboards and dashboards that are enabled using the respective management packs.

Requirements

Platforms

• VMware Cloud Foundation 5.2
• VMware Cloud Foundation 5.1
• VMware Cloud Foundation 5.0
• VMware Cloud Foundation 4.5

Operating Systems

• Microsoft Windows Server 2019 and 2022
• VMware Photon OS 3.0 and 4.0

Python Version

• Python 3.x

Follow the Python Beginners Guide to download and install Python.

Python Libraries

Install required Python libraries by running the following commands on the host virtual machine:

pip install requests
pip install setuptools
pip install paramiko
pip install maskpass==0.3.1

PowerShell Editions and Versions

• PowerShell Core 7.2.0 or later

PowerShell Modules

• PowerShell Module for VMware Cloud Foundation Reporting - latest version

Implementation

Follow the Implementation of Health Reporting and Monitoring for VMware Cloud Foundation from Health Reporting and Monitoring for VMware Cloud Foundation

Install the Python Module in a Disconnected Environment

For disconnected environments (e.g., dark-site, air-gapped), you can save the Health Reporting and Monitoring Python module and its dependencies from the PyPI using the below instructions.

For Photon OS

• On the target system, create a directory to save the Python modules

  mkdir -p /opt/vmware/hrm-modules
  

• From a system with an Internet connection, make a modules directory and create a new file requirements.txt inside it.

  mkdir -p /home/hrm-modules/
  cd /home/hrm-modules/
  vi requirements.txt
  

• Add below content to the requirements.txt file and save it.

  requests
  setuptools
  paramiko
  maskpass==0.3.1
  

• Create another file module.txt in the same location.

  vi module.txt
  

• Add below content to the module.txt file and save it.

  vmware-cloud-foundation-health-monitoring
  

• From a system with an Internet connection, save the module and its dependencies from PyPI by running the following commands in the terminal:

  pip download -r module.txt
  pip download -r requirements.txt
  

• From the system with an Internet connection, copy the module and its dependencies to a target system by running the following commands in the terminal:

  scp -r /home/vcf/hrm-modules/* username@remote_host:/opt/vmware/hrm-modules/
  

• On the target system, install the module and its dependencies by running the following commands in the terminal:

  cd /opt/vmware/hrm-modules
  pip install -r requirements.txt --no-index --find-links .
  pip install -r module.txt --no-index --find-links . -t /opt/vmware/hrm-<sddc_manager_vm_name>
  

For Windows Server

• From a system with an Internet connection, make a modules folder F:\hrm-modules.

• Create a new file requirements.txt inside the modules folder.

• Add the below content to the requirements.txt file and save it.

  requests
  setuptools
  paramiko
  maskpass==0.3.1
  

• In the modules folder f:\hrm-modules, create a new file module.txt

• Add below content to module.txt file and save it.

  vmware-cloud-foundation-health-monitoring
  

• From a system with an Internet connection, save the module and its dependencies from PyPI by running the following commands from cmdline:

  cd f:\hrm-modules
  pip download -r module.txt 
  pip download -r requirements.txt
  

• From the system with the Internet connection, copy the module and its dependencies to a target system by running the following commands in the PowerShell console:

  Copy-Item -Path F:\hrm-modules\* -Destination '\\<destination_host>\C$\vmware\hrm-modules
  

• On the target system, install the module and its dependencies by running the following commands in the terminal:

  cd c:\vmware\hrm-modules
  pip install -r requirements.txt --no-index --find-links .
  pip install -r module.txt --no-index --find-links . -t c:\vmware\hrm-<sddc_manager_vm_name>
  

Once the Python modules are installed, continue to follow the Implementation of Health Reporting and Monitoring for VMware Cloud Foundation from Health Reporting and Monitoring for VMware Cloud Foundation

Updating the Python Module to the Latest Version

For Photon OS

• Log in to the host virtual machine at <host_virtual_machine_fqdn>:22 as the root user by using a Secure Shell (SSH) client.

• Update the Python Module for Health Reporting and Monitoring in VMware Aria Operations.

  pip install vmware-cloud-foundation-health-monitoring --target=/opt/vmware/hrm-<sddc_manager_vm_name> --upgrade
  

• Provide execute permissions to the files in the hrm-<sddc_manager_vm_name> directory.

  chmod -R 755 /opt/vmware/hrm-<sddc_manager_vm_name>
  

• Switch to the hrm-<sddc_manager_vm_name>/main directory.

  cd /opt/vmware/hrm-<sddc_manager_vm_name>/main
  

• Edit the env.json file and configure the values according to your VMware Cloud Foundation Planning and Preparation Workbook.

  vi env.json
  

• Encrypt the service account passwords.

  python encrypt-passwords.py
  

• Enter the password for the VMware Aria Operations service account.

• Enter the password for the SDDC Manager service account.

• Enter the password for the SDDC Manager appliance local user.

• Repeat this procedure for each VMware Cloud Foundation instance.

For Windows Server

• Log in to the host virtual machine at <host_virtual_machine_fqdn> as the Administrator user by using a Remote Desktop Connection (RDC) client and open a PowerShell console.

• Start Windows Command Prompt.

• Update the Python Module for Health Reporting and Monitoring in VMware Aria Operations.

  pip install vmware-cloud-foundation-health-monitoring --target=C:\vmware\hrm-<sddc_manager_vm_name>\ --upgrade
  

• Change to the hrm-<sddc_manager_vm_name>\main folder.

  cd c:\vmware\hrm-<sddc_manager_vm_name>\main
  

• Edit the env.json file and configure the values according to your VMware Cloud Foundation Planning and Preparation Workbook.

  notepad env.json
  

• Encrypt the service account passwords.

  python encrypt-passwords.py
  

• Enter the password for the VMware Aria Operations service account.

• Enter the password for the SDDC Manager service account.

• Enter the password for the SDDC Manager appliance local user.

• Repeat this procedure for each VMware Cloud Foundation instance.

VMware Aria Operations Dashboards Preview

1. VCF Health Rollup

   

   

   

2. VCF Backup Health

   

3. VCF Certificate Health

   

   

4. VCF Compute Health

   

   

5. VCF Connectivity Health

   

   

6. VCF DNS Health

   

   

7. VCF Hardware Compatibility

   

   

8. VCF Networking Health

   

   

   

9. VCF NTP Health

   

   

10. VCF Password Health

    

    

11. VCF SDDC Manager and vCenter Services Health

    

    

12. VCF Snapshot Health

    

    

13. VCF Storage Health

    

    

    

14. VCF vSAN Health

    

    

15. VCF Version Health

    

Known Issues

1. Remove FQDN suffix dependency in the name when configuring an NSX-T cloud account in VMware Aria Operations

   Please make sure that your NSX-T account name is configured as mentioned in this issue.

2. The vCenter Server name needs to be updated in VMware Cloud Foundation 4.x. The filters on the VMware Aria Operations dashboards depend on the name.

   To set the Product Name for the vCenter Server, follow the below steps:

   1. Log in to the management domain vCenter Server at https://<management_vcenter_server_fqdn>/ui as [e-mail].
   2. In the VMs and templates inventory, expand the management domain vCenter Server tree and expand the management domain data center.
   3. Select the first management domain vCenter Server virtual machine and select Configure tab.
   4. In the Settings pane select vApp Options.
   5. Click the Edit button. The Edit vApp Options dialog box opens.
   6. If vApp options are disabled, select the Enable vApp options check box and click OK.
   7. Click the Details tab and enter VMware vCenter Server Appliance as product name in the Name field.

3. Shades of red, green, and yellow may vary on VMware Aria Operations widgets

   Shades of red, green, and yellow may be different in different widgets but they represent the same thing. Ignore the shades as this is a VMware Aria Operations product limitation.

Support

This Python module is not supported by VMware Support Services.

We welcome you to use the GitHub Issues to report bugs or suggest enhancements.

In order to have a good experience with our community, we recommend that you read the contributing guidelines.

When filing an issue, please check existing open, or recently closed, issues to make sure someone else hasn't already reported the issue.

Please try to include as much information as you can. Details like these are incredibly useful:

• A reproducible test case or series of steps.
• Any modifications you've made relevant to the bug.
• Anything unusual about your environment or deployment.

License

Copyright 2023-2024 Broadcom. All Rights Reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.