VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Xen Hypervisor User Guide
TABLE OF CONTENTS 1. Purpose... 3 2. Introduction to the Management Pack... 3 2.1 How the Management Pack Collects Data... 3 2.2 Data the Management Pack Collects... 3 2.3 Inventory Tree (Traversal Spec)... 3 3. Dashboards... 4 3.1 Xen Hypervisor Overview... 4 3.2 Xen Hypervisor Relationships... 5 3.3 Xen Hypervisor Host Details... 6 3.4 Xen Hypervisor VM Details... 7 4. Views... 8 5. Reports...10 6. Alerts...12 7. Actions...12 8. Analysis Badges...12 9. Troubleshooting the Management Pack...13 9.1 Troubleshooting an Adapter Instance...13 9.2 Testing Connection Failures...13 9.3 Viewing System Log Files...14 10. Appendix I: Metrics...15 11. Appendix II: Alerts...17 12. Appendix III: Capacity Definitions...17 NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it. You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: support@bluemedora.com. 2 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
1. Purpose The Blue Medora VMware vrealize Operations (vrops) Management Pack for Xen Hypervisor User Guide describes the primary features of the Management Pack for Xen Hypervisor, including dashboards, views, reports, alerts, and metrics that allow users to optimize the monitoring and management of Xen Hypervisor resources from within vrealize Operations. 2. Introduction to the Management Pack The Management Pack for Xen Hypervisor is an embedded adapter for vrealize Operations (vrops) that monitors Xen Hypervisor systems remotely to retrieve performance data regarding Xen Hypervisor resources. This section includes the following topics: How the Management Pack Collects Data Data the Management Pack Collects 2.1 How the Management Pack Collects Data During each data collection cycle, the Management Pack opens a Libvirt connection to the specified Xen Hypervisor host and queries it to retrieve resource metrics. The collection interval for the adapter instance resource determines how often the Management Pack collects data. The default collection interval is five minutes. 2.2 Data the Management Pack Collects The Management Pack can collect performance data, relationships (associations), and events for the following Xen Hypervisor resources: Figure 1: Xen Hypervisor Traversal Spec 1. Xen Hypervisor Host System 2. Xen Hypervisor Virtual Machine 3. Xen Hypervisor Network 4. Xen Hypervisor Storage Pool 5. Xen Hypervisor Storage Volume 2.3 Inventory Tree (Traversal Spec) The Inventory Tree (Traversal Spec) feature within vrops allows you to easily navigate your Xen Hypervisor environment. The hierarchical structure implicitly shows relationships among resource kinds and enables quick drill-downs to root-cause issues. 3 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
3. Dashboards Dashboards are the primary user interface that allow users to monitor Xen Hypervisor resources from within vrealize Operations. The following dashboards are available in the Management Pack: Xen Hypervisor Overview Xen Hypervisor Relationships Xen Hypervisor Host Details Xen Hypervisor VM Details 3.1 Xen Hypervisor Overview The Xen Hypervisor Overview dashboard displays heat maps depicting the overall health of Xen Hypervisor hosts, virtual machines, storage pools, storage volumes, and networks. Figure 2: Xen Hypervisor Overview Dashboard 4 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
3.2 Xen Hypervisor Relationships The Xen Hypervisor Relationships dashboard allows you to select a Xen Hypervisor resource from the Environment Overview to view key performance metrics, health, and relationships regarding that resource. Figure 3: Xen Hypervisor Relationships 5 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
3.3 Xen Hypervisor Host Details The Xen Hypervisor Host Details dashboard allows you to select a Xen Hypervisor Host to view alerts, memory, health, and relationship information about that resource. Figure 4: Xen Hypervisor Host Details Dashboard 6 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
3.4 Xen Hypervisor VM Details The Xen Hypervisor VM Details dashboard allows you to select a Xen Hypervisor Virtual Machine to view alerts, key metrics, health, and relationship information about that resource. Figure 5: Xen Hypervisor VM Details Dashboard 7 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
4. Views The vrops Management Pack for Xen Hypervisor contains custom views, which allow the user to view statistics of metrics for Xen Hypervisor resources. Views provide a big picture look at resources, as opposed to a more in depth view. Table 1: Xen Hypervisor Views VIEW TYPE DESCRIPTION Xen Hypervisor Host VMs, Storage and Network Count Xen Hypervisor Host CPU Usage (%) Distribution Xen Hypervisor Host Memory Usage (%) Distribution Xen Hypervisor Host - CPU Xen Hypervisor Host - Memory Xen Hypervisor Host Badge Analysis Summary Xen Hypervisor Storage Pool Badge Analysis Summary Xen Hypervisor Storage Pool Xen Hypervisor Network Badge Analysis Summary Distribution Distribution Xen Hypervisor Host Overview for VMs, storage, and network Xen Hypervisor Host CPU Usage (%) Distribution Xen Hypervisor Host Memory Usage (%) Distribution Provides a list of Xen Hypervisor Host - CPU information Provides a list of Xen Hypervisor - Memory information Provides a list of all the Xen Hypervisor Hosts with analysis answers for Anomalies, Workload, and Faults Provides list of all the Xen Hypervisor Storage Pools with analysis answers for Anomalies and Faults Provides a list of Xen Hypervisor Storage Pool information Provides a list of all the Xen Hypervisor Networks with analysis answers for Anomalies and Faults Xen Hypervisor VM - Memory Xen Hypervisor VM - Memory information Xen Hypervisor VM Badge Analysis Forecast Trend Xen Hypervisor VM Badge Analysis Summary Xen Hypervisor VM - CPU 12 week history and 30 day forecast of selected Virtual Machine with analysis answers for Anomalies and Faults Provides a list of all Xen Hypervisor VMs with analysis answers for Anomalies, Workload, and Faults Provides a list of Xen Hypervisor VM - CPU information 8 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
To access the Management Pack views, go to Environment > Xen Hypervisor and click the desired Object (resource kind). Select the Details tab, then Views. Select the desired view from the list to populate the statistics below. For the full list of views for the Management Pack, go to Home > Content > Views. Figure 6: Accessing Xen Hypervisor Views 9 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
5. Reports The vrops Management Pack for Xen Hypervisor contains the following custom reports. The reports can be exported and easily shared with key stakeholders in either.pdf or.csv formats. Table 2: Xen Hypervisor Reports REPORT Xen Hypervisor Host Report Xen Hypervisor Storage and Network Report Xen Hypervisor VM Report DESCRIPTION Provides a roll-up of the following counts for a certain host system: Number of persistent VMs Number of running VMs Number of total VMs Number of transient VMs Number of network filters Number of networks Number of storage pools Provides a roll-up of the following metrics for Xen Hypervisor storage and network resources: Storage anomalies Storage faults Storage allocation Storage available Storage capacity Number of storage volumes Network anomalies Network faults Provides a roll-up of the following Xen Hypervisor Virtual Machine metrics: Memory workload Allocated memory Maximum memory Used memory VM anomalies VM workload VM faults CPU workload CPU time Used CPU % 10 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
To access the Management Packs reports, go to Environment > Xen Hypervisor and click the desired Object (resource kind). Select the Reports tab, then Report Templates. To run the selected report, click the Run Template icon ( ). Figure 7: Accessing Xen Hypervisor Reports 11 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
6. Alerts The Management Pack for Xen Hypervisor pulls Xen Hypervisor database health indicators and displays them in vrealize Operations as alerts. The critical levels of each alert are closely mapped from Xen Hypervisor to vrops. Refer to 11. Appendix II: Alerts for the full list of alerts, symptoms, and recommendations provided by this Management Pack. 7. Actions The Management Pack for Xen Hypervisor uses the action framework in vrops to do power functions on your Xen Hypervisor virtual machines: Power On VM Power Off VM Shut Off VM Restart VM Figure 8: Available Actions for VMs 8. Analysis Badges Using the predictive analytics capabilities of the vrops Analysis Badges through capacity definitions, the Management Pack populates capacity and utilization breakdowns for Xen Hypervisor virtual machines and host systems. Refer to 12. Appendix III: Capacity Definitions for the list of capacity definitions. Figure 9: Analysis Badge Example 12 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
9. Troubleshooting the Management Pack Known troubleshooting information can help you diagnose and correct common problems with the Management Pack for Xen Hypervisor. This section includes the following topics: Troubleshooting an Adapter Instance Testing Connection Failures Viewing System Log Files 9.1 Troubleshooting an Adapter Instance Perform these general troubleshooting steps to diagnose and correct problems with an adapter instance: Edit the adapter instance and click Test Connection to verify the connection to vrops. Refer to section 9.2 Testing Connection Failures. View the collection status and collection state for the adapter instance resource on the Environment Overview page in vrops. Check the adapter and collector logs for errors. Refer to section 9.3 Viewing System Log Files, for details. 9.2 Testing Connection Failures When clicking Test Connection in the Manage Solution window after configuring an adapter instance, the following connection errors are possible. 9.2.1 Host Did Not Boot with Xen Hypervisor Error: Failed to connect to Xen Hypervisor host: internal error: libxenlight state driver is not active. Action: Ensure the host was started with Xen Hypervisor kernel. 9.2.2 Host Not Accessible / SSH Not Responding Error: Unable to establish a valid connection to the target system. Wait for response of task Test connection is timed out for collector vrealize Operations Manager Collector-Main. Action: Ensure the host is running and the IP address / hostname is correct. 9.2.3 SSH Key Not Installed on Xen Hypervisor Host Error: Unable to establish a valid connection to the target system. Failed to connect to Xen Hypervisor host: Cannot recv data: Host key verification failed.: Connection reset by peer. Action: Ensure the SSH key generated on the vrops box was copied successfully to the Xen Hypervisor host using ssh-copy-id user@xenhypervisor-host. 13 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
9.3 Viewing System Log Files You can view Xen Hypervisor adapter errors in the adapter and collector log files. You can view the adapter and collector log files in the vrops user interface or in an external log viewer. The adapter log files are in the $VCOPS_BASE/user/log/adapters/XenHypervisorAdapter/ folder. The collector log files are in the $VCOPS_BASE/user/log/ folder. The logging level is set to WARNING by default. To troubleshoot issues, set the logging level to INFO. To view detailed messages, including micro steps, queries, and returned results, set the logging level to DEBUG. You can set the base log level for the collector via Administrator -> Support -> Logs -> Select COLLECTOR folder -> Select Edit Properties icon -> Edit Root logger level. NOTE: If you set the logging level to DEBUG, log files can become large very quickly. Set the logging level to DEBUG only for short periods of time. For complete information about viewing log files and modifying log levels, refer to the vrops online help. 14 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
10. Appendix I: Metrics The Management Pack for Xen Hypervisor collects the following metrics by Xen Hypervisor Resource Kinds. NOTE: Due to libxl limitations, the metrics numcpus and totalcpupercentage for Xen Hypervisor Virtual Machines are not available. Table 3: Management Pack Metrics RESOURCE KIND RESOURCE GROUP RESOURCE ATTRIBUTE Xen Hypervisor Virtual Machine Configuration Name string Xen Hypervisor Virtual Machine Configuration Persistent integer Xen Hypervisor Virtual Machine Configuration OS Type string Xen Hypervisor Virtual Machine Configuration Architecture string Xen Hypervisor Virtual Machine CPU Information Used CPU float Xen Hypervisor Virtual Machine CPU Information Max CPU percent integer Xen Hypervisor Virtual Machine CPU Information VM CPU Time float Xen Hypervisor Virtual Machine Memory Information Maximum Memory integer Xen Hypervisor Virtual Machine Memory Information Allocated Memory integer Xen Hypervisor Virtual Machine Memory Information Used Memory integer Xen Hypervisor Virtual Machine Runtime Power State string Xen Hypervisor Virtual Machine Runtime State string Xen Hypervisor Virtual Machine Relationships Xen Hypervisor Host Parent string Xen Hypervisor Virtual Machine Storage IO Errors double Xen Hypervisor Virtual Machine Storage IO Read Requests double Xen Hypervisor Virtual Machine Storage IO Read Throughput double Xen Hypervisor Virtual Machine Storage IO Write Requests double Xen Hypervisor Virtual Machine Storage IO Write Throughput double Xen Hypervisor Virtual Machine Network IO Received Throughput double Xen Hypervisor Virtual Machine Network IO Received Dropped Packets double Xen Hypervisor Virtual Machine Network IO Received Packets double Xen Hypervisor Virtual Machine Network IO Received Errors double Xen Hypervisor Virtual Machine Network IO Sent Throughput double Xen Hypervisor Virtual Machine Network IO Sent Dropped Packets double Xen Hypervisor Virtual Machine Network IO Sent Packets double Xen Hypervisor Virtual Machine Network IO Sent Errors double Xen Hypervisor Host Configuration Name string Xen Hypervisor Host Configuration Total Running VMs integer Xen Hypervisor Host Configuration Total number of VMs integer Xen Hypervisor Host Configuration Total Persistent VMs integer ATTRIBUTE TYPE 15 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
RESOURCE KIND RESOURCE GROUP RESOURCE ATTRIBUTE Xen Hypervisor Host Configuration Total Transient VMs integer Xen Hypervisor Host Configuration Total Storage Pools integer Xen Hypervisor Host Configuration Total Networks integer Xen Hypervisor Host Configuration Total Network Filters integer Xen Hypervisor Host Configuration Architecture string Xen Hypervisor Host CPU Information Virtual CPUs integer Xen Hypervisor Host CPU Information CPU Cores integer Xen Hypervisor Host CPU Information CPU Sockets integer Xen Hypervisor Host CPU Information CPU Speed per Core integer Xen Hypervisor Host CPU Information Used CPU float Xen Hypervisor Host CPU Information Max CPU percent integer Xen Hypervisor Host CPU Information VM CPU Time float Xen Hypervisor Host Memory Information Maximum Memory integer Xen Hypervisor Host Memory Information Used Memory integer Xen Hypervisor Host Runtime Running VMs integer Xen Hypervisor Host Runtime Paused VMs integer Xen Hypervisor Host Runtime Blocked VMs integer Xen Hypervisor Host Runtime Crashed VMs integer Xen Hypervisor Host Runtime None VMs integer Xen Hypervisor Host Runtime Shutdown VMs integer Xen Hypervisor Host Runtime Shutoff VMs integer Xen Hypervisor Host Runtime Total VMs integer Xen Hypervisor Host Relationships Xen Hypervisor Hosts Parent string Xen Hypervisor Host Relationships Xen Hypervisor Virtual Machine Children Xen Hypervisor Host Relationships Xen Hypervisor Storage Pool Children ATTRIBUTE TYPE string string Xen Hypervisor Host Relationships Xen Hypervisor Network Children string Xen Hypervisor Storage Pool Configuration Name string Xen Hypervisor Storage Pool Configuration Volumes integer Xen Hypervisor Storage Pool Configuration Allocation integer Xen Hypervisor Storage Pool Configuration Available integer Xen Hypervisor Storage Pool Configuration Capacity integer Xen Hypervisor Storage Pool Configuration Allocation Percentage float Xen Hypervisor Storage Pool Configuration Persistent integer Xen Hypervisor Storage Pool Configuration Running integer Xen Hypervisor Storage Pool Configuration Accessible string 16 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
RESOURCE KIND RESOURCE GROUP RESOURCE ATTRIBUTE Xen Hypervisor Storage Pool Configuration State string Xen Hypervisor Storage Pool Relationships Xen Hypervisor Host Parent string Xen Hypervisor Storage Pool Relationships Xen Hypervisor Storage Volume Children ATTRIBUTE TYPE string Xen Hypervisor Storage Volume Configuration Name string Xen Hypervisor Storage Volume Configuration Path string Xen Hypervisor Storage Volume Configuration Allocation integer Xen Hypervisor Storage Volume Configuration Capacity integer Xen Hypervisor Storage Volume Relationships Xen Hypervisor Storage Pool Parent string Xen Hypervisor Network Configuration Name string Xen Hypervisor Network Configuration Bridge Name string Xen Hypervisor Network Configuration Persistent integer Xen Hypervisor Network Configuration Running integer Xen Hypervisor Network Relationships Xen Hypervisor Host Parent string 11. Appendix II: Alerts The vrops Management Pack for Xen Hypervisor creates alerts based on various symptoms that it detects in the environment. See the table below for details regarding each alert. Table 4: Management Pack Alerts NAME Virtual Machine State Blocked Virtual Machine State Crashed Storage Pool State Degraded SYMPTOM Virtual Machine State Blocked Virtual Machine State Crashed Storage Pool State Degraded 12. Appendix III: Capacity Definitions The Management Pack for Xen Hypervisor uses the following capacity definitions, which help determine the value of Analysis Badges for Xen Hypervisor virtual machines and host systems within vrealize Operations (refer to section 8. Analysis Badges ). Table 5: Capacity Definitions CONTAINER Xen Hypervisor Virtual Machine Memory CPU Xen Hypervisor Host System Memory CPU USE IN WORKLOAD? yes yes yes yes 17 Blue Medora VMware vrealize Operations Management Pack for Xen Hypervisor User Guide
You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: support@bluemedora.com. Copyright 2016 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions. The Xen Hypervisor name (including Xen Project Hypervisor) and logo are trademarks or registered trademarks of the Linux Foundation. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Blue Medora 3225 N Evergreen Dr. NE Suite 103 Grand Rapids, MI 49525 www.bluemedora.com