Care Systems Analytics for Epic Users Guide VMware Management Pack for vRealize Operations Manager and vCenter Operations Manager
This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
EN-001463-01
Care Systems Analytics for Epic Users Guide
You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to:
[email protected]
Copyright © 2014-2015 VMware, Inc. All rights reserved. Copyright and trademark information
VMware, Inc. 3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com
2
VMware, Inc.
Contents
About This Book
5
Introduction to Care Systems Analytics for Epic
7
Care Systems Analytics for Epic in vRealize Operations Manager and vCenter Operations Manager 7 Operations Manager Features 8 Operations Manager Concepts 9 Collecting Data 9 Analyzing Data 10 Accessing Care Systems Analytics for Epic 10 Epic Components Monitored in Care Systems Analytics 12
Monitoring with Care Systems Analytics for Epic
13
Log In to the vRealize Operations Manager User Interface 13 Log In to the vCenter Operations Manager Custom User Interface 13 Monitor Day‐to‐Day Operations 14 Care Systems Analytics for Epic Dashboards 14 Epic Overall Health Dashboard 14 Epic Drilldown Dashboard 15 Epic Troubleshooting Dashboard 16 Epic Printing Health Dashboard 17 Review Overall Health Indicators 18 Review Health Root Cause Detail in vRealize Operations Manager 19 Review Health Root Cause Detail in vCenter Operations Manager 19 Troubleshoot Decreased Health in vRealize Operations Manager 20 Troubleshoot Decreased Health in vCenter Operations Manager 21
Advanced Working with Dashboard Widgets
25
Custom Relationship Widget 25 Configure the Custom Relationship Widget 26 Application Detail Overview Widget in vCenter Operations Manager 27 Configure the Application Detail Widget 28 Health Status Widget 28 Configure the Health Status Widget in vRealize Operations Manager 29 Configure the Health Status Widget in vCenter Operations Manager 30 Health Tree Widget in vCenter Operations Manager 31 Configure the Health Tree Widget 32 Root Cause Ranking Widget in vCenter Operations Manager 33 Configure the Root Cause Ranking Widget 34 Heat Map Widget 34 Configure the Heat Map Widget 35
Troubleshooting Tips
39
Advanced Troubleshooting
41
View an Overview of Resource Health 41 Identify Health Problems for a Specific Resource 41 View Alerts on the Alerts Overview Page 42 VMware, Inc.
3
Care Systems Analytics for Epic Users Guide
Configure Alerts to Send Notifications 42 Send Alert Notifications to Users in Email Messages 43 Configure Email Alert Notifications 43 Configure Email Alert Handlers 43 Configure Attributes 44 Create an Attribute Package 44 Create a Super Metric Package 44 Set Dynamic Thresholds 46 Create a Super Metric 46 Create Tiered Health Trees 47 Edit Widget Resource Interaction Files 48 Show Specific Resources in a Dashboard 49
4
VMware, Inc.
About This Book
The Care Systems Analytics for Epic Users Guide describes how to use VMware vRealize Operations Manager and vCenter Operations Manager to monitor your Epic® system.
Intended Audience This information is intended for anyone who needs to use the Care Systems Analytics for Epic management pack. This information assumes you are experienced with vRealize Operations Manager or vCenter Operations Manager, Epic®, and Epic System Pulse. See VMware vCenter server and vRealize Operations Manager or vCenter Operations Manager documentation at: http://www.vmware.com/support/. See your Epic documentation, as needed.
VMware Technical Publications Glossary VMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions of terms as they are used in VMware technical documentation go to http://www.vmware.com/support/pubs.
Document Feedback VMware welcomes your suggestions for improving our documentation. If you have comments, send your feedback to
[email protected].
Technical Support and Education Resources The following sections describe the technical support resources available to you. To access the current version of this book and other books, go to http://www.vmware.com/support/pubs.
Online and Telephone Support To use online support to submit technical support requests, view your product and contract information, and register your products, go to http://www.vmware.com/support. Customers with appropriate support contracts should use telephone support for the fastest response on priority 1 issues. Go to http://www.vmware.com/support/phone_support.
Support Offerings To find out how VMware support offerings can help meet your business needs, go to http://www.vmware.com/support/services.
VMware, Inc.
5
Care Systems Analytics for Epic Users Guide
VMware Professional Services VMware Education Services courses offer extensive hands‐on labs, case study examples, and course materials designed to be used as on‐the‐job reference tools. Courses are available onsite, in the classroom, and live online. For onsite pilot programs and implementation best practices, VMware Consulting Services provides offerings to help you assess, plan, build, and manage your virtual environment. To access information about education classes, certification programs, and consulting services, go to http://www.vmware.com/services.
6
VMware, Inc.
1
Introduction to Care Systems Analytics for Epic
1
VMware® Care Systems Analytics for Epic is an IT management solution designed for healthcare organizations that use the Epic® platform. The solution extracts system information from the Epic System Pulse server and integrates it with VMware vRealize™ Operations Manager™ and vCenter™ Operations Manager to create a single view of system performance across the electronic medical record (EMR) platform and supporting infrastructure. Care Systems Analytics for Epic is a management pack that can be used with either the vRealize Operations Manager or vCenter Operations Manager. Both of the Operations Managers provide an intelligent operations management solution from VMware. The Care Systems Analytics for Epic solution improves visibility into the overall performance of the Epic system‐from infrastructure to the point of care. The solution includes dashboards to visualize and analyze performance indicators from the Caché environment, instances, hosts, Epic services on Windows hosts (Print, Interconnect, Clarity, and Relay), and related infrastructure (physical and virtual). This transparency increases collaboration across infrastructure, operations, and applications teams.
Care Systems Analytics for Epic in vRealize Operations Manager and vCenter Operations Manager VMware vRealize Operations Manager and vCenter Operations Manager help to reduce expensive and disruptive outages by providing greater insight into application, database, and infrastructure metrics. These Operations Managers use built‐in analytical widgets and patented self‐learning techniques to help anticipate and prevent potential problems, and quickly troubleshoot issues to resolution. Care Systems Analytics for Epic is a management pack that is installed in either the vRealize Operations Manager or vCenter Operations Manager. Data collected from the EpicCare for EMR systemʹs Epic System Pulse monitor flows into the vRealize Operations Manager or vCenter Operations Manager. NOTE For the purposes of this guide: When a description applies to both the vRealize Operations Manager and vCenter Operations Manager, the general term Operations Manager is used. When, appropriate, the specific Operations Manager is listed. The terms Management Pack, Adapter, and Solution are used interchangeably and generally apply to Care Systems Analytics for Epic use.
VMware, Inc.
7
Care Systems Analytics for Epic Users Guide
Figure 1-1. Flow of Care Systems Analytics for Epic with Epic System Pulse data into the Operations Manager.
Operations Manager Features NOTE Skip this section if you are already familiar with vRealize Operations Manager or vCenter Operations Manager features and concepts. The Operations Manager collects performance data from each object at every level of your virtual environment, from individual virtual machines and disk drives to entire clusters and data centers. It stores and analyzes the data, and uses that analysis to provide real‐time information about problems, or potential problems, anywhere in your virtual environment. The Operations Manager works with existing VMware products to add the following functionality:
8
Combines key metrics into single scores for environmental health, efficiency, and capacity risk.
Calculates the range of normal behavior for every metric and highlights abnormalities. Adjusts the dynamic thresholds as incoming data allows it to better define the normal values for a metric.
Presents graphical representations of current and historical states of your entire environment or selected parts of it.
VMware, Inc.
Chapter 1 Introduction to Care Systems Analytics for Epic
Figure 1-2. Sample Operations Manager Functions
Operations Manager Concepts To use Care Systems Analytics for Epic you need to understand the basic functions of the Operations Manager. See the VMware documentation specific to your Operations Manager at http://www.vmware.com/support/pubs. The Operations Manager uses certain concepts that can help you understand the product, its interface, and how to use it.
Collecting Data The Operations Manager collects several kinds of data for each inventory object. For example, for a virtual machine, the Operations Manager might receive data about free disk space, CPU load, and available memory. The following is a list of common objects you can view or manipulate.
Resources ‐ Solutions adapters, when loaded in to the Operations Manager, create a series of constructs to support the types of data collected and stored by the adapter. Resources are created as instances of the Resource Kind definition. For example, Resources of Resource Kind Virtual Machine could be vm123 or vm456.
Resource Tags ‐ A type of information, such as Application or GEO Location. Creating resource tags and tag values makes it easier to find resources and metrics in the Operations Manager. With resource tags, you select the tag value assigned to a resource and view the list of resources that are associated with that tag value.
Resource Kind ‐ Solutions adapters, when loaded in to the Operations Manager, create a series of constructs to support the types of data collected and stored by the adapter. Resources Kinds are created as definitions of object types. For example, a Resource Kind would be Virtual Machine or Host System.
Management Packs (Embedded Adapters) ‐ Gather and send information from resources to the Operations Manager for processing. These are Java components that run as plug‐ins in the Collector. They actively connect to a data source and pull values from it.
Adapter Instance ‐ Defines the type of adapter to use to connect to a particular data source. It also defines the information that is required to identify and access that data source. The Operations Manager administrator must define an adapter instance for each data source that uses an embedded adapter. An adapter instance definition typically includes the data access method and a host, port, and credential. The exact information in a particular adapter instance definition depends on the type of adapter.
Attributes ‐ Solutions adapters, when loaded in to the Operations Manager create a series of constructs to support the types of data collected and stored by the adapter. Attributes are created as definitions of data types of data points that can be collected by the Operations Manager. For example, the definition of data type Epic Caché Host : % Free Memory would be an attribute.
VMware, Inc.
9
Care Systems Analytics for Epic Users Guide
Metric ‐ An instance of an attribute for a specific resource. For example, Virtual Machine vm123 % Free Memory is a metric. The Operations Manager collects these metrics, which are stored as data points with their associated value and timestamp.
Metric Value ‐ A single data point, which is representative of a specific Resource, specific Attribute, specific timestamp and specific value.
Collect Cycle ‐ Each management pack has adapter instances defined to specify a data source to collect from using that management packʹs capabilities. These adapter instances have a default data collection interval of 5 minutes. This interval can be adjusted if necessary, however is not recommended.
Analyzing Data The Operations Manager performs analysis on the data collected.
Dynamic Thresholds ‐ The Operations Manager defines dynamic thresholds for every metric based on the current and historical values of the metric. The normal range of values for a metric can differ on different days at different times because of regular cycles of use and behavior. The Operations Manager tracks these normal value cycles and sets the dynamic thresholds accordingly. High metric values that are normal at one time might indicate potential problems at other times. For example, high CPU use on Friday afternoons, when weekly reports are generated, is normal. The same value on Sunday morning, when nobody is at the office, might indicate a problem. The Operations Manager continuously adjusts the dynamic thresholds. The new incoming data allows the Operations Manager to better define what value is normal for a metric. The dynamic thresholds add context to metrics that allow the Operations Manager to distinguish between normal and abnormal behavior. Dynamic thresholds eliminate the need for the manual effort required to configure hard thresholds for hundreds or thousands of metrics. More importantly, they are more accurate than hard thresholds. Dynamic thresholds allow the Operations Manager to detect deviations based on the actual normal behavior of an object and not on an arbitrary set of limits. The analytics algorithms take seven days to calculate the initial values for dynamic thresholds. Dynamic thresholds appear as line segments under the bar graphs for use metrics on the Details page and on the Scoreboard page. The length and the position of the dynamic threshold line segment depends on the calculated normal values for the selected use metrics. Dynamic thresholds also appear as shaded gray areas of the use metrics graphs on the All Metrics page.
Hard Thresholds ‐ Unlike dynamic thresholds, hard thresholds can be set to capture fixed metric values. Several progressive levels of criticality can be defined using different fixed values. These values must be set and maintained manually, however they can be helpful in highlighting best practices and known absolute values.
Key Performance Indicators (KPI) ‐ The Operations Manager defines attributes that are critical to the performance of an object as key performance indicators. KPI are weighted more heavily in the calculations that determine the health of an object. Graphs of KPI performance appear before other metrics in several areas of the product.
Alerts and Faults ‐ The Operations Manager generates alerts when events occur on the monitored objects, when data analysis indicates deviations from normal metric values, or when a problem occurs with one of the Operations Manager components. Events that the vCenter Server publishes are the main source for faults. These events might originate in the vCenter Server itself, or ESX servers might generate them and the vCenter Server publishes them externally. Only a subset of vCenter events are considered important for fault generation.
Accessing Care Systems Analytics for Epic Access and view Care Systems Analytics for Epic status, on vRealize Operations Manager, through the user interface, and on vCenter Operations Manager, through the Custom user interface. The user interface includes:
10
VMware, Inc.
Chapter 1 Introduction to Care Systems Analytics for Epic
Dashboards ‐ The tabs near the top of the Home page are your dashboards. For example, Epic Overall Health. The user groups to which you belong determine which dashboards are available to you. Operations Manager administrators assigns you to one or more user groups when they create your user account. To switch to a different dashboard click its tab or select it from the Dashboards menu. Click the Home tab at any time to return to your Home page.
Widgets ‐ The panes on a dashboard are called widgets. A widget is a collection of related information about attributes, resources, applications, or the overall processes in your environment. Each dashboard contains one or more widgets. For example, an Epic Overall Health dashboard might contain Epic Hierarchy, Workflow Heat Map, and Key Metrics for Epic Resources widgets. If your user account has the necessary access rights, you can customize dashboards and widgets. Use the Dashboard tab for an overview of the performance and condition of your infrastructure.
Figure 1-3. vRealize Operations Manager User Interface with Care Systems Analytics for Epic Dashboards
Figure 1-4. vCenter Operations Manager Custom User Interface with Care Systems Analytics for Epic Dashboards
Though the menus are slightly different between vRealize Operations Manager and vCenter Operations Manager, the widgets, badges, icons, and dashboards display similarly.
VMware, Inc.
11
Care Systems Analytics for Epic Users Guide
Epic Components Monitored in Care Systems Analytics The Care Systems Analytics for Epic management pack provides the connections between the Operations Manager and the Epic environment. The Epic environment includes:
Epic System Pulse ‐ Epicʹs tool for Epic application monitoring. It consolidates data collected from various resources into a single data repository. The Care Systems Analytics for Epic management pack uses Epic System Pulse to gather information about resources and metrics from the environment running Epic.
Caché ‐ The database that all transactions are processed on. This is represented using three resource types in the Operations Manager:
12
Caché Host ‐ Represents the host and reveals OS level metrics
Caché Instance ‐ Represents the database and reveals database metrics
Environment ‐ Represents the Epic Environment and reveals metrics about Workflows
Windows Services ‐ A few of the services comprising the Epic for EMR software run as Windows services. These are represented using four resource types in the Operations Manager:
Interconnect
Epic Print Service (EPS)
Epic Relay Service (Relay)
Windows Hosts ‐ The actual Windows machine hosting the above services and reveals OS level metrics
VMware, Inc.
2BBothe
Monitoring with Care Systems Analytics for Epic
2
Both vRealize Operations Manager or vCenter Operations Manager, and the Care Systems Analytics for Epic installed on it, are managed using the Administration portal which is a Web console for configuration and management tasks.
Log In to the vRealize Operations Manager User Interface Access to the Epic System Pulse monitoring data is through the vRealize Operations Manager user interface. Prerequisites
Verify that the Care Systems Analytics for Epic is installed in your vRealize Operations Manager. See the VMware documentation for the vRealize Operations Manager at http://www.vmware.com/support/pubs.
Verify that you are using a supported Web browser.
Procedure 1
In your Web browser, type the URL for the vRealize Operations Manager user interface. vcops https://
/
where is the IP address or fully qualified host name of the UI VM in vRealize Operations Manager. 2
Type your user name and password.
3
Click Login.
After you log in, the Home page appears in your browser window. NOTE If your session is inactive for 30 minutes, it times out and you must log in again.
Log In to the vCenter Operations Manager Custom User Interface Access to the Epic System Pulse monitoring data is through the vCenter Operations Manager Custom user interface. Prerequisites
Verify that the Care Systems Analytics for Epic is installed in your vCenter Operations Manager. See the VMware documentation for the vCenter Operations Manager at http://www.vmware.com/support/pubs.
Verify that you are using a supported Web browser.
Procedure 1
In your Web browser, type the URL for the Custom user interface. vcops
VMware, Inc.
13
Care Systems Analytics for Epic Users Guide
https:///vcops-custom/
where is the IP address or fully qualified host name of the UI VM in the vCenter Operations Manager vApp. vrops https://vrops-custom/ vrops-custom is the IP address or fully qualified host name of the UI VM in the vCenter Operations
Manager vApp. 2
Type your user name and password.
3
Click Login.
After you log in, the Home page appears in your browser window. NOTE If your session is inactive for 30 minutes, it times out and you must log in again.
Monitor Day-to-Day Operations Monitoring day‐to‐day operations involves evaluating the overall health of your enterprise and identifying health problems for specific resources. For each resource, the Operations Manager determines a health score, which is a 0 to 100 ranking. One of the ways that the Operations Manager indicates the health of a resource is to show a colored indicator. The color is based on the range of the health score. Table 2-1. Default Health Color Ranges COLOR
RANGE
Green
76 to 100
Yellow
51 to 75
Orange
26 to 50
Red
1 to 25
Blue
Blue is shown when a metric value is unknown, or ʺ?ʺ, or a resource is currently not collecting data through the Management Packʹs adapter instance.
Care Systems Analytics for Epic Dashboards Care Systems Analytics for Epic resource monitoring data is displayed in default Care Systems Analytics for Epic dashboards. NOTE It is recommended that the Operations Manager administrators identify and mark resources that are scheduled for regular maintenance. This ensures the Operations Manager does not generate an unnecessary alert‐because it interprets changes in metrics, that occur during the scheduled maintenance, as an anomaly.
Epic Overall Health Dashboard The Epic Overall Health dashboard displays overall view of the hierarchy of Epic resources to detect anomalies from the normal behavior assessed by the analytics engine. It shows details of key metrics and health. This dashboard contains the following widgets.
14
Epic Hierarchy
Workflow Heat Map
Key Metrics for Epic Resources
Windows Machines Hierarchy
Key Metrics for Windows Resources
VMware, Inc.
Chapter 2 Monitoring with Care Systems Analytics for Epic
Figure 2-1. Epic Overall Health Dashboard Sample
Figure 2-2. Epic Overall Health Dashboard for Windows Machines Sample
Epic Drilldown Dashboard Use the Epic Drilldown dashboard to quickly browse more than 280 Epic application‐specific metrics, ranging from global references to average workflow times and workflow exception counts, to support correlations between components. This dashboard contains the following widgets.
Epic Hierarchy
Metric Graph
Health Status
Metric Selector
VMware, Inc.
15
Care Systems Analytics for Epic Users Guide
Figure 2-3. Epic Drilldown Dashboard Sample
Epic Troubleshooting Dashboard To reduce time to investigate and resolve issues, use the Epic Troubleshooting dashboard as a template to create side‐by‐side views of Epic resources and underlying infrastructure belonging to non‐Epic resources, such as VMware virtual machines. This dashboard contains the following widgets.
Epic Hierarchy
Epic Virtual Servers
Health Status
Virtual Server Metric Selector
Epic Metric Selector
Epic Metric Graph
Virtual Machine Metric Graph
Figure 2-4. Epic Hierarchy Widget Sample
16
VMware, Inc.
Chapter 2 Monitoring with Care Systems Analytics for Epic
Double‐clicking any resource in the Epic Hierarchy (above) opens up the Health Status Detail widget (below). Figure 2-5. Health Status Detail Widget Sample
Epic Printing Health Dashboard The Epic Printing Health dashboard provides a view into all the Epic printing resources. This dashboard contains the following widgets.
EPS Printing Health Status
EPS Printing Metric Graph
Figure 2-6. Printing Health Dashboard Sample
VMware, Inc.
17
Care Systems Analytics for Epic Users Guide
Review Overall Health Indicators The Overall Health dashboard provides visibility to the components in your environment. Procedure
18
1
Select the Epic Overall Health dashboard tab.
2
View overall resource health. From the Epic Hierarchy widget, click the resource to view.
3
Check application‐wide metrics in the Workflow Heat Map widget.
VMware, Inc.
Chapter 2 Monitoring with Care Systems Analytics for Epic
Review Health Root Cause Detail in vRealize Operations Manager The Object Relationship pages provide visibility to health details of component resources in your environment. Procedure 1
Select the Epic Overall Health > resource > Workflow Heat Map. When you hover over a resource a status summary pop up appears.
2
View the resource detail. Double‐click the resource in the Epic Hierarchy widget or click the details link in the summary pop‐up.
3
An Object Relationship resource page displays the health status detail tabs and widgets.
Review Health Root Cause Detail in vCenter Operations Manager The Root Cause Health widgets provide visibility to health details of component resources in your environment. Procedure 1
Select the Epic Overall Health > resource > Workflow Heat Map.
2
View the resource detail. Double‐click the resource in the Epic Hierarchy widget.
3
A pop‐up displays the health status detail widgets.
VMware, Inc.
Check the health tree relationships in the Health Tree widget.
If Care Systems Analytics for Epic is installed in vCenter Operations Manager, you can view the list of root cause options in the Root Cause Ranking widget. Expand the list.
19
Care Systems Analytics for Epic Users Guide
4
View a root cause detail. Double‐click the root cause item. A pop‐up displays the resource details.
5
View a graph of the resource metrics. Click the graph icon in the pop‐up. A graph of resource activity is displayed in the Metric Graph widget.
6
View a graph of a metric from the Metric Selector widget. Expand the list and double‐click a metric. A graph is added to the Metric Graph widget.
Troubleshoot Decreased Health in vRealize Operations Manager When a significant decrease in health of, particularly, a top level Epic component, begin troubleshooting from the Overall Health widget. Procedure 1
Select the Epic Overall Health dashboard tab.
2
View overall resource health. From the Epic Hierarchy widget, double‐click the resource with decreased health (yellow, orange, or red color).
3
View the resource detail. Double‐click the resource in the Epic Hierarchy widget or click the details link in the summary pop‐up.
4
An Object Relationship resource page displays the health status detail tabs and widgets. These include:
20
Summary tab
VMware, Inc.
Chapter 2 Monitoring with Care Systems Analytics for Epic
Widgets include: Health, Risk, Efficiency, Top Health Alerts, Top Risk Alerts, top Efficiency Alerts, Top Health Alerts for Descendants, Top Risk Alerts for Descendants, Top Efficiency Alerts for Descendants.
Alerts tab Lists alerts.
Analysis tab Includes Anomalies Trend chart, Anomalies Breakdown Score and Volume, Epic Environment Resources.
Troubleshooting tab Groups information by Symptoms, Timeline, Events, and All Metrics.
Details tab Provides Views of alerts and Heatmaps.
Environment tab Provides Overview widgets, Lists of select resources, Map tree of the selected resources.
Projects tab Includes chart of historical data trend and lists projects.
Reports tab Includes Report Templates and Generated Reports views.
Troubleshoot Decreased Health in vCenter Operations Manager When a significant decrease in health of, particularly, a top level Epic component, begin troubleshooting from the Overall Health widget. Procedure 1
Select the Epic Overall Health dashboard tab.
2
View overall resource health. From the Epic Hierarchy widget, double‐click the resource with decreased health (yellow, orange, or red color).
3
View the Root Cause Ranking widget. It can indicate anomalous metrics that might be causing degraded health.
VMware, Inc.
21
Care Systems Analytics for Epic Users Guide
22
4
Select specific symptoms to who details of anomalous metrics.
5
Select specific metrics to add to a metric graph.
6
View metrics that reflect symptoms. These can be analyzed and graphed for correlation.
VMware, Inc.
Chapter 2 Monitoring with Care Systems Analytics for Epic
7
Use the metric selector to manually add metrics to graphs.
8
Continue to graph anomalies to examine the symptoms and identify the root cause for the decreased health. In the Health Status Details widget, anomalies are identified by yellow shading on the metric name in the Metric Selector widget.
VMware, Inc.
23
Care Systems Analytics for Epic Users Guide
24
VMware, Inc.
3
Advanced Working with Dashboard Widgets
3
The Care Systems Analytics for Epic is integrated with multiple Operations Manager widgets. For more advanced user who wants to understand deeper details of resource health, see the following sections describe some of these widgets. For additional information on using vRealize Operations Manager or vCenter Operations Manager, see VMware technical documentation specific to your Operations Manager at http://www.vmware.com/support/pubs.
Custom Relationship Widget The Custom Relationship widget is a customizable widget that shows metric types for resource kinds that you select. You specify the order in which the resource kinds appear in the widget display, set up metric mappings for the resource kinds, define user interface labels, and set color range boundaries for each mapped metric. Figure 3-1. Custom Relationship Widget
The toolbar at the top left of the widget contains icons for each configured metric type. Click these icons to change the widget display. The selected resource kinds appear in the widget display in the configured hierarchical order. Use the SORT BY drop‐down menu to sort the resources of each resource kind by name or metric value. Move your mouse over a badge to see detailed metric information for a resource, or double‐click a badge to view the resourceʹs Resource Detail page. Clicking a resource highlights the resourceʹs parent and child resources.
VMware, Inc.
25
Care Systems Analytics for Epic Users Guide
With the STATUS FILTER buttons at the top right of the widget, you can filter resources by resource state. In large inventories, filtering resources by state can help you quickly find resources that have degraded performance characteristics. A question mark (?) indicates an unknown metric and an X indicates an unavailable resource.
Configure the Custom Relationship Widget The Custom Relationship widget does not show any data until you configure it. You must select the metric icons and resource kinds to show in the widget display, configure metric mappings for each selected resource kind, and provide units of measure and color range boundaries for each mapped metric. You can also configure other widgets to provide resources to the Custom Relationship widget. When you select a resource in a providing widget, including resources that have resource kinds that are not configured in the Custom Relationship widget, the Custom Relationship widget highlights the related resources. Prerequisites
Verify that you have the necessary access rights to perform this task. Your Operations Manager administrator can tell you which actions you can perform.
Open the Edit Widget window for the Custom Relationship widget.
Procedure 1
Select the metric type icons to show in the widget display.
2
In the Resource Kinds pane, select the resource kinds to show in the widget display. OPTION
ACTION
Select a specific resource kind
Double‐click the resource kind.
Select multiple resource kinds
Press Ctrl+click to select multiple resource kinds or Shift+click to select a range of resource kinds.
Click the Perform Multi‐Select Interaction icon on the toolbar at the top of the Resource Kinds pane.
Click the Select All icon on the toolbar at the top of the Resource Kinds pane.
Click the Perform Multi‐Select Interaction icon on the toolbar at the top of the Resource Kinds pane.
Select all resource kinds
Remove selected resource kinds
Click the Clear Selections icon.
The resource kinds that you select appear in the Selected Resource Kinds pane. 3
(Optional) Change the order of the resource kinds in the Selected Resource Kinds pane. To reorder a resource kind, drag it to a new location in the list.
4
(Optional) Filter resources that have certain tag values. a
On the Selected Resource Kinds pane, click Select Tags next to the resource kind name.
b
Select the tag values to filter in the Select which tags to filter list. You can use icons on the toolbar at the top of the list to collapse, expand, and deselect all of the tags in the list. When you click the Invert Result icon, the widget shows only resources that do not match the tag values that you select.
When you select more than one value for the same tag, the widget shows resources that have either value. When you select values for two or more tags, the widget shows only resources that have all of the values that you select.
26
VMware, Inc.
Chapter 3 Advanced Working with Dashboard Widgets
5
Configure a metric mapping for each resource kind. a
In the Selected Resource Kinds pane, click Edit Metrics Mapping next to the resource kind name.
b
For each metric type icon in the Metrics Mapping pane, click the Select Metric link. The Pick Metrics with Resource Kind dialog box appears.
c
Select a metric in the Metric Selector with Resource Selection pane. The resource kind is preselected. You can select only one metric per metric type icon. The metric that you select appears in the Selected Metrics pane.
6
d
In the Selected Metrics pane, type a label for the selected metric.
e
Click Save to save your changes.
In the Metrics Mapping pane, set values for each metric type icon. To enter a value, move your cursor to the text box under the column heading, double‐click in the text box, and type the value. OPTION
ACTION
Box Label
Optional) Modify the label for the metric.
Measurement Unit
Type the measurement unit that appears after the metric value.
Yellow Bound
Type the highest or lowest value that should be yellow.
Orange Bound
Type the highest or lowest value that should be orange.
Red Bound
Type the highest or lowest value that should be red.
You cannot edit the color boundaries for health‐related metrics, such as vCenter Operations Generated | Self ‐ Health Score, in the Metrics Mapping pane. The color boundaries for these metrics are configured for you when you save the widget configuration. vRealize Operations Manager and vCenter Operations Manager obtain color range values for health‐related metrics from global settings (select Admin > Global Settings). 7
Click OK to save the widget configuration.
Application Detail Overview Widget in vCenter Operations Manager The Application Detail widget in vCenter Operations Manager shows information for a selected application or other container resources that have at least one child container resource. The top of the widget shows the number of containers, resources, and metrics that the application or container resource contains and the number of Smart Alerts and classic alerts on the application or container resource.
VMware, Inc.
27
Care Systems Analytics for Epic Users Guide
Figure 3-2. Application Detail Widget
For each container resource, the Application Detail widget shows the icons for the health of each resource in that container, the container name, the metric sparkline for the last 24 hours, the containerʹs current health score, and the number of active Smart Alerts and classic alerts for the container itself. The Application Detail widget shows only container resources that have at least one child container. It does not show information for child resources.
Configure the Application Detail Widget If the Application Detail widget is a self provider, you can select a tag value to monitor in the widget. You can also configure the column arrangement in the widget. You can also configure other widgets to provide an application or container resource to the Application Detail widget. Prerequisites 1
Verify that you have the necessary access rights to perform this task. Your vCenter Operations Manager administrator can tell you which actions you can perform.
2
Open the Edit Widget window for the Application Detail widget.
Procedure 1
Set Self Provider to On to define applications in the widget configuration.
2
Select the tag value to monitor in the Select which tags to filter list. You can use toolbar icons to collapse, expand, and deselect all tags in the list.
3
Use the Mode option to configure the Application Detail in Compact or Large mode. The same information appears in both modes, but the column arrangement is different.
4
Click OK to save the widget configuration.
Health Status Widget The Health Status widget shows the health score for selected resources. You can also configure the widget to show a custom metric and specify colors for metric ranges. Health status is a 0 to 100 ranking that the Operations Manager determines for each resource. For each resource, the widget includes the current health score and a graph that shows how the health score has changed over time. You can double‐click the graph for a resource to view the Resource Detail page for that resource.
28
VMware, Inc.
Chapter 3 Advanced Working with Dashboard Widgets
Figure 3-3. Health Status Widget
If the Operations Manager does not receive metrics for a resource at a particular time, it cannot calculate a health score for that time and it shows a score of ‐1 on the graph. A ‐1 score can occur if collection is turned off for a resource or if the Operations Manager encounters a data gathering problem.
Configure the Health Status Widget in vRealize Operations Manager You can filter the resources that the Health Status widget shows in vRealize Operations Manager by editing the widget configuration. You can also configure the widget to show a custom metric. You edit the health chart widget after you add it to the dashboard. The changes you make to the options create a custom widget with the selected charts. The charts are based either on Health, Risk, or Efficiency alert status, or you can base them on a selected metric. You can include a single object, multiple objects, or all objects of a selected type. Prerequisites 1
Verify that you have the necessary access rights to perform this task. Your vRealize Operations Manager administrator can tell you which actions you can perform.
Procedure To customize the data that appears in the dashboard widget, click Content in the left pane. Then click Dashboards. 1
On the Dashboards toolbar, click the plus sign to add a dashboard or the pencil to edit the selected dashboard.
2
In the Dashboard workspace, on the left, click Widget List, and drag a widget to the right pane of the dashboard.
3
On the title bar of the selected widget, click the pencil to access the configuration options.
4
Modify the configuration options, as needed. The options include: Title, Refresh Content, Refresh Interval, Self Provider, Mode, Order By, Pagination number, Period Length, Metric, and Object Tag Tree. OPTION
DESCRIPTION
Title
Enter a custom title that identifies this widget from other instances that are based on the same widget template.
Refresh Content
Enable or disable the automatic refreshing of the data in this widget. If not enabled, the widget is updated only when the dashboard is opened or when you click the Refresh button on the widget in the dashboard.
Refresh Interval
If you enable Refresh Content, specify how often to refresh the data in this widget.
Self Provider
Indicates whether the objects for which data appears in the widget are defined in the widget or provided by another widget.
Mode
On. You define the objects for which data appears in the widget.
Off. You configure other widgets to provide the objects to the widget using the dashboard widget interactions options.
Determines if the widget displays data for the selected objects, child objects, or parent objects. If you select Children or Parents, the selected objects do not appear in the widget. Only the related objects.
VMware, Inc.
29
Care Systems Analytics for Epic Users Guide
OPTION Order By
DESCRIPTION Determines how the object charts appear in the widget. You can order them based on score or name, and in ascending or descending order.
Pagination Number
Number of charts that appears on a page. If you prefer scrolling through the charts, select a higher number. If you prefer to page through the results, select a lower number.
Period Length
Amount of time that is displayed in the chart.
Metric
Determines the source of the data.
Health, Risk, or Efficiency. The displayed charts are based on one of these alert badges.
Custom. The displayed charts are based on the selected metric and use either alert symptom state colors or the selected custom color. If you apply custom colors, type the value in each box that is the highest or lowest value that should be that color.
For example, if you select Custom, define the metric as Badge | Anomaly, and set Yellow Bound as 1, Orange as 10, and Red as 20, the charts display the changes from yellow to orange or red based on the anomaly metric values at each point in time. Object Tag Tree
Object or object types for which to display charts. If you select a tag with more than one object, the widget displays charts for each object. If you select more than one tag, the widget displays charts only for the objects that are members of all the tags. If you select two tags an your widget does not display any charts, there were no common objects between the two tags.
Configure the Health Status Widget in vCenter Operations Manager You can filter the resources that the Health Status widget shows in vCenter Operations Manager by editing the widget configuration. You can also configure the widget to show a custom metric. You can also configure other widgets to provide resources to the Health Status widget. Prerequisites 1
Verify that you have the necessary access rights to perform this task. Your vCenter Operations Manager administrator can tell you which actions you can perform.
2
Open the Edit Widget window for the Health Status widget.
Procedure 1
Set Self Provider to On to define resources in the widget configuration.
2
Configure options to control the appearance of the resource display. OPTION
DESCRIPTION
Mode
Sets the widget mode: Self
The widget shows the selected resources.
Children
The widget shows child resources.
Parents
The widget shows parent resources.
If you select Children or Parents, the selected resources themselves do not appear in the widget, whether you select resources by editing the widget or the widget accepts resources from a providing widget.
3
30
Order By
Sets whether the list is ordered by health score or resource name, and whether the order is ascending or descending.
Pagination Number
Sets the number of resources that appear on each page of the widget.
Period Length
Sets the amount of time that appears on the health graph for each resource.
Select Health or Custom to specify whether the widget shows resource health or a custom metric.
VMware, Inc.
Chapter 3 Advanced Working with Dashboard Widgets
You can search for a custom metric by typing the metric name in the text box next to Custom. When the correct metric name appears, select it from the drop‐down menu. You can also open the drop‐down menu, scroll through the list of available metrics, and select a metric. Pagination controls are provided at the bottom of the drop‐down list. 4
If you configured a custom metric, configure metric ranges. You can configure the ranges in ascending or descending order.
5
OPTION
DESCRIPTION
Yellow Bound
Type the highest or lowest value that should be yellow.
Orange Bound
Type the highest or lowest value that should be orange.
Red Bound
Type the highest or lowest value that should be red.
Select tag values in the Select which tags to show list to show only resources that have certain tag values in the widget. You can use icons on the toolbar at the top of the list to collapse, expand, and deselect all of the tags in the list. When you select more than one value for the same tag, the widget includes resources that have either value. When you select values for two or more tags, the widget includes only resources that have all of the selected values. When you click the Invert Result icon, the widget includes only resources that do not match the tag values that you select.
6
Click OK to save the widget configuration.
Health Tree Widget in vCenter Operations Manager In vCenter Operations Manager, the Health Tree widget shows the section of your resource hierarchy around a resource that you select. The widget shows all of the parent container resources that hold the resource. If you select a container resource, the widget shows all of the child resources that the container holds. Figure 3-4. Health Tree Widget
Unless you are in Pan or Zoom the view mode, you can point to a resource to show its name and current health. You can double‐click a resource to shift the display to show its parents and children. If you configure a filter tag for the Health Tree widget, only the parent and child resources that match the tag appear in the widget. You can double‐click a resource to turn off the filter and show all of its parents and children. The toolbar at the top of the Health Tree widget contains icons that you can use to change the view. Table 3-1. Health Tree Widget Toolbar Icons ICON
DESCRIPTION
Zoom to Fit
Changes the size of the resource icons for the best possible fit in the widget.
Pan
Click this icon and click and drag the hierarchy to show different parts of the hierarchy.
VMware, Inc.
31
Care Systems Analytics for Epic Users Guide
Table 3-1. Health Tree Widget Toolbar Icons ICON
DESCRIPTION
Image Map Tooltip
Click this icon and point to a resource to show its name and current health.
Zoom the view
Click this icon and drag to outline a part of the hierarchy. The display zooms to show only the outlined section.
Zoom in
Zooms in on the hierarchy.
Zoom out
Zooms out on the hierarchy.
Reset To Initial Resource
If you changed the central resource of the hierarchy, click this icon to return to the initial resource. Clicking this icon also resets the initial display size.
Resource Detail
Select a resource and click this icon to show the Resource Detail page for the resource.
Show Alerts
Select the resource in the hierarchy and click this icon to show alerts for the resource. Alerts appear in a pop‐up window. You can double‐click an alert to view its Alert Summary page.
Display Filtering Criteria
Shows the filtering settings for the widget in a pop‐up window.
Configure the Health Tree Widget By default, the Health Tree widget includes all parent and child resources that match the selected resource. You can edit the widget configuration to limit the parent and child resources that the widget shows. You can also configure other widgets to provide a resource to the Health Tree widget. Prerequisites 1
Verify that you have the necessary access rights to perform this task. Your vCenter Operations Manager administrator can tell you which actions you can perform.
2
Open the Edit Widget window for the Health Tree widget.
Procedure 1
Set Self Provider to On to define a resource in the widget configuration.
2
(Optional) To configure a fixed zoom level for resource icons in the widget display, set Auto Zoom To Fixed Node Size to On and type an icon size, in pixels, in the Node Size (pixels) text box. If your widget display contains many resources and you always need to use manual zooming, this feature is particularly useful because it enables you to set the zoom level only once. The widget shows resource icons at the pixel size that you configure. You can still click the Zoom to Fit icon to change the size of the resource icons for the best possible fit in the widget. The fixed zoom level feature is disabled by default.
3
Select the resource in the Resource Selection pane. To find a specific resource, type all or part of the resource name in the Search text box and click the right angle bracket (>). The name of the resource that you select appears after Selected Resource.
4
(Optional) To limit the parent and child resources that the widget shows, select one or more tag values in the Select which tags to filter pane. You can use icons on the toolbar at the top of the pane to collapse, expand, and deselect all of the tags in the list. When you select more than one value for the same tag, the widget shows resources that have either value. When you select values for two or more tags, the widget shows only resources that have all of the values that you select. When you click the Invert Result icon, the widget shows only resources that do not match the tag.
5
32
Click OK to save the widget configuration.
VMware, Inc.
Chapter 3 Advanced Working with Dashboard Widgets
6
(Optional) To verify the filtering settings that you configured for the widget, click the Display Filtering Criteria icon on the widgetʹs toolbar. The filtering settings appear in a pop‐up window.
Root Cause Ranking Widget in vCenter Operations Manager In vCenter Operations Manager the Root Cause Ranking widget provides an instant view of the probable causes of health degradation for a selected resource. The widget shows information about metrics on related resources that contributed to alerts on the resources, including the percentage likelihood that the metric contributed to the cause. vCenter Operations Manager bases the percentage likelihood on the number of symptoms and when the symptoms occurred relative to the alert. Figure 3-5. Root Cause Ranking Widget
You can view root causes in Symptom mode and Resource mode.
Symptom mode ‐ Shows root cause information based on anomalies that occurred during the previous six hours, unless a providing widget passes a different time period. You can double‐click a resource to see the symptom groups ranked by percentage of possible resources that exhibit symptoms in the group. You can double‐click a group to see the top five individual symptoms ranked by percentage of possible resources that exhibit the symptom. You can double‐click a symptom, or select it and click Show Bar Details, to open a pop‐up window that shows detailed information about the symptom. This is the default mode.
Resource mode ‐ Shows root cause information based on anomalies that occurred during the previous two hours. If a providing widget passes a different time period, it shows information for all anomalies active in that time period. Double‐click a resource, or select it and click Show Bar Details, to list the individual anomalies.
A change event symptom might include different types of events that have different messages. If all of the change events for a symptom are the same type, the message appears to the right of the symptom bar. If the message does not fit, you can point to the message to the see the full message. If the symptom include different messages, Multiple Change Events appears. NOTE If the Health Status widget provides resources to the Root Cause Ranking widget and you click at a point in the past on the health score graph for a resource, the Root Cause Ranking widget shows root causes for the time that you selected.
VMware, Inc.
33
Care Systems Analytics for Epic Users Guide
The toolbar at the top of the Root Cause Ranking widget contains icons that you can use to view the graph. Table 3-2. Root Cause Ranking Widget Toolbar Icons ICON
DESCRIPTION
Auto Refresh
Refreshes the widget data.
Show Bar Details
Opens a new window that shows detailed information about the threshold violations that contributed to the selected root cause.
Perform Interaction
Shows the first five alarming metrics for the resource of the selected symptom in either the Metric Graph or Metric Sparklines widget. You must include either the Metric Graph widget or the Metric Sparklines widgets on the dashboard and set it to receive data from the Root Cause widget to use this feature.
Change mode
Switches between Resource mode and Symptom mode.
You can double‐click a root cause symptom to open a pop‐up window that lists the individual threshold violations that comprise the symptom. You can then click the Copy to Clipboard button to copy the list to the clipboard. You might want to use this feature if you are opening a problem ticket or sending an email message about the alert. To see the Dynamic Dashboard for a root cause resource, select it in the pop‐up window and click the Dynamic Dashboard button.
Configure the Root Cause Ranking Widget You can configure the Root Cause Ranking widget to show specific resources. You can also configure other widgets to provide resources to the Root Cause Ranking widget. Prerequisites 1
Verify that you have the necessary access rights to perform this task. Your vCenter Operations Manager administrator can tell you which actions you can perform.
2
Open the Edit Widget window for the Root Cause Ranking widget.
Procedure 1
Set Self Provider to On to define resources in the widget configuration.
2
Select a Bars Show option to specify whether to show bars for symptoms or resources. If you select Resources, you can choose how many bars to show.
3
Select the tag values to include in the Select which tags to filter list. You can use icons on the toolbar at the top of the Select which tags to filter pane to collapse, expand, and deselect all of the tags in the list. When you select more than one value for the same tag, the widget includes resources that have either value. When you select values for two or more tags, the widget includes resources that have all of the selected values.
4
Click OK to save the widget configuration.
Heat Map Widget The Heat Map widget contains graphical indicators that show the current value of two selected attributes for resources that belong to tag values that you select. In most cases, you can select only from internally generated attributes that describe the general operation of the resources, such as health or the active anomaly count. When you select a single resource kind, you can select any metric for that resource kind.
34
VMware, Inc.
Chapter 3 Advanced Working with Dashboard Widgets
Figure 3-6. Heat Map Widget
The Health Map widget has a General mode and an Instance mode.
General mode ‐ The widget shows a colored rectangle for each selected resource. The size of the rectangle indicates the value of one selected attribute. The color of the rectangle indicates the value of another selected attribute.
Instance mode ‐ Each rectangle represents a single instance of the selected metric for a resource. A resource can have multiple instances of the same metric. The rectangles are all the same size. The color of the rectangles varies based on the instance value. You can use instance mode only if you select a single resource kind.
In either mode, you can group the rectangles according to tag type and select the color range to use. By default, green indicates a low value and red indicates the high end of the value range. You can change the high and low values to any color and set the color to use for the midpoint of the range. You can also set the values to use for either end of the color range, or let the Operations Manager define the colors based on the range of values for the attribute. When you point to the rectangle for a resource, the widget shows the resourceʹs name, group‐by values, and the current values of the two tracked attributes. You can click Show Sparkline in the pop‐up window to see a small sparkline of the tracked metric by the heat map color. You can click the Resource Detail icon to show the Resource Detail page for a selected resource. If you configure the Heat Map widget as a provider to another widget, such as the Metric Graph widget, you can double‐click a rectangle to select that resource for the widget. If the widget is in Metric mode, double‐clicking a rectangle selects the resource associated with the metric and provides that resource to the receiving widget.
Configure the Heat Map Widget The Heat Map widget contains graphical indicators that show the current value of two selected attributes for resources that belong to tag values that you select. You can configure the widget to show different combinations of data, and you can save multiple configurations for the widget. You use the Configuration drop‐down menu on the toolbar at the top of the Heat Map widget to select the widget configuration to use. You can also configure other widgets to provide a resource to the Heat Map widget. Prerequisites 1
Verify that you have the necessary access rights to perform this task. Your Operations Manager administrator can tell you which actions you can perform.
2
Open the Edit Widget window for the Heat Map widget.
VMware, Inc.
35
Care Systems Analytics for Epic Users Guide
Procedure 1
Set Self Provider to On to define a resource in the widget configuration.
2
Select the tag to use for first‐level grouping of the resources from the Group By drop‐down menu. If a selected resource does not have a value for this tag, it appears in a group called Other.
3
Select the tag to use to separate the resources into subgroups from the Then By drop‐down menu. If a selected resource does not have a value for this tag, it appears in a subgroup called Other.
4
5
Select a Mode option. OPTION
DESCRIPTION
Instance
Track all instances of a metric for a resource with a separate rectangle for each metric.
General
Pick an individual instance of a metric for each resource and track only that metric.
If you selected General mode, select the attribute to use to set the size of the rectangle for each resource in the Size By list and the attribute to use to determine the color of the rectangle for each resource in the Color By list. Resources that have higher values for the Size By attribute have larger areas of the widget display. You can also select fixed‐size rectangles. The color varies between the colors you set based on the value of the Color By attribute. In most cases, the attribute lists include only metrics that the Operations Manager generates. If you select a resource kind, the list shows all of the attributes that are defined for the resource kind.
6
To track metrics only for resources of a particular kind, select the resource kind from the Resource Kinds drop‐down menu.
7
If you selected Instance mode, select an attribute kind from the Attribute Kinds list. The attribute kind determines the color of the rectangle for each resource.
8
Configure colors for the heat map. a
Click each of the small blocks under the color bar to set the color for low, middle, and high values. The bar shows the color range for intermediate values. You can also set the values to match the high and low end of the color range.
b
(Optional) Type minimum and maximum color values in the Min Value and Max Value text boxes.
If you leave the text boxes blank, the Operations Manager maps the highest and lowest values for the Color By metric to the end colors. If you set a minimum or maximum value, any metric at or beyond that value appears in the end color. 9
To define the resources to show in the widget, select the tag values to monitor in the Select which tags to filter list. If you select a resource kind, the widget shows only resources of that kind that meet the tag filter conditions. When you select more than one value for the same tag, the widget includes resources that have either value. When you select values for two or more tags, the widget includes only resources that have all of the values that you select.
10
Click the Capture new configuration icon, type a name for the configuration, and click OK to save the configuration. You must save a Heat Map widget configuration before you can use it.
11
36
(Optional) Select the configuration from the Configuration drop‐down menu on the widgetʹs toolbar to verify the Heat Map widget configuration.
VMware, Inc.
Chapter 3 Advanced Working with Dashboard Widgets
Example: Heat Map Widget Configuration Consider an environment that has these characteristics.
Multiple physical servers, in multiple data servers, that are running multiple virtual servers.
Each virtual server is defined as a resource in the Operations Manager.
Each resource has several attributes for which the Operations Manager collects data.
For this environment, the following Heat Map widget configuration shows at a glance which virtual machines have anomalies, whether those anomalies are for KPIs, and on which physical servers the virtual machines reside.
All resources that have a resource kind tag value of virtual machine are shown.
The resources are grouped by physical server and then by data center.
For each resource, the size of its rectangle is based on the number of current anomalies for that resource, and the color of its rectangle is based on the number of KPI breaches.
What to do next You can update a Heat Map widget configuration by selecting it from the Configuration drop‐down menu and clicking the Update selected configuration icon. You can delete a configuration by selecting it from the Configuration drop‐down menu and clicking the Delete selected configuration icon.
VMware, Inc.
37
Care Systems Analytics for Epic Users Guide
38
VMware, Inc.
4
Troubleshooting Tips
4
Review the following items for basic troubleshooting Care Systems Analytics for Epic integrated with vRealize Operations Manager.
Accessing the Debugging dashboard in vRealize Operations Manager. Double‐click a resource in a Care Systems Analytics for Epic dashboard. This opens Resource details, Summary tab. From this click the Analysis tab, then the Anomalies tab to view additional debugging information about what is affecting the health of this resource.
Review the following items for basic troubleshooting Care Systems Analytics for Epic integrated with vCenter Operations Manager.
Default dashboard overwritten after update. This is expected behavior, therefore, it is highly recommended that the vCenter Operations Manager administrator clone and share the default dashboards with the Epic application team and other individuals involved in the monitoring and management of the Epic application. Do this immediately after completing Care Systems Analytics for Epic management pack installation. This ensures that any changes to the configuration of the default dashboards for your environment are not overwritten by updated default dashboards that might be downloaded as part of an update to the Care Systems Analytics for Epic management pack.
Scheduled maintenance generates anomaly alerts. This is expected behavior, therefore, it is recommended that vCenter Operations Manager administrators identify and mark resources that are scheduled for regular maintenance. This prevents the vCenter Operations Manager from generating an unnecessary alert‐because it interprets changes in metrics that occur during the scheduled maintenance, as an anomaly.
Metrics do not display real time values. This is expected behavior. The information in VMware Care Systems Analytics for Epic is updated based on information in Epic System Pulse, which is refreshed every 5 minutes. Therefore the metrics shown in dashboards are not in real time.
Initially non‐performance related alerts are displayed. This is expected behavior. It takes 4‐6 weeks for vCenter Operations Manager to build dynamic (alert) thresholds based on the normal behavior of your environment. Until the dynamic thresholds are built with a sufficient base of monitoring data, you might see Alerts that indicate a deviation observed by vCenter Operations Manager, but are not actual performance issues.
Inactive resources not collecting data. When the Care Systems Analytics for Epic management pack is first installed, you might see several resources in the Epic hierarchy that are no longer active in the Epic environment. These resources are labeled with a blue color that indicates they are not collecting any data.
VMware, Inc.
39
Care Systems Analytics for Epic Users Guide
Have the Epic DBA remove inactive resources from the System Pulse SQL database. Once removed from the database, these inactive resources are automatically removed from your Care Systems Analytics dashboard.
View historical metric data in an HA environment. The historical metric data for each component / resource in an HA environment is maintained separately. or example, the Global References for PRD‐DB1 and PRD‐DB2 (where DB1 and DB2 are HA failovers for each other) is maintained separately. To view the current values of Global References (or any other metric for a given HA resource), select the currently active resource.
Epic Hierarchy relationships not created after HA failover. The relationships between the Epic Environment, Instance, and Host are automatically created in the Epic Hierarchy in the Overall Health, Drilldown, and Troubleshooting dashboard. If your Epic installation is deployed in a High Availability (HA) cluster environment, the relationship is not automatically re‐created when the primary environment switches.
40
VMware, Inc.
5
Advanced Troubleshooting
5
The Care Systems Analytics for Epic integrated with vRealize Operations Manager or vCenter Operations Manager provides additional monitoring options. For more advanced users who want to configure additional widget based monitoring actions, see the following sections.
View an Overview of Resource Health You can view a graphical representation of the health of all the Operations Manager resources that have a specific resource tag value on the Environment Overview page. Procedure 1
Select Environment > Environment Overview to view the Environment Overview page.
2
Select one or more resource tag values in the left pane.
3
Click the Group tab. The Group tab shows a colored icon that represents the current health of each resource that has the selected tag value. If you point to a colored icon, a tooltip appears that describes the resource that the icon represents. OPTION
ACTION
View the health icons for any time in the past six hours
Move the slider at the bottom of the Group tab to the left. The slider moves in five‐minute increments.
View detailed information for a resource
Click the icon for the resource and click the Show Detail icon on the toolbar.
Identify Health Problems for a Specific Resource You can use the Resource Detail page to identify health problems for a specific resource. For a global resource, the Resource Detail page contains information about the current state of the resource, its metrics, and its place in the resource tree. For a virtual resource, the Resource Detail page shows information about the main performance characteristics, key metrics, and events for the virtual resource. Procedure 1
Select Environment > Environment Overview.
2
(Optional) In the left pane, expand a resource tag and select a tag value that is assigned to the resource.
3
Selecting a tag value can shorten the resource list and make it easier to find a specific resource.
4
Select the resource on the List tab.
5
Click the Show Detail icon. The Resource Detail page appears for the resource.
VMware, Inc.
41
Care Systems Analytics for Epic Users Guide
View Alerts on the Alerts Overview Page By default, the Alerts Overview page shows alerts for all resources. You can filter the alert list by resource, alert type and subtype, and alert status. You can also search for alerts generated for particular resources and during a specific time period. Procedure 1
Select Alerts > Alerts Overview.
2
(Optional) Filter the alert list.
3
OPTION
ACTION
Show alerts for resources that have a specific value
Select one or more resource tag values in the resource tag list. If you select more than one value for the same tag, the list includes resources that have either value. If you select values for two or more different tags, the list includes only resources that have all of the selected values.
Show alerts for resources that do not have a specific value
Select one or more resource tag values in the resource tag list and click the Invert Result icon. For example, if you select New York and London, alerts for all resources that are not in either city appear in the list.
Show alerts for resources that have a specific resource name or resource kind
Type a full or partial name in the Search text box and click the right angle bracket (>).
Show alerts for a specific time period
Select a date from the Start Date and End Date menus and click the right angle bracket (>).
Show alerts that have a specific type or subtype
Click one or more of the alert type icons at the top of the alert list. For example, click the Smart (Early Warning), Smart (KPI Breach), and Smart (KPI Prediction) icons to show all smart alerts.
Show alerts that have a specific status
Click one or more of the alert status icons at the top of the alert list. For example, click the Active Alerts icon and the Own Alerts icon to show the active alerts assigned to you.
Remove an alert type or alert status filter
Click the icon again to toggle it off.
Remove all resource filters
Click the Deselect All icon at the top of the resource tag list.
(Optional) Click a column header and use the controls in the pop‐up menu to sort the alert list or add or remove columns from the display.
Configure Alerts to Send Notifications You can use the Operations Manager advanced configuration options to configure email or text alert notifications. This section provides a quick start for this task. For detailed information, VMware technical documentation at http://www.vmware.com/support/pubs. The Operations Manager generates an anomaly when a metric violates its threshold. If the Operations Manager determines that the current combination of anomalies indicates a real problem, it generates an alert. An alert is a notification to inform you of an abnormal condition that might require attention. Alerts appear in the Operations Manager user interface on the Alerts Overview page, in the alert watch list, and in the Alerts widget. When the Operations Manager administrator sets up the alert notification feature, then users can find out about alerts even when they are not using the Operations Manager.
42
VMware, Inc.
Chapter 5 Advanced Troubleshooting
Send Alert Notifications to Users in Email Messages Procedure 1
Configure email alert notifications Configuring email alert notifications involves adding filtering rules, defining email templates, and configuring email alert notification settings.
2
Create an alert handler that sends alert notifications to an email filter.
Configure Email Alert Notifications Procedure 1
Prepare the emailFilter.xml file. This file includes element, general setting element, element for setting alert conditions. emailFilter.xml is an XML file that defines the filtering rules and template files to use for email alert notifications. The file also contains general settings that apply to all email alert notifications.
IMPORTANT Do not edit emailFilter.xml directly unless you are familiar with XML structure and syntax. A formatting mistake might prevent email alert notifications from working. If you edit emailFilter.xml directly, make a backup copy of the file before you change it. After you edit the emailFilter.xml file, you must restart the email filter plug‐in instance in vRealize Operations Manager or vCenter Operations Manager to make your changes take effect. 2
Create or edit the email template file in text (.txt) or HTML (.html) format.
3
Add filtering rules.
4
Add an email template definition.
5
Configure general setting for email alert notifications.
Configure Email Alert Handlers Prerequisites Set up filtering rules, define email templates, and configure email alert notification settings. Procedure 1
Select Admin > Configure Outbound Alert.
2
(Optional) Add an email alert handler instance.
3
a
Click the Add Alert Handler icon.
b
Select Email from the Outbound Alert Type drop‐down menu.
c
Type a name for the alert handler instance in the Instance Name text box.
(Optional) Edit an email alert handler instance. Select the alert handler instance and click the Edit Alert Handler icon. You cannot change the outbound alert type.
4
VMware, Inc.
Configure or modify the email alert handler settings. OPTION
DESCRIPTION
SMTP_HOST
Type the IP address of the SMTP server. The SMTP server delivers email messages to the recipients of the alert notifications.
SMTP_PORT
Type the SMTP port number. The default value is 25.
43
Care Systems Analytics for Epic Users Guide
5
Click Test to test the filter. The Operations Manager verifies that the SMTP host and port you specified are valid and checks the syntax and data of the emailFilter.xml file.
6
Click OK to save your configuration. The Operations Manager starts the alert handler instance.
Configure Attributes Configure attributes to define conditions for monitoring your resources.
Create an Attribute Package An attribute package is a group of attributes that are related to a specific resource. When you assign an attribute package to a resource, the Operations Manager collects metrics for the attributes in the attribute package. These are used for setting dynamic thresholds and adding super metrics. Procedure 1
Select Environment > Configuration > Attribute Packages.
2
Select Adapter Kind > Resource kind > Add New Attribute Package or Edit Selected Attribute Package. When you add an attribute package, you set a collection interval, specify the attributes to collect for a resource, configure the type of threshold to use for each attribute, and indicate which attributes are KPIs.
3
Select Advanced Configuration > Hard Thresholds for each attribute, as needed. By default, the Operations Manager uses dynamic thresholds for attributes. You can override this behavior by setting hard thresholds for an attribute in an attribute package.
4
Select Advanced Configuration > Data Type for each attribute, as needed. By default, the Operations Manager recognizes the type of data that it receives for each attribute. You can override this behavior by explicitly setting the data type for an attribute in an attribute package.
Create a Super Metric Package You can combine different metrics by using mathematical formulas to define a super metric. Super metrics are useful when you need to track combinations of metrics, either from a single resource or, more commonly, from multiple resources. A super metric is a formula that contains a combination of one or more metrics for one or more resources. A super metric package contains one or more super metrics. Procedure 1
Design a Super Metric. Because super metric formulas can be complex, design a super metric before you use the Operations Manager user interface to create it. The key to creating a super metric that alerts you to the right situations is knowing your own enterprise and your data.
2
44
a
Determine the resources that are involved in the behavior to track.
b
Determine the metrics to include in the super metric.
c
Decide how to combine or compare the metrics.
d
Decide where to assign the super metric.
Set Super Metric specifications.
VMware, Inc.
Chapter 5 Advanced Troubleshooting
A super metric formula can consist of one or more metric specifications. You can specify a particular resource and metric, such as CPU use for Database Server 2, or you can specify a metric and use This Resource, which indicates the resource to which the super metric is assigned. Assign any package that contains the super metric only to resources for which the metric is collected. You can combine specific resource metrics and This Resource metrics in the same formula. 3
Set Super Metric functions. The Operations Manager includes functions that you can use in super metric formulas. The functions are either looping functions or single functions.
4
Build a Super Metric formula. A super metric formula can include one or more metric specifications, super metric functions, arithmetic operators (such as the plus or minus sign), and constants. You can enter any number of constants as part of the formula. There are several options for creating the super metric formula. These include:
5
Functions, selected from the Function menu.
Looping functions, defined in functN format.
Resource and metric, selected in the Resource and Metrics panes.
Add a Super Metric. You create a super metric when only a combination of metrics can let you know if your systems are behaving normally.
6
a
Select Environment > Super Metrics > Super Metric Editor > Add New Super Metric.
b
Define the formula for the super metric and verify it through Visualize Supermetric.
Add a Super Metric Package. When you create a super metric package, you specify the metrics that it contains, configure threshold characteristics for each super metric, and indicate which threshold violations should be considered KPIs. If you include the same super metric in more than one package, you can set different characteristics for it in each package.
7
a
Select Environment > Advanced > Super Metrics > Super Metric Packages > Add New Attribute Package.
b
(Optional) Select Violation of the Upper Dynamic threshold is a Key Indicator, Violation of the Lower Dynamic threshold is a Key Indicator, and/or Violation of the Hard threshold is a Key Indicator and Select Criticality Level at which a Hard Threshold becomes Key Indicator.
Assign Super Metric packages. You can assign a super metric package to any resource, regardless of whether any metrics from the resource are used in the super metric package. In most cases, you assign each super metric package to a related resource.
8
Export a Super Metric. You can export a super metric from one Operations Manager instance and import it to another Operations Manager instance. a
Select Environment > Super Metrics > Super Metric Editor.
b
Select the super metric to export and click the Export icon. The Operations Manager creates a super metric file, for example, SuperMetric.bin.
9
VMware, Inc.
Import a Super Metric.
45
Care Systems Analytics for Epic Users Guide
You can import a super metric that was exported from another instance of the Operations Manager. a
Select Environment > Super Metrics > Super Metric Editor > Import.
b
Click Browse, select the super metric file to import, and click Open.
c
Click Import to import the super metric file.
Set Dynamic Thresholds Setting dynamic thresholds is one of the configurable options in the Operations Manager for handling attributes. The combined dynamic threshold plug‐in provides faster and more accurate dynamic threshold calculations by combining the information learned from all previous dynamic threshold algorithms. The Operations Manager can collect several types of data for a single resource. Each type of data is called an attribute in the Operations Manager. For example, for a database server, it might receive data on free disk space, CPU use, and the average response time for a database request. The Operations Manager administrator creates attribute packages to tell the Operations Manager which attributes to track for your resources. By setting dynamic thresholds you tell the Operations Manager what metrics to monitor so it can determine your normal range and activity behavior. Procedure 1
Create attribute package. See “Create an Attribute Package” on page 44.
2
Create super metric package. See “Create a Super Metric Package” on page 44.
3
Enable dynamic threshold plug‐in. This is disabled by default. a
Open the advanced.properties file in the vcenter-ops\user\conf\analytics directory.
b
Set the useCombinedDTPlugin property to true. For example: useCombinedDTPlugin = true
c 4
Save your changes and close the advanced.properties file.
Restart the Analytics service.
Create a Super Metric Setting super metrics is one of the configurable options in the Operations Manager for handling attributes. The Operations Manager can collect several types of data for a single resource. For example, for a database server, it might receive data on free disk space, CPU use, and the average response time for a database request. Each type of data is called an attribute in the Operations Manager. The Operations Manager administrator creates attribute packages to tell the Operations Manager which attributes to track for your resources. Procedure 1
Create attribute package. See “Create an Attribute Package” on page 44.
2
Create super metric package. See “Create a Super Metric Package” on page 44.
3
Set a super metric, example: a
Select Environment > Super Metrics > Super Metric Editor.
b
Click the Add New Super Metric icon.
c
Type a name for the super metric in the Super Metric Name text box. For example, Average CPU Use.
d 46
Select avg from the Functions drop‐down menu. VMware, Inc.
Chapter 5 Advanced Troubleshooting
e
In the Resource Kinds pane, select the resource kind, or type all or part of the name of the resource type for the transaction servers in the Search text box, for example, AppServ, and click the arrow next to the text box. The attributes for the resource kind appear in the Attribute Kinds pane.
f
Double‐click the AvgCPUtil attribute. The database ID of the resource and metric appear in the formula line at the top of the window.
g
(Optional) To see the resource name and metric name, click below the formula line.
h
Click OK to save the super metric.
i
Add the super metric to an existing super metric package, or create a new super metric package.
j
Assign the super metric package to the tier.
Create Tiered Health Trees You can create a heat map and have a hierarchy in a custom widget with all resources, names, status health tree shows relationship between resources. The basic procedure includes:
Create a dashboard
Add widgets to the dashboard
Add resources and tags
Procedure 1
Create a dashboard. Click the plus icon next to the dashboard tabs and enter a name or select Dashboards > Add.
2
Build the dashboard by selecting widgets. a
Drag each widget from the left pane to the right pane. For example the widget, Health Tree.
b
Select the number of columns to use on the dashboard from the Select Layout drop‐down menu.
c
(Optional) To change the size of the columns, drag the divider bars under Drag to Change Layout.
d
Type a name for the new dashboard in the Tab Name text box.
e
Click OK. The new dashboard is empty.
3
Alternatively, build the dashboard by using a dashboard template. a
Click the Create Dashboard Using Templates icon in the corner of the left pane to show the available dashboard templates.
b
Drag a dashboard template to the right side of the window. For example the widget, Health Tree.
c
Select the number of columns to use on the dashboard from the Select Layout drop‐down menu.
d
Type a name for the new dashboard in the Tab Name text box.
e
Click OK. The new dashboard is empty.
4
VMware, Inc.
Add content to the new dashboard for the widgets to display. a
Click the Edit Widget gear icon and select items to display in the dashboard.
b
Select a Self Provider option to specify where the objects that the widget shows are defined.
47
Care Systems Analytics for Epic Users Guide
This option is not available if the widget cannot receive data from other widgets. OPTION
DESCRIPTION
On
Define the objects that the widget shows in the widget configuration.
Off
You configured, or plan to configure, one or more other widget to provide objects to the widget.
c
Select a Refresh Widget Content option to specify whether the widget refreshes data after a specific time period. The default setting is Off.
d
If you set Refresh Widget Content to On, type the refresh interval, in seconds, in the Widget Refresh Interval text box.
e
Edit any remaining configuration options, if required. For example, if you set Self Provider to On, you must define the objects that the widget shows.
f 5
6
Click OK to save the widget configuration.
Add resources. a
Select Tags. These are groupings to filter what is seen in the widget.
b
Select Resources and types.
c
Select specific resources.
View a sample health tree. A heath tree shows specific resources. The system automatically builds the hierarchy of parent and child resources based on relationships in the adapter configuration.
7
a
Select an Instance > Environment.
b
Select a Resource Object.
Navigate through a health tree. Double‐click to show a resource with its parent and child relationships.
Edit Widget Resource Interaction Files You can add functions to a dashboard that all users can see and use. Applying these changes through the Resource Interaction file affects all users and the display of all affected dashboards. For example, if you have an external package or plug‐in for additional metrics you can add selecting it to a dashboard pull‐down menu. Prerequisites This procedure requires that you have permissions to access and modify files on the Operations Manager virtual machine and the Epic System Pulse virtual machine. Procedure 1
Review widget file specifications. You customize a widget by editing its configuration options. Some widgets do not show data until you configure them. The available configuration options vary depending on the widget type.
2
Configure a widget. By default, the Advanced Health Tree widget includes all parent and child resources that match the selected resource. You can edit the widget configuration to limit the parent and child resources that the widget shows.
3
Configure widget interactions. You can also configure other widgets to provide a resource to an existing widget. When you configure widget interaction, you specify the widget that provides the information, called the providing widget, to the widget that shows the information, called the receiving widget.
48
VMware, Inc.
Chapter 5 Advanced Troubleshooting
Show Specific Resources in a Dashboard You can add different objects, such as hardware to resources, to the list shown in a widget. Procedure 1
Click the Edit Widget gear icon and select items to display in the dashboard.
2
Select a Self Provider option to specify where the objects that the widget shows are defined.
3
This option is not available if the widget cannot receive data from other widgets. OPTION
DESCRIPTION
On
Define the objects that the widget shows in the widget configuration.
Off
You configured, or plan to configure, one or more other widget to provide objects to the widget.
4
Select a Refresh Widget Content option to specify whether the widget refreshes data after a specific time period. The default setting is Off.
5
If you set Refresh Widget Content to On, type the refresh interval, in seconds, in the Widget Refresh Interval text box.
6
Edit any remaining configuration options, if required. For example, if you set Self Provider to On, you must define the objects that the widget shows. Many widgets can provide data to, and accept data from, other widgets. These relationships are called widget interactions. Each widget can provide selected resource information to other widgets through the resource ID or metric ID.
7
VMware, Inc.
Click OK to save the widget configuration.
49
Care Systems Analytics for Epic Users Guide
50
VMware, Inc.
