VMware Skyline Health Diagnostics for vSphere - FAQ
search cancel

VMware Skyline Health Diagnostics for vSphere - FAQ

book

Article ID: 345059

calendar_today

Updated On:

Products

VMware vSphere ESXi

Issue/Introduction

This article provides answers to Frequently Asked Questions about VMware Skyline Health Diagnostics (SHD) for vSphere

Environment

VMware vSphere 7.0.x

Resolution

What is Skyline Health Diagnostics (SHD)?

  • VMware Skyline Health Diagnostics is a self-service tool that analyzes log bundles to detect issues and suggest relevant Knowledge Base articles or Steps to remediate in vSphere, vSAN, VMware Cloud Foundation and EUC products. vSphere Administrators can use this tool for troubleshooting issues, before contacting the Broadcom Support.
  • For more information, see Introducing VMware Skyline Health Diagnostic Tool

What is difference between Skyline Health Diagnostics and Skyline Advisor?

  • Skyline Advisor is a proactive analysis tool whereas Skyline Health Diagnostics is a log analysis tool that also performs health checks.
  • Skyline Advisor is web service tool hosted by VMware, whereas the Skyline Health Diagnostic tool is on-prem. solution and doesn’t require you to have a cloud account.
  • The VMware Skyline Advisor service will be reaching end of life on October 4th, 2024. After this time, the service will no longer be available for use.  Please see additional details in the FAQ - https://knowledge.broadcom.com/external/article/319011 
VMware Skyline Advisor VMware Skyline Health Diagnostics (SHD)
Proactive, Preventive: Alerts for Potential proactive issues Reactive & Proactive: analyses the issues and provided remediation steps - KBs, Action plans, also includes Pre-Checks for vCenter and VCF environments 
Typical use cases: Missing patches, best practices recommendation Typical use cases: Debugging PSODs or VMkernel Panic providing analysis, Troubleshooting Server Hang Scenarios, vCenter Services crashes, Proactively updating inputs on Security Advisories, Driver upgrade information, Enabling vCenter and VCF prechecks prior upgrade validating the environment 
Data is stored in VMware Cloud Data resides in-house; execution stats shared with VMware IF you are signed up for CEIP
Needs online internet connectivity with external portal Works Offline mode; no connectivity to external sites required useful for dark and isolated environments 


What is Customer Experience Improvement Program (CEIP)? 

  • Joining the CEIP with Skyline Health Diagnostics, the tool collects data related to feature usage and issues identified, without any personally identifiable items. This  program is purely voluntary and you can opt out anytime, simply by unchecking the box, when prompted during the initial configuration of the SHD appliance.
Note: CEIP is checked by default and can be unchecked during the time of initial config of the SHD appliance.
  • The VI-Admins or the cyber security experts in an organization can always check the Tool Usage Report which would provide detailed insight on what data is being collected by VMware SHD Tool. This report can be found by navigating to the SHD Admin login page > Click Settings > Help and Support > Tool Usage Report
This will download a complete report and will help you validate the data collected by VMware Skyline Heath Diagnostics
  • Skyline Health Diagnostics needs 443 and 80 outbound ports to broadcom.com:
  •  
  • If the CEIP is disabled on the SHD appliance, then customers can choose to download the ISO image from Broadcom website and update the SHD appliance. With every Monthly new release of the SHD versions, this will have latest VCG & vSAN database updates included.

What are the benefits of Skyline Health Diagnostics?

  • SHD can help perform diagnostics on the vCenter Appliance even if the Services are offline.
Note: SHD uses an SSH connection capture logs and perform analysis.
  • SHD can also perform diagnostics on ESXi Hosts that are either disconnect/not responding from vCenter Server Inventory using SSH access.
  • SHD can also gather Offline Health Diagnostics:
    • Environments in Dark site can install the Appliance on a Standalone ESXi Host to manually upload logs to the SHD appliance to perform analysis.
  • SHD performs the below diagnostics checks as of today:
    • VMware Security Advisory alerts based environment status
    • VMware Compatibility Health Checks hardware & vSAN
    • SHD performs log analysis based on 1800+ signatures to root cause issues and provide next steps or knowledge base articles
  • The SHD Report can be used for Audit and Documentation purpose for any reported issue in the environment. 
  • The Security team or administrator can validate if the environment is up to date with the available VMware Security Advisories.
  • SHD also provides vCenter and VCF precheck capabilities, which can be driven prior upgrades, thus enabling smoother upgrades.
  • SHD tool is also used by the VMware Global Support team internally too root cause issues.

What are the different Products supported by SHD?

  • vSphere 6.5, 6.7, 7.0.x and vSphere 8.0.x are supported by Skyline Health Diagnostics
  • VMware Cloud Foundation 4.x & 5.x
  • vSAN 
  • VMware Horizon
  • VMware SD-WAN in Tech Preview mode only 
  • VMware Cloud Gateway

Where can I download the Photon OS from, to deploy Skyline Health Diagnostics ?

Where can I get more information regarding installation?

  • What's New in Skyline Health Diagnostics 4.0
 

Where can I download Skyline Health Diagnostics ISO image from ?

What are the Minimum Requirements to Deploy Skyline Health Diagnostics?

Software Requirements

  • Esxi installed with either vSphere 6.5, 6.7, 7.0 and vSphere 8.0

Hardware requirements 

  • 4 vCPUs
  • 16 GB RAM
  • 250 GB hard disk
  • A port group with network connectivity, for accessing this virtual machine from your workstation

How do I manually set the IP address to the Photon OS 

  • Use the below link to assign Manual IP address to the Photon OS

How does SHD save time and resources to resolve issues?

  • SHD provides instant resolution for known issues seen by VMware support – currently the success rate of the tool is around 48%
  • This saves lot of time and resources in engaging with support, providing info, uploading log files etc.
  • Helps with stability and availability of the environment due to quicker resolution of known issues
  • When engaging with support, availability of SHD log file will dramatically cut down resolution time as good amount of info required for troubleshooting is already captured in the SHD log file

How often are new releases available?

  • Monthly signatures and recent issues are updated

What are the available support channels for issues with SHD tool?

Is there any cost / licensing associated with SHD?

  • The product is free at this time

Will SHD tool be expanded to other products?

  • VMware Engineering is committed that SHD product is evolving to expand covering other products with additional functionality and coverage. The goal is to have a Single unified Diagnostics solution tool across multiple product portfolios 

How can I provide feedback about this tool?

How can I upgrade SHD if its being used in an Offline mode

The below is applicable for older versions prior to SHD 3.5 only

  • Download the VMware Skyline Health Diagnostics latest version ISO from the Drivers & Tools section of VMware vSphere in the Broadcom Support Portal
  • Attach the ISO image to the SHD Appliance 
  • To mount the attached ISO run mount /dev/cdrom /mnt/cdrom 
  • Execute the script "sh /mnt/cdrom/install.sh"

The latest version of SHD 4.0 released does not have a Offline Upgrade option, since the version SHD 4.0 is a major release, So ideal way approach is to deploy a new SHD 4.0 Appliance directly

How can you opt out of CEIP?

  • You can choose the LEAVE PROGRAM option in the Settings Tab to disconnect from CEIP, click on "JOINED" button will show the below option to Leave the CEIP
 

How can customer rejoin the CEIP?

  • You can choose to join the CEIP and enable this post confirming from your internal Security team approval, the option in the Settings Tab to Join Program in CEIP which is available.