vrealize Automation Management Pack 2.0 Guide

Transcription

1 vrealize Automation Management Pack 2.0 Guide 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 EN

2 vrealize Automation Management Pack 2.0 Guide You can find the most up-to-date technical documentation on the VMware Web site at: The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: Copyright 2015 VMware, Inc. All rights reserved. Copyright and trademark information. VMware, Inc Hillview Ave. Palo Alto, CA VMware, Inc.

3 Contents The vrealize Automation Management Pack Guide 5 1 Introduction to the vrealize Automation Management Pack 7 Object Types and Relationships 7 Port Information 8 Security Guidelines for the vrealize Automation Management Pack 8 2 Installing and Configuring the Management Pack 11 Install the Management Pack 11 Configure the vrealize Automation Management Pack 12 Upgrade the vrealize Automation Management Pack 14 3 vrealize Automation Management Pack Dashboards 17 Access Dashboards 17 Cloud Infrastructure Monitoring Dashboard 18 vrealize Automation Top-N Dashboard 19 vrealize Automation Tenant Overview Dashboard 20 4 Alert Definitions 21 5 Configure the vrealize Automation Management Pack 23 6 Objects and Metrics 25 Tenant Metrics 25 Reservation Metrics 26 Business Group Metrics 27 Blueprint Metrics 28 Deployment Metrics 29 Managed Resources Object as a Filter in vrealize Automation 29 7 Capacity Models 31 8 Troubleshooting the vrealize Automation Management Pack 33 Test Connection Fails and Results in a Time Synchronization Exception 33 Virtual Machines Fail to Appear in Dashboards 33 Determining classes to be enabled for debug logging while troubleshooting adapter collection issues 34 Index 35 VMware, Inc. 3

4 vrealize Automation Management Pack 2.0 Guide 4 VMware, Inc.

5 The vrealize Automation Management Pack Guide The vrealize Automation Management Pack Guide provides an overview of how you as a cloud infrastructure provider can perform tenant-aware operations, troubleshooting, and capacity planning. The vrealize Automation Management Pack Guide describes the process of deploying a working instance of the vrealize Automation Management Pack in your vrealize Operations Manager environment. Intended Audience The information in this guide is intended for virtual and cloud infrastructure or operations administrators. 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 VMware, Inc. 5

6 vrealize Automation Management Pack 2.0 Guide 6 VMware, Inc.

7 Introduction to the vrealize Automation Management Pack 1 The vrealize Automation Management Pack extends operational management capabilities of the vrealize Operations Manager platform to provide tenant-aware operational visibility of the cloud infrastructure. The vrealize Automation Management Pack enables you as a cloud provider to monitor the health and capacity risk of your cloud infrastructure in the context of the tenant's business groups. You can use the vrealize Automation Management Pack to perform some of the following key tasks: To gain visibility into the performance, health, and capacity risk of the tenant s business groups that the underlying cloud infrastructure supports. To predict capacity shortage on the basis of tenant reservations. To gain visibility as a cloud provider about the capacity risk of business groups now or in the near future. To minimize the time taken to troubleshoot if there is a tenant workload or an underlying infrastructure problem. The vrealize Automation Management Pack provides visibility into the impact to performance, health, and capacity risk of the business groups because of an operational problem in the underlying cloud infrastructure layer. This chapter includes the following topics: Object Types and Relationships, on page 7 Port Information, on page 8 Security Guidelines for the vrealize Automation Management Pack, on page 8 Object Types and Relationships The vrealize Automation Management Pack brings in cloud constructs and their relationships from vrealize Automation into vrealize Operations Manager for operational analysis. You can use the following items in the virtual infrastructure as object types in vrealize Operations Manager when you install the vrealize Automation Management Pack. Tenant Reservation Business Group Deployment (appears only when monitoring vrealize Automation 7.0 and later environments) Blueprint Reservation Policy VMware, Inc. 7

8 vrealize Automation Management Pack 2.0 Guide Storage Reservation Policy Network Profile Fabric Group Objects types in an enterprise environment are related to other objects types in that environment. Object types are either part of a larger object type, or they contain smaller component objects, or both. When you select a parent object type, vrealize Operations Manager shows any related child objects types. The fabric group object types interact with VMware vcenter adapter object types such as hosts and clusters. The tenant object type has a parent-child relationship with business group, reservation, and blueprint object types. The business group, blueprint and reservation object types interact with each other. The tenant, blueprint, reservation, and business group object types have a parent-child relationship with the virtual machines and VMware vcenter adapter objects such as datastore, host, and cluster. The network profile object type has a parent-child relationship with the business group, reservation, reservation policy, and blueprint object types. Reservation policy, business group, blueprint, and reservation object types interact with each other. The tenant, blueprint, reservation, reservation policy, and business group object types have a parentchild relationship with the virtual machines and VMware vcenter adapter objects such as hosts and cluster. Port Information Communication between the vrealize Automation Management Pack and vrealize Operations Manager In environments where strict firewalls are in place, specific ports must be open for the vrealize Automation Management Pack to retrieve data from vrealize Automation. vrealize Automation URL on port 443 vrealize Automation IAAS URL on port 443 vrealize Automation SSO URL on port 7444 NOTE This version of the vrealize Automation Management Pack supports only vcenter objects used and managed by vrealize Automation. No other object kinds such as AWS or Openstack resources are supported at this time. Security Guidelines for the vrealize Automation Management Pack The vrealize Operations management packs include adapters built by VMware as well as adapters written by third parties. Although adapters execute independently, they execute within a common runtime environment within the vrealize Operations Manager collector host. Java language security protects the adapters from interference with other adapters. All adapters execute within the common JRE process trust zone. You must only load and use adapters that you obtain from a publisher you trust and only after you verify the adapter's code integrity before loading into vrealize Operations Manager. Even though adapters execute independently, they can make configuration changes to the collector host or Java runtime environment that may affect the security of other adapters. For example, at installation time an adapter can modify the list of trusted certificates. During execution an adapter can change the TLS/SSL certificate validation scheme and thereby change how other adapters validate certificates. The vrealize Operations Manager system and collector hosts do not isolate adapters beyond the natural isolation provided by Java execution. The system trusts all adapters equally. 8 VMware, Inc.

9 Chapter 1 Introduction to the vrealize Automation Management Pack Adapters are responsible for their own data security. When they collect data or make configuration changes to data sources, each adapter provides its own mechanisms and guarantees with regard to the confidentiality, integrity, and authenticity of the collected data. vrealize Automation v2.0 of the adapter enforces certificate checks when communicating to the vrealize Automation servers. These certificates are presented when the user clicks the Test button on the Adapter Instance setup page. Once these certificates are accepted by the user, they will be associated with that adapter instance. Any communication to the vrealize Automation servers will ensure that the certificates presented by the servers match the ones accepted by the user. VMware, Inc. 9

10 vrealize Automation Management Pack 2.0 Guide 10 VMware, Inc.

11 Installing and Configuring the 2 Management Pack You can download the vrealize Automation Management Pack from the VMware Solution Exchange website. This chapter includes the following topics: Install the Management Pack, on page 11 Configure the vrealize Automation Management Pack, on page 12 Upgrade the vrealize Automation Management Pack, on page 14 Install the Management Pack The vrealize Automation Management Pack consists of a PAK file that contains out of the box dashboards for the newer resource objects that are brought in from vrealize Automation. Prerequisites The solution that you downloaded includes a PAK file. Save that PAK file to a temporary folder on your local system. Procedure 1 Log in to the vrealize Operations Manager user interface with admin privileges. 2 In the left pane of vrealize Operations Manager, click the Administration icon and click Solutions. 3 On the Solutions tab, click the plus sign. 4 Browse to locate the temporary folder and select the PAK file. For example, vmware-mpforvrealizeautomation-<version#-build#>.pak. 5 Click Upload. The upload might take several minutes. 6 Read and accept the EULA, and click Next. Installation details appear in the window during the process. 7 When the installation is finished, click Finish. What to do next Configure an adapter instance for the management pack. VMware, Inc. 11

12 vrealize Automation Management Pack 2.0 Guide Configure the vrealize Automation Management Pack After you install the management pack, add and configure an instance for the vrealize Automation from which you are collecting data. Prerequisites The super user must have the following privileges: Infrastructure administrator rights for all tenants. Tenant administrator rights for all tenants. Fabric group administrator rights for all fabric groups, in all tenants. Software architect roles for all tenants (required only for vrealize Automation 7.0 and later installations). Procedure 1 In the left pane of vrealize Operations Manager, click the Administration icon and click Solutions. 2 Select vrealize Automation Management Pack and click the Configure icon. 3 Configure the adapter instance. Option Display Name Description vrealize Automation Appliance URL Tenants Description The name for the adapter instance. (Optional) The description of the adapter instance. The URL of the vrealize Automation CAFÉ appliance from which you are collecting data. Specify the host name, or the IP address, If there is a load balancer for the CAFÉ appliances, the URL must have HostName or IP address of the load balancer in the format or Collects data for specific tenants associated with vrealize Automation. Configure the tenants in the following manner to collect data: * (by default). Data is collected for all tenants. Comma separated list. Data is collected for the specific tenants that are listed and separated by comma.!. Data is collected for all tenants except the ones listed after!. Credential To add the credentials to access the vrealize Automation environment, click the plus sign. Credential name. The name by which you are identifying the configured credentials. SysAdmin Username. The user name of the vrealize Automation system administrator. For information on System Administrator, see oncepts.doc/guid- A1F0E20D-7E1F AC6-2A7CAF02AE01.html. SysAdmin Password. The password of the vrealize Automation system administrator. SuperUser Username. The user name of the vrealize Automation super user. Create a user in vrealize Automation with specific privileges mentioned in the note below. SuperUser Password. The password of the vrealize Automation super user. 12 VMware, Inc.

13 Chapter 2 Installing and Configuring the Management Pack Option Collector Autodiscovery Description The collector on which the vrealize Automation Management Pack instance will run. For one collector instance, select Automatically select collector. For multiple collectors, to distribute the workload and optimize performance, select the collector to manage the adapter process for this instance. Discover objects automatically. To set automatic discovery for objects, select True. To set the automatic discovery off, select False. 4 Click Test Connection to validate the connection. a b c Enter adapter instance setup information, including login credentials, accurately and click Save. Click OK to accept the vra certificate (first certificate) when prompted. Again, click OK to accept the IAAS certificate (second certificate). The adapter instance validation must succeed. NOTE If you click Cancel and do not accept either of the certificates, the adapter instance validation fails. 5 Click Save Settings. The adapter instance is added to the list. What to do next Verify that the adapter is configured and collecting data, view application-related data Related objects are added to the Environment Overview Inventory. vrealize Automation Management Pack dashboards are added to Dashboard List > vrealize Automation. Set the Collection Time Interval Set the collection time interval to 60 minutes after an instance of vrealize Automation Management pack 2.0 has been successfully configured with a vrealize Automation endpoint. Procedure 1 Log in to vrealize Operations Manager. 2 Navigate to Administration > Inventory Explorer > Adapter Instances > MP for vrealize Automation Instance. 3 Select the management pack instance, click Edit, and from the Advanced Settings, set the value for Collection Interval (Minutes) to 60. If the value of 60 minutes is not sufficient for collecting all the data from the provided vrealize Automation environment, adjust this collection interval frequency in multiples of 30 minutes. Alternatively, observe the collection time for the adapter as measured by vrealize Operations Manager and adjust the collection interval to 30 or 60 minutes above that value. VMware, Inc. 13

14 vrealize Automation Management Pack 2.0 Guide Configuration Properties In large scale environments, multiple simultaneous API calls might cause performance problems in vrealize Automation. When an adapter sends multiple parallel requests to WAPI in particular, it severely impacts the database. Configuration properties are used to configure the settings with appropriate values. Table 2 1. Configuration Properties Property Name Description Default Value vcenterresourcediscoveryfre quency The frequency of vcenter resource discovery in hours. The default value of 0 corresponds to every collection cycle. 0 querypagesize The number of items to fetch in a single API call. 100 wapicollectionmaxseconds wapithreadcount usewapifor70businessgroup s usewapifor70reservations The upper limit for the amount of time that the adapter needs to try and retrieve the data from API calls. This property must be increased in large-scale environments, in addition to increasing the adapter's collection time interval. The number of threads that are querying WAPI at a time. This property may be increased or decreased based on speed or performance requirements. This flag enables or disables usage of WAPI API to collect Businessgroup from vrealize Automation 7.0. By default, a vrealize Automation Management Pack 2.0 instance collects Businessgroup from CAFE API. NOTE WAPI is slow and inefficient and can degrade the vrealize Automation appliance's performance. However, it provides more metrics for allocation and quota. CAFE is more efficient but lacks those metrics. This flag enables or disables usage of WAPI API to collect Reservations from vrealize Automation 7.0. By default, vrealize Automation Management Pack 2.0 instance collects Reservations from CAFE API. NOTE WAPI is slow and inefficient and can degrade the vrealize Automation appliance's performance. However, it provides more metrics for allocation and quota. CAFE is more efficient but lacks those metrics. 3600s (1 hour) 1 False False Upgrade the vrealize Automation Management Pack When upgrading the vrealize Automation Management Pack from version 1.0 to 2.0, the state of the existing vrealize Automation Management Pack adapter instance and the monitoring resources changes to Failed. This happens because the adapter instance requires certificates to communicate with the vrealize Automation setup in the later version of the Management Pack. Procedure 1 In the left pane of vrealize Operations Manager, click the Administration icon and click Solutions. 2 From the Solutions page, select the vrealize Automation Management Pack and click Configure. 3 From the Manage Solution page, select the instance, perform test connection, and accept the certificates when prompted. 14 VMware, Inc.

15 Chapter 2 Installing and Configuring the Management Pack 4 From the Inventory Explorer page, stop and start the vrealize Automation Management Pack resources. To stop and start all the resources at once, select the vrealize Automation Management Pack instance to filter only those resources belonging to the management pack, and then click Stop or Start with no resources selected. VMware, Inc. 15

16 vrealize Automation Management Pack 2.0 Guide 16 VMware, Inc.

17 vrealize Automation Management 3 Pack Dashboards With the vrealize Automation Management Pack dashboards, you can monitor and troubleshoot objects in your cloud infrastructure. The following vrealize Automation Management Pack dashboards are added to the predefined vrealize Operations Manager dashboards: vrealize Automation Cloud Infrastructure Monitoring vrealize Automation Top-N vrealize Automation Tenant Overview This chapter includes the following topics: Access Dashboards, on page 17 Cloud Infrastructure Monitoring Dashboard, on page 18 vrealize Automation Top-N Dashboard, on page 19 vrealize Automation Tenant Overview Dashboard, on page 20 Access Dashboards You can use the dashboards to view, monitor, and troubleshoot objects in your cloud infrastructure. To access the dashboards, select the Dashboard List > vrealize Automation menu option from the vrealize Operations Manager menu bar. Procedure 1 In the left pane of vrealize Operations Manager, click the Home icon. If this is the first time you are accessing the Home page after installing the management pack, the vrealize Automation Tenant Overview dashboard is displayed. 2 To view a different dashboard, click the tab for the required dashboard in the menu bar. 3 If the dashboards are not displayed on the Home page, click Dashboards List on the vrealize Operations Manager menu bar and ensure that the vrealize Automation check box is selected. Example: Note The values used for the color are relative to the dynamic maximum value. You can adjust the scale by editing the widget and entering appropriate minimum and maximum values. VMware, Inc. 17

18 vrealize Automation Management Pack 2.0 Guide Cloud Infrastructure Monitoring Dashboard You can use the vrealize Automation Cloud Infrastructure Monitoring dashboard to understand what the tenant virtual machines are impacted by, the outstanding alerts, and so on. You can use the vrealize Automation Cloud Infrastructure Monitoring dashboard to perform some of the following key tasks: To get visibility into the performance, health, and capacity risk of the virtual machines in various tenant s business groups. To view outstanding problem alerts and recommendations for any layer of the cloud infrastructure stack when you select any given tenant or business group. To understand which tenant business groups are impacted because of an operational issue with the underlying cloud infrastructure layer. To understand if there is a tenant workload or an underlying infrastructure problem. To understand if there is any capacity risk in the near future for business groups. Widgets in the vrealize Automation Cloud Infrastructure Monitoring Dashboard The vrealize Automation Infrastructure Monitoring dashboard provides an overview of the infrastructure and the vrealize Automation objects. The dashboard includes several widgets: Table 3 1. vrealize Automation Cloud Infrastructure Monitoring Dashboard Widgets Widget Cloud Infrastructure Health and Capacity Overview Top Problem Alerts with Recommendations Business Groups at Capacity Risk Description This widget displays the health and risk of resources for a given object from the managed inventory. You can view health and risk for business groups, tenants, reservations, reservation policies, fabric groups, storage reservation policies object types as well as clusters, hosts, virtual machines, and data stores. You can also view the health tree and relationship of business groups and the underlying infrastructure. Use the Health or Risk badge to view a health tree or a capacity risk tree of the cloud stack that supports the various tenants' business groups. This widget displays the alerts with the greatest impact on the selected objects that are configured to being monitored. The top alerts include the short description of alerts configured for the widget. The alert name opens a secondary window from which you can link to the alert details. In the alert details, you can begin to resolve the alerts. This widget displays the weekly trend of capacity risk across all the business groups. The information helps you as a cloud provider to understand which business group's allocated reservations may be at capacity risk now or in the near future. 18 VMware, Inc.

19 Chapter 3 vrealize Automation Management Pack Dashboards Table 3 1. vrealize Automation Cloud Infrastructure Monitoring Dashboard Widgets (Continued) Widget Reservations at Capacity Risk Which Reservations can be Over-Committed (due to Low Demand) Description This widget displays the weekly trend of capacity risk across all the reservations. The information helps you as a cloud provider to understand which reservation's resource may be at capacity risk now or in the near future. This widget displays a heatmap of reservations sized by the actual capacity and colored by the demand for the reservation based on self or consumer demand. You can use this widget to get visibility about reservations that may be running out of capacity. Conversely, you can also use this widget to get visibility into reservations that are allocated to virtual machines but are not nearing capacity because the demand of all the virtual machines is low. vrealize Automation Top-N Dashboard You can use the widgets in the vrealize Automation Top-N dashboard to view the top results from analysis of tenant, business groups, and virtual machines that you select. You can use the vrealize Automation Top-N dashboard to perform some of the following tasks: To view the tenants and business groups with the most wasteful virtual machines. To view the tenants and business groups with the most undersized virtual machines. To view the most popular and most wasteful blueprints and virtual machines. To view the business groups that have the most critical alerts. Widgets in the vrealize Automation Top-N Dashboard The vrealize Automation Top-N dashboard provides an overview of top results from analysis of tenant, business groups, and virtual machines that you select. The dashboard includes the following widgets: Table 3 2. vrealize Automation Top-N Dashboard Widget Tenants with Most Wasteful VMs Tenants with Most Under-Sized VMs Most popular deployed Blueprints Wasteful VM (7 day trend) Under-Sized VM (7 days trend) Most Popular Deployed Blueprint (7 day trend) Description Lists the virtual machines that are the most idle, oversized, or powered off for the tenant. Lists the virtual machines that are under the most stress for the tenant. Lists the virtual machine count that has been deployed the most for the blueprint. Displays graphical trends that contain metrics for the virtual machines that are the most idle, oversized, or powered off over a 7 day period. You can create one or more graphs that contain metrics for the object you select. Displays graphical trends that contain metrics for the virtual machine under the most stress over a 7 day period. You can create one or more graphs that contain metrics for the object you select. Displays graphical trends that contain metrics for the virtual machine count that has been deployed the most for the blueprint over a 7 day period. You can create one or more graphs that contain metrics for the object you select. VMware, Inc. 19

20 vrealize Automation Management Pack 2.0 Guide Table 3 2. vrealize Automation Top-N Dashboard (Continued) Widget Business Groups with Most Wasteful VMs (Idle, Powered Off, Oversized) Business Groups with most Critical Alerts Which Blueprints have the most Wasteful VMs? Description Lists the business groups that have the most virtual machines that are idle, oversized, or powered off. Lists the business groups that have the most critical alerts. Lists the average number of virtual machines that are idle, oversized, or powered off for the last 30 days for each blueprint. The value may not always be a whole number. vrealize Automation Tenant Overview Dashboard You can use the vrealize Automation Tenant Overview dashboard to view information about the tenants and the related alerts. You can also view the health, risk, and efficiency of resources for a given object from the managed inventory. You can use the vrealize Automation Tenant Overview dashboard to perform some of the following tasks: To view a list of supported tenants and the monitoring policy based on vrealize Automation's reservation policy. To view the outstanding alerts for selected tenants, business groups, and blueprints. To view the tenants at capacity risk. To view the business groups at capacity risk. To create planned capacity projects based on vrealize Automation reservations. Widgets in the vrealize Automation Tenant Overview Dashboard The vrealize Automation Tenant Overview dashboard widgets provide an overview of the health of the tenants. The dashboard includes the following widgets: Table 3 3. vrealize Automation Tenant Overview Dashboard Widgets Widget Tenant List Environment Overview Top Alerts Tenants at Capacity Risk Description Lists the tenant objects available in the environment. You can see a data grid with a list of objects in the inventory on which you can sort and search. The widget is configured to show the health of tenants, business groups, virtual machines, and the relationships between these objects. You can view detailed information for the object if you double-click an object in the Environment Overview widget. Alerts with the greatest significance on the selected objects it is configured to monitor. The top alerts include a short description of alerts configured for the widget. The alert name opens a secondary window from which you can link to the alert details. In the alert details, you can begin resolving the alerts. This widget displays the weekly trend of capacity risk across all the tenants. The information helps you as a cloud provider to understand which tenant's resource may be at capacity risk now or in the near future. 20 VMware, Inc.

21 Alert Definitions 4 Health Alert definitions are combinations of symptoms and recommendations that identify problem areas in your environment and generate alerts on which you can act. Symptom and alert definitions are defined for vrealize Automation objects. The alerts are population-based alerts based on the risk or health of a certain percentage of child objects. There are no alerts generated for network profiles. The health and risk thresholds are as follows: When 25%-50% of the child objects have health issues, the parent object will trigger an alert with a Warning health level. When 50%-75% of the child objects have health issues, the parent object will trigger an alert with an Immediate health level. When 75%-100% of the child objects have health issues, the parent object will trigger an alert with a Critical health level. Risk When 25%-50% of the child objects have risk issues, the parent object will trigger an alert with a Warning risk level. When 50%-75% of the child objects have risk issues, the parent object will trigger an alert with an Immediate risk level. When 75%-100% of the child objects have risk issues, the parent object will trigger an alert with a Critical risk level. VMware, Inc. 21

22 vrealize Automation Management Pack 2.0 Guide 22 VMware, Inc.

23 Configure the vrealize Automation Management Pack 5 After you install the management pack, add and configure an instance for the vrealize Automation from which you are collecting data. Prerequisites The super user must have the following privileges: Infrastructure administrator rights for all tenants. Tenant administrator rights for all tenants. Fabric group administrator rights for all fabric groups, in all tenants. Software architect roles for all tenants (required only for vrealize Automation 7.0 and later installations). Procedure 1 In the left pane of vrealize Operations Manager, click the Administration icon and click Solutions. 2 Select vrealize Automation Management Pack and click the Configure icon. 3 Configure the adapter instance. Option Display Name Description vrealize Automation Appliance URL Tenants Description The name for the adapter instance. (Optional) The description of the adapter instance. The URL of the vrealize Automation CAFÉ appliance from which you are collecting data. Specify the host name, or the IP address, If there is a load balancer for the CAFÉ appliances, the URL must have HostName or IP address of the load balancer in the format or Collects data for specific tenants associated with vrealize Automation. Configure the tenants in the following manner to collect data: * (by default). Data is collected for all tenants. Comma separated list. Data is collected for the specific tenants that are listed and separated by comma.!. Data is collected for all tenants except the ones listed after!. VMware, Inc. 23

24 vrealize Automation Management Pack 2.0 Guide Option Description Credential To add the credentials to access the vrealize Automation environment, click the plus sign. Credential name. The name by which you are identifying the configured credentials. SysAdmin Username. The user name of the vrealize Automation system administrator. Collector Autodiscovery For information on System Administrator, see oncepts.doc/guid- A1F0E20D-7E1F AC6-2A7CAF02AE01.html. SysAdmin Password. The password of the vrealize Automation system administrator. SuperUser Username. The user name of the vrealize Automation super user. Create a user in vrealize Automation with specific privileges mentioned in the note below. SuperUser Password. The password of the vrealize Automation super user. The collector on which the vrealize Automation Management Pack instance will run. For one collector instance, select Automatically select collector. For multiple collectors, to distribute the workload and optimize performance, select the collector to manage the adapter process for this instance. Discover objects automatically. To set automatic discovery for objects, select True. To set the automatic discovery off, select False. 4 Click Test Connection to validate the connection. a b c Enter adapter instance setup information, including login credentials, accurately and click Save. Click OK to accept the vra certificate (first certificate) when prompted. Again, click OK to accept the IAAS certificate (second certificate). The adapter instance validation must succeed. NOTE If you click Cancel and do not accept either of the certificates, the adapter instance validation fails. 5 Click Save Settings. The adapter instance is added to the list. What to do next Verify that the adapter is configured and collecting data, view application-related data Related objects are added to the Environment Overview Inventory. vrealize Automation Management Pack dashboards are added to Dashboard List > vrealize Automation. 24 VMware, Inc.

25 Objects and Metrics 6 You can use the the vrealize Automation Management Pack to collect metrics for tenant, reservation, business group, and blueprint object types. You cannot collect metrics for reservation policy, network profile, storage reservation policy, and fabric group object types. This chapter includes the following topics: Tenant Metrics, on page 25 Reservation Metrics, on page 26 Business Group Metrics, on page 27 Blueprint Metrics, on page 28 Deployment Metrics, on page 29 Managed Resources Object as a Filter in vrealize Automation, on page 29 Tenant Metrics For the tenant object type, the vrealize Automation Management Pack collects metrics about virtual machines. Table 6 1. Tenant Metrics Metric Key Metric Name Description summary stressedvmcount Stressed VM Count The total number of virtual machines under stress that belong to the tenant. summary oversizedvmcount Oversized VM Count The total number of oversized virtual machines that belong to the tenant. summary idlevmcount Idle VM Count The total number of virtual machines that are idle and that belong to the tenant. summary poweredoffvmcount Powered Off VM Count The total number of virtual machines that are powered off and that belong to the tenant. summary wastefulvmcount Wasteful VM Count The total number of all the idle, oversized, and powered off virtual machines count that belong to the tenant. memory allocation Allocation (GB) The memory size allocated for the tenant. memory reserved Reserved (GB) The memory size that can be used only by the tenant. VMware, Inc. 25

26 vrealize Automation Management Pack 2.0 Guide Table 6 1. Tenant Metrics (Continued) Metric Key Metric Name Description memory usage Usage (GB) The memory size used by the tenant. memory free Free (GB) The amount of memory free for use by the tenant. storage allocation Allocation (GB) The storage size allocated for the tenant. storage reserved Reserved (GB) The storage size that only the tenant can use. storage usage Usage (GB) The storage size that the tenant has used. storage free Free (GB) The storage size free for use by the tenant. quota allocation Allocation The quota allocated for the tenant. quota reserved Reserved The quota that can be used only by the tenant. The capacity is the sum of the quota capacities of the tenant's business group. quota free Free The quota that is free for use by the tenant. Summary Deployment Count Deployment Count The total deployments for this tenant. Summary VM Count VM Count The total number of VMs in this tenant. Reservation Metrics For the reservation object type, the vrealize Automation Management Pack collects metrics about memory, quota, storage, and virtual machines. Table 6 2. Reservation Metrics Metric Key Metric Name Description memory reserved Reserved (GB) The amount of memory that can be used only by the reservation. memory allocation Allocation (GB) The amount of memory that can be allocated for use for the reservation. memory free Free (GB) The amount of memory free for use for the reservation. memory usage Usage (GB) The amount of memory used by the reservation. quota reserved Reserved The quota reserved for reservation. The quota capacity is the quota value assigned in vrealize Automation. If the quota capacity is unlimited, the value displayed is quota used Used The quota used by the reservation. quota free Free The maximum number of virtual machines that can be provisioned to a reservation at a given time and are free to be used. storage reserved Reserved (GB) The amount of storage size that can be used only by the specific reservation. storage allocation Allocation (GB) The amount of storage size that has been allocated for the specific reservation. storage used Used (GB) The amount of storage size that has been used for the specific reservation. 26 VMware, Inc.

27 Chapter 6 Objects and Metrics Table 6 2. Reservation Metrics (Continued) Metric Key Metric Name Description storage free Free (GB) The amount of free storage available for use for the reservation. storage usage Usage (GB) The storage size for the reservation. summary stressedvmcount summary oversizedvmcount Stressed VM Count Oversized VM Count The total number of virtual machines under stress and that belong to the reservation. The total number of virtual machines that are oversized and that belongs to the reservation. summary idlevmcount Idle VM Count The total number of virtual machines that are idle and that belong to the reservation. summary poweredoffvmcount summary wastefulvmcount Powered Off VM Count Wasteful VM Count The total number of virtual machines that are powered off and belong to the reservation. The total number of the idle, oversized, and powered off virtual machines count that belong to the reservation. summary VMCount VM Count The total number of virtual machines that belong to the reservation. Business Group Metrics For the business group object type, the vrealize Automation Management Pack collects metrics about memory, quota, storage, virtual machines, and so on. Table 6 3. Business Group Metrics Metric Key Name Description memory reserved Reserved (GB) The memory size reserved for the business group. memory allocation Allocation (GB) The allocated memory size for the business group. memory free Free (GB) The amount of memory that is free for use by the specific business group. memory usage Usage (GB) The amount of memory used by the business group. quota allocation Allocation The quota allocated for use for the specific business group. quota reserved Reserved The quota reserved only for the business group. The quota capacity is the sum of all the reservation quota capacities that belong to the business group. If the quota capacity is unlimited or if any one reservation has unlimited quota, the value displayed is quota used Used The quota used for the business group. quota free Free The free quota for the business group. storage reserved Reserved (GB) The storage space reserved only for the specific business group. storage allocation Allocation (GB) The storage space allocated for the business group. storage free Free (GB) The amount of storage space that is free for use by the business group. storage usage Usage (GB) The amount of storage space used by the business group. VMware, Inc. 27

28 vrealize Automation Management Pack 2.0 Guide Table 6 3. Business Group Metrics (Continued) Metric Key Name Description summary stressedvmcount Stressed VM Count The total number of virtual machines under stress and that belong to the business group. summary oversizedvmcount Oversized VM Count The total number of virtual machines that are oversized and that belong to the business group. summary idlevmcount Idle VM Count The total number of virtual machines that are idle and that belong to the business group. summary poweredoffvmcount Powered Off VM Count The total number of the virtual machines that are powered off and that belong to the business group. summary wastefulvmcount Wasteful VM Count The total number of the powered off, idle, and oversized virtual machines that belong to this business group. Summary DeploymentCount Deployment Count The total number of deployments that belong to this business group. Summary VMCount VM Count The total number of virtual machines that belong to this business group. Blueprint Metrics For the blueprint object type, the vrealize Automation Management Pack collects metrics about virtual machines, deployment information, and so on. Table 6 4. Blueprint Metrics Metric Key Metric Name Description summary stressedvmcount Stressed VM Count The total number of virtual machines under stress and that belong to the blueprint. summary oversizedvmcount Oversized VM Count The total number of virtual machines that are oversized and that belongs to the blueprint. summary idlevmcount Idle VM Count The total number of virtual machines that are idle and that belong to the blueprint. summary poweredoffvmcount Powered Off VM Count The total number of virtual machines that are powered off and belong to the blueprint. summary wastefulvmcount Wasteful VM Count The total number of idle, oversized, and powered off virtual machines that belong to the blueprint. DeploymentCount TotalDeployed Total Deployed The total number of virtual machines deployed from the blueprint. DeploymentCount TotalOn Total On The total number of virtual machines deployed from the blueprint and that are currently on. DeploymentCount TotalOff Total Off The total number of virtual machines deployed from the blueprint that are currently off. DeploymentCount TotalVMs Total VMs The total number of virtual machines deployed from the blueprint. 28 VMware, Inc.

29 Chapter 6 Objects and Metrics Table 6 4. Blueprint Metrics (Continued) Metric Key Metric Name Description AverageDeploymentTime Deployment Time The average time required to deploy the virtual machines (appears only when monitoring vrealize Automation 7.0 and later environments). AverageApprovalTime Approval Time The average time required to approve the deployment (appears only when monitoring vrealize Automation 7.0 and later environments). Deployment Metrics For the deployment object type, the vrealize Automation Management Pack collects metrics about deployment time and approval time. Table 6 5. Deployment Metrics Metric Key Name Description Deployment Time Deployment Time The total time required for deployment. Approval Time Approval Time The total time required for approving the deployment. NOTE The deployment metrics appear only when monitoring vrealize Automation 7.0 and later environments. Managed Resources Object as a Filter in vrealize Automation The vrealize Automation Management Pack uses filters to display the VMware vcenter adapter objects that are managed by or have some association with vrealize Automation. Some of the dashboards have widgets that are configured to display only VMware vcenter adapter objects that vrealize Automation manages or is associated with. vrealize Automation uses an object called Managed Resources as a filter to display only those objects. All of these resources are placed under the Managed Resources object of type vrealize Automation Entity Status. The absence of this filter causes all VMware vcenter adapter objects to be displayed in the widgets. If you delete the Managed Resources object, the adapter re-creates the object, but the dashboards display incorrect information in the widgets that use this filter. If you delete the Managed Resources object, you must manually configure the widgets in the dashboard and select the Managed Resources object as a filter in each section that displays the VMware vcenter adapter objects. VMware, Inc. 29

30 vrealize Automation Management Pack 2.0 Guide 30 VMware, Inc.

31 Capacity Models 7 An object's capacity model, combined with policy settings, is used to determine the value of all badges and sub-badges aside from Health. The capacity model table for vrealize Automation Management Pack describes the capacity models that have been defined for the object types. Capacity Model Details for the Tenant Table 7 1. Capacity Model Table Container Usage Metric Demand Metric Capacity Metric memory allocation memory allocation memory allocation memory reserved memory usage memory usage memory usage memory reserved quota usage quota usage quota usage quota reserved storage allocation storage allocation storage allocation storage reserved storage usage storage usage storage usage storage reserved Capacity Model Details for the Reservation Table 7 2. Capacity Model Table Container Usage Metric Demand Metric Capacity Metric memory memory usage memory usage memory reserved quota quota usage quota usage quota reserved storage storage usage storage usage storage reserved Capacity Model for the Business Group Table 7 3. Capacity Model Table Container Usage Metric Demand Metric Capacity Metric memory allocation memory allocation memory allocation memory reserved memory usage memory usage memory usage memory reserved quota allocation quota allocation quota allocation quota reserved storage allocation storage allocation storage allocation storage reserved storage usage storage usage storage usage storage reserved VMware, Inc. 31

32 vrealize Automation Management Pack 2.0 Guide 32 VMware, Inc.

33 Troubleshooting the vrealize Automation Management Pack 8 Known troubleshooting information can help you to diagnose and correct problems with the vrealize Automation Management Pack. This chapter includes the following topics: Test Connection Fails and Results in a Time Synchronization Exception, on page 33 Virtual Machines Fail to Appear in Dashboards, on page 33 Determining classes to be enabled for debug logging while troubleshooting adapter collection issues, on page 34 Test Connection Fails and Results in a Time Synchronization Exception Problem When you configure the vrealize Automation Management Pack, test connection fails with a time synchronization error. Cause The time on the vrealize Operations Manager system is set to the wrong real time. Solution Verify that the time in the vrealize Operations Manager is synchronized to a valid Network Time Protocol (NTP) server and the time on the appliance is set to the correct real time. If vrealize Operations Manager is not configured to use an NTP server, then vrealize Operations Manager is synchronized with the host. In such a case, configure the host system to use an NTP server to get the correct time. Virtual Machines Fail to Appear in Dashboards Problem When you configure the vrealize Automation Management Pack, the dashboards do not display the virtual machines in the relationship tree. Cause If you delete the Managed Resources object, the vrealize Automation Management Pack re-creates the object. However the object is no longer used in the widgets. You must manually re-apply the filter in those widgets. VMware, Inc. 33

34 vrealize Automation Management Pack 2.0 Guide If you do not configure VMware vcenter adapters with the same endpoints that vrealize Automation uses, vrealize Operations Manager does not collect data for those hosts, clusters, datastores, and virtual machines. The hosts, clusters, datastores, and virtual machines are not displayed in the Managed Resources object. The VMware vcenter adapter brings in the objects and metric data from the VMware vcenter endpoint. The super user account that you require for the vrealize Automation Management Pack instance configuration, must have fabric group administrator rights for all fabric groups and tenants. If the super user account does not have these rights, information about virtual machines and reservation objects from vrealize Automation is not collected by the VMware vcenter adapter. Solution Verify the Environment Overview widget in the vrealize Automation Tenant Overview dashboard and the Cloud Infrastructure Health and Capacity Overview widget in the vrealize Automation Cloud Infrastructure Monitoring dashboard and ensure that the Managed Resources object is selected as a filter for all virtual machines, datastores, clusters, and hosts. Ensure that you configure a VMware vcenter adapter instance for each VMware vcenter endpoint that vrealize Automation also uses. Ensure that the super user account has the following rights: tenant administrator rights for all tenants, infrastructure administrator rights for all tenants, and fabric administrator rights for all fabric groups under all tenants. Determining classes to be enabled for debug logging while troubleshooting adapter collection issues Problem When you configure the vrealize Automation Management Pack, classes are not enabled for debug logging while troubleshooting adapter collection issues. Solution You can determine the classes that must be enabled for debug logging while troubleshooting adapter collection issues. These settings can be updated in the $ALIVE_BASE/user/conf/collector/log4j.properties file. To enable debugging for the vrealize Automation adapter, configure the log4j properties for the following classes of the collector: log4j.logger.com.vmware.adapter3.vcac.vcacadapter=debug log4j.logger.com.vmware.adapter3.vcac.impl.systeminfrastructureservice=debug log4j.logger.com.vmware.adapter3.vcac.impl.systemcafeservice=debug log4j.logger.com.vmware.adapter3.vcac.util.wapiworkitem=debug log4j.logger.com.vmware.adapter3.vcac.util.wapiresourcecollection=debug log4j.logger.com.vmware.adapter3.vcac.util.vcenterresolver=debug 34 VMware, Inc.

35 Index A access dashboards 17 alert definitions 21 B blueprint metrics 28 business group metrics 27 C capacity model 31 cloud infrastructure monitoring dashboard 18 configuration properties 14 configure the management pack 12, 23 D dashboards 17 definitions, alerts 21 deployment metrics 29 Determining classes to be enabled for debug logging 34 G glossary 5 reservation metrics 26 S security 8 Setting the collection time interval 13 T tag for filtering 29 tenant metrics 25 tenant overview dashboard 20 test connection fails 33 time synchronization exception 33 top-n dashboard 19 troubleshooting 33 Troubleshooting adapter collection issues 34 U updating management packs 14 V virtual machines fail to appear in the dashboards 33 I install the management pack 11 installing management packs 11 intended audience 5 introduction 7 introduction to the management pack 7 M management pack, adding 11 management packs installing 11 updating 14 O object types 7 objects and metrics 25 P Port Information 8 R relationship between objects types 7 VMware, Inc. 35