Page last updated:
This topic describes how to upgrade to Healthwatch for VMware Tanzu v2.1 and lists the major differences between Pivotal Healthwatch v1 and Healthwatch v2.1.
Healthwatch v2.1 uses the open-source components Prometheus, Grafana, and Alertmanager to scrape, store, and view metrics, as well as configure alerts. This architecture is entirely different from the architecture of Pivotal Healthwatch v1. Because of this, you must install Healthwatch v2.1 as a new tile.
For more information about the differences between Healthwatch v2.1 and Pivotal Healthwatch v1, see Differences Between Healthwatch v2.1 and Pivotal Healthwatch v1 below.
To upgrade to Healthwatch v2.1 from Pivotal Healthwatch v1, see Upgrade to Healthwatch v2.1 below.
The following table explains the most significant differences between Healthwatch v2.1 and Pivotal Healthwatch v1:
|Feature||Difference Between Versions|
|Monitoring multiple Ops Manager foundations||
|Certificate expiration monitoring||
In addition to the updated features described in the table above, Healthwatch v2.1 includes the following new features:
Runs a suite of service level indicator (SLI) tests to test the functionality of the TKGI API and collects metrics from those tests in the TKGI Control Plane dashboard in the Grafana UI. For more information, see TKGI SLI Exporter VM in Healthwatch Metrics.
Separates Diego capacity metrics by isolation segment in the Diego/Capacity dashboard in the Grafana UI.
The Jobs and Job Details dashboards in the Grafana UI no longer display metrics from BOSH smoke test deployments.
Allows you to include optional dashboards for the VMware Tanzu RabbitMQ for VMs (Tanzu RabbitMQ) and VMware Tanzu SQL with MySQL for VMs (Tanzu SQL for VMs) tiles in the Grafana UI.
Allows you to monitor super value metrics (SVMs) that are similar to the super metrics generated in Pivotal Healthwatch v1.8 and earlier. For more information about SVMs, see Configure Prometheus in Configuring Healthwatch, SVM Forwarder VM - Healthwatch Component Metrics in Healthwatch Metrics, and SVM Forwarder VM - Platform Metrics in Healthwatch Metrics.
Automatically detects which version of TAS for VMs or TKGI is installed on your Ops Manager foundation and creates the appropriate dashboard in the Grafana UI.
Allows you to use the Ops Manager syslog forwarding feature to forward log messages from Healthwatch component VMs to an external destination for troubleshooting, such as a remote server or external syslog aggregation service. For more information about how to configure syslog forwarding, see (Optional) Configure Syslog in Configuring Healthwatch.
For more information about Healthwatch v2.1 features, see Healthwatch v2.1 Release Notes.
The architecture of Healthwatch v2.1 is entirely different from the architecture of Pivotal Healthwatch v1. Because of this, you must install and configure Healthwatch v2.1 as a new tile even if you are upgrading from Pivotal Healthwatch v1. However, if you still rely on metrics from Pivotal Healthwatch v1, you can keep Pivotal Healthwatch v1 installed and use it concurrently with Healthwatch v2.1 while you transition to Healthwatch v2.1.
To upgrade to Healthwatch v2.1:
Review the limitations and risks of using of Healthwatch v2.1. For more information about the limitations of Healthwatch v2.1, see Healthwatch v2.1 Limitations in Healthwatch. For more information about the risks of using Healthwatch v2.1, see Assumed Risks of Using Healthwatch v2.1 in Healthwatch.
Review the configuration options for Healthwatch v2.1 to determine which tiles you must install on your Ops Manager foundations. For more information, see Configuration Options in Healthwatch Architecture.
Install the Healthwatch v2.1 tile and Healthwatch Exporter tiles on the Ops Manager foundations you want to monitor according to the configuration you identified in the previous step, even if you have the Pivotal Healthwatch v1 tile installed already. For more information about installing the Healthwatch v2.1 tile and Healthwatch Exporter tiles, see Installing a Tile Manually or Installing, Configuring, and Deploying a Tile Through an Automated Pipeline.
Configure the Healthwatch component VMs through the Healthwatch v2.1 tile and Healthwatch Exporter tile UIs in the Ops Manager Installation Dashboard and deploy the tiles. For more information about configuring and deploying the tiles, see Configuring Healthwatch, Configuring Healthwatch Exporter for TAS for VMs, and Configuring Healthwatch Exporter for TKGI.
When you no longer need to use Pivotal Healthwatch v1, delete the Pivotal Event Alerts tile from your Ops Manager foundations. Then, delete the Pivotal Healthwatch v1 tile from your Ops Manager foundations.
Warning: You must delete the Pivotal Event Alerts tile before you delete the Pivotal Healthwatch v1 tile. If you delete the Pivotal Healthwatch v1 tile first, an error prevents you from deleting the Pivotal Event Alerts tile, and you must re-add the Pivotal Healthwatch v1 tile to delete the Pivotal Event Alerts tile.For more information about deleting tiles, see the Ops Manager documentation.