Pure Storage FlashArray Management Pack for VMware vrealize Operations Manager User Guide (Version 1.0.139 with Purity 4.9.x or higher)
Sunday, November 27, 2016 16:13
Pure Storage FlashArray Management Pack for VMware vrealize Operations Manager User Guide (Version 1.1) Contents Chapter 1: Introduction... 5 Overview... 5 About This Guide... 5 Audience... 5 Chapter 2: Before You Begin... 7 Verify the System Requirements... 7 Verify the User Privileges... 7 Chapter 3: Installation and Configuration... 9 Installing the Pure Storage FlashArray Solution... 9 Configuring a Pure Storage FlashArray Adapter Instance... 10 Chapter 4: Dashboards... 15 FlashArray Capacity Dashboards... 17 FlashArray Performance Dashboards... 24 FlashArray Capacity and Performance Metrics... 35 Chapter 5: Environment... 37 Launching the Purity GUI from vrealize Operations Manager... 42 Chapter 6: Alerts... 43 Chapter 7: Reports... 45 Sample Reports... 46 Chapter 8: Logs and Troubleshooting... 49 Viewing Pure Storage Adapter Log Events... 50 Login Permissions... 51 Appendix A: Use Case: Analyzing Array Capacity... 53 Appendix B: Pure Storage World Alerts List... 61 Appendix C: Legal Information... 67 End-User Agreement... 67 Notices... 67 Trademarks... 67 Copyright... 67 Page iii
Pure Storage FlashArray Management Pack for VMware vrealize Operations Manager User Guide (Version 1.1) Page iv
Introduction Overview Chapter 1. Introduction Overview VMware vrealize Operations, part of the VMware vrealize suite, provides a unified management experience for IT services on the VMware vcenter server. The Pure Storage FlashArray Management Pack for VMware vrealize Operations Manager helps VMware administrators gain better insight into the health of the Pure Storage arrays in a VMware context so that they are able to assess the health of the environment and identify problems and risks. The management pack provides a comprehensive view of the Pure Storage arrays, including their storage object data, capacity and performance statistics, and alerts in the vrealize monitoring environment. The management pack is available through the VMware Solution Exchange and does not require any special licenses. Installing the management pack involves installing the Pure Storage FlashArray solution and then configuring a Pure Storage FlashArray adapter instance for each FlashArray to be monitored. Once configured, the Pure Storage FlashArray adapter begins to query Purity to collect FlashArray object data and alert information. After the data has been pulled into vrealize Operations Manager, the information can be used to analyze capacity and performance statistics, determine the health of the array objects, determine any risks, forecast growth, generate custom workloads, and analyze alerts. About This Guide This document provides an overview of the features available in the Pure Storage FlashArray Management Pack. Audience This document is intended for administrators who use vrealize Operations Manager with virtual machines hosted on Pure Storage FlashArrays. Page 5
Introduction Audience Page 6
Before You Begin Verify the System Requirements Chapter 2. Before You Begin Before you install and configure the Pure Storage FlashArray Management Pack, review the release notes, verify that your system meets the minimum requirements, and verify that you have the appropriate privileges to perform the installation. Verify the System Requirements Verify the VMware vrealize Operations Manager version. vrealize Operations Manager (Advanced or Enterprise Edition) 6.0 version is required. For more information about the VMware vrealize Operations Manager, refer to the VMware vrealize Operations Manager Documentation website. Verify the Purity version installed on your FlashArray. Purity 4.0.7 or later version is required. In IPv6 environments, Purity 4.9.0 or higher is required. Determine the Purity version through the Purity GUI (System > Configuration > Array) or Purity CLI (purearray list command.) For more information about the Purity system, refer to the Purity 4.x FlashArray User Guide in the Pure Storage Support Knowledge Base at http://community.purestorage.com. Verify the User Privileges You must have the following credentials to install and configure the management pack: On vrealize Operations Manager, verify that you have virtual infrastructure administrator privileges. These credentials are required to install and configure the management pack on the vrealize Operations Manager server. On each Pure Storage FlashArray, verify that you have a Purity user account with at least readonly privileges. These credentials are required to collect data from the FlashArray. Note: The Purity user account can be either a local FlashArray administrator such as pureuser or a Purity user enabled through a directory service such as Microsoft Active Directory or OpenLDAP. You must have vrealize adminstrator privileges to view the adapter in the vrealize Solutions tab. Page 7
Before You Begin Verify the User Privileges Page 8
Installation and Configuration Installing the Pure Storage FlashArray Solution Chapter 3. Installation and Configuration Installing the Pure Storage FlashArray Solution Install the Pure Storage FlashArray solution by adding the Pure Storage FlashArray management pack to your vrealize Operations Manager server. To install the Pure Storage FlashArray for vrealize Operations solution: 1. Navigate to the VMware Solution Exchange website and download the Pure Storage FlashArray Management Pack to a temporary folder on your local machine. 2. Log in to vrealize Operations Manager. 3. In the left pane of the home page, select Administration. The Administration page appears. 4. On the Solutions tab, click the Add (+) button on the toolbar. The Add Solution wizard appears. 5. Complete the following steps in the Add Solution wizard: a. Click Browse a solution, navigate to the location of the PureStorageAdapter<version>.pak file, select it, and click Open. b. Click Upload. c. Once vrealize Operations Manager has successfully uploaded the Pure Storage FlashArray management pack, click Next. The End User License Agreement appears. d. Read the end user agreement and then select the check box to accept the terms of the agreement. e. Click Next to begin the installation process. The Install Solution screen appears and vrealize Operations Manager immediately begins installing the Pure Storage FlashArray management pack. f. After the installation is complete, click Finish to close the installer. 6. To confirm that the solution has been successfully installed, on the Solutions tab, verify that the Pure Storage FlashArray management pack appears in the list of solutions. Page 9
Installation and Configuration Configuring a Pure Storage FlashArray Adapter Instance Configuring a Pure Storage FlashArray Adapter Instance Configure a Pure Storage FlashArray adapter to allow vrealize Operations Manager to collect capacity data, performance data, alerts, and other information from the FlashArrays. Configure a Pure Storage FlashArray adapter instance for each FlashArray you want to monitor in the vrealize Operations Manager. The following steps require a Purity login username and password. To add and/or configure a Pure Storage FlashArray adapter instance in vrealize Operations: 1. Log in to the vrealize Operations Manager user interface. 2. In the left pane of the home page, select Administration. The Administration page appears. 3. On the Solutions tab, select the Pure Storage FlashArray solution and click the Configure (gears) button on the toolbar. The Manage Solution - Pure Storage FlashArray wizard appears. 4. On the lower pane toolbar, select one of the following two options: To add a new adapter instance, click the Add (+) button. To configure an existing adapter instance, select the instance name. 5. Complete the following fields in the Adapter Settings section: Page 10
Installation and Configuration Configuring a Pure Storage FlashArray Adapter Instance Display name. Enter a display name for the adapter instance. For example, Pure Storage Adapter. Description. Optionally enter a description of the adapter instance. FlashArray Hostname. Enter the fully-qualified domain name (FQDN) or IP address of the FlashArray that resolves to or is the virtual IP address of the FlashArray. Note: In IPv6 environments, if the IP address is used, it must be entered with square brackets. For example: [2015:0db8:85a3:0042:1000:8a2e:0360:2037] Credential. Specify the credential name used to log in to the FlashArray. If the credential name does not exist, create a new credential name by clicking the Add New button and completing the following fields in the Manage Credential pop-up window: Credential Name. Enter a unique credential name used to identify the FlashArray login credentials. FlashArray Username. Type the FlashArray user name. The user must have at least read-only privileges on the array. For example, pureuser. FlashArray Password. Type the password for the FlashArray user. 6. Click Test Connection to test the connection between the new adapter instance and the FlashArray. 7. Optionally configure the fields in the Advanced Settings section. The Advanced Settings options include: Collector. The vrealize Operations Manager collector that is used to manage the Pure Storage Adapter processes. Auto Discovery. Determines how the Pure Storage adapter discovers the FlashArray objects after the initial adapter configuration. If set to true (default), the Pure Storage adapter automatically discovers any new objects that have been added to the FlashArray after the initial adapter configuration and collects data for the new objects. If set to false, the Pure Storage adapter does not discover FlashArray objects. Instead, you must manually select which objects you want vrealize Operations Manager to monitor. Filter by vsphere. Determines how the Pure Storage adapter handles FlashArray objects that do not correspond to a vsphere datastore object. If set to true (default), the Pure Storage adapter only displays FlashArray objects that map to a vsphere datastore object. If set to false, the Pure Storage adapter displays all FlashArray resources, including those that are not mapped to vsphere datastore objects. 8. Click Save Settings. The FlashArray certificate details appear. 9. Read the certificate details. If you trust the certificate, select the check box to accept it and click OK to save the adapter instance settings. Page 11
Installation and Configuration Configuring a Pure Storage FlashArray Adapter Instance 10. Click Close. The new or modified adapter instance and its details appear in the Pure Storage FlashArray Solution Details pane. vrealize Operations Manager immediately begins collecting FlashArray object data and alert information. Page 12
Installation and Configuration Configuring a Pure Storage FlashArray Adapter Instance Approximately five minutes after the installation has completed, the status of the PureStorageAdapter solution changes to the Collection State of "Collecting" and Collection Status of "Data receiving." This verifies that the adapter instance has been correctly installed and configured. Page 13
Installation and Configuration Configuring a Pure Storage FlashArray Adapter Instance Page 14
Dashboards Chapter 4. Dashboards The FlashArray dashboards provide a birds-eye view into the capacity and performance details of various FlashArray objects across multiple arrays, giving administrators the ability to monitor trends and troubleshoot problems with the FlashArray resources. Through the dashboards, administrators can monitor trends and troubleshoot problems with the FlashArray resources and quickly determine if an issue is isolated to, say, a particular virtual machine, or one that is more wide-scale across the environment. The Pure Storage FlashArray adapter pulls FlashArray data into vrealize Operations Manager every five minutes. Therefore, the FlashArray information displayed in vrealize Operations Manager can lag up to five minutes behind the real-time data displayed in the Purity GUI. The management pack includes two preconfigured FlashArray dashboards - FlashArray Capacity and FlashArray Performance. To see the Pure Storage dashboards, from the vrealize Operations Manager home page, select Dashboard List > FlashArray. Page 15
Dashboards The following FlashArray dashboard tabs appear along the top of the right pane: FlashArray Capacity. Displays FlashArray capacity metrics and historical trends. FlashArray Performance. Displays FlashArray performance information. Each FlashArray dashboard is comprised of a collection of widgets, each of which provide specific capacity or performance information. All vrealize Management Operations dashboards are highly customizable. Widgets can be created, shifted around, or deleted, and the details within each widget can be modified. By default the dashboard refresh rate is 300 seconds. Since the adapter collects FlashArray data every five minutes, it is not beneficial to set the dashboard refresh rate frequency to a value that is less than the default rate of 300 seconds. Page 16
Dashboards FlashArray Capacity Dashboards FlashArray Capacity Dashboards The FlashArray Capacity dashboard displays capacity and storage information across all FlashArrays to help administrators monitor consumption levels. For example, the FlashArray Capacity Colored by Utilization (%) heat map widget displays a map of all arrays to help administrators quickly determine how large each array is relative to the other arrays, and how close an array is to reaching full capacity. FlashArray Capacity Colored by Utilization (%) Widget Type: Heat map. Object Type: Pure Storage FlashArray. Metrics: Sized by Total Space Available / Colored by Capacity Utilization. Purpose: Determine which arrays are near capacity. Each rectangle in the heat map represents an array in the Pure Storage World. The rectangle is sized by total physical usable space on the array relative to the other arrays, where the largest rectangle represents the array with the largest usable capacity. The rectangle is colored according to array fullness, represented by the percentage of the array's physical storage space occupied by reduced data and metadata. vrealize Operations Manager uses the most recently collected data to generate the heat map values. Click a rectangle and then click the Show Detail icon to drill down to the array details. Double-click a rectangle to view the details for the entire Pure Storage World. The widget is configured as a provider to the Capacity Utilization (%) - Historical Trend sparkline chart widget. Page 17
Dashboards FlashArray Capacity Dashboards Capacity Utilization (%) - Historical Trend Click one or more arrays in the FlashArray Capacity Colored by Utilization (%) widget to display the sparkline data. Widget Type: Sparkline. Object Type: Pure Storage FlashArray. Metrics: Capacity Utilization. Purpose: View array utilization over a specified time range. The sparkline is created by plotting the FlashArray data collected every five minutes over the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Volume Total Raw Space Used Colored by Volume Snapshot Percentage of Total Widget Type: Heat map. Object Type: FlashArray Volume. Metrics: Sized by Used Space / Colored by Snapshot Percent of Total Space. Purpose: Determine how much space you can reclaim by deleting the snapshots within a particular volume or by deleting the volume entirely. Each rectangle in the heat map represents a volume belonging to an array in the Pure Storage World. The rectangle is sized according physical space occupied by volume and snapshot data for the volume relative to the other volumes, where the largest rectangle represents the volume that takes up the largest amount of physical spaced occupied. vrealize Operations Manager uses the most recently collected data to generate the heat map values. Click a rectangle and then click the Show Detail icon to drill down to the volume details. Double-click a rectangle to view the details for the entire Pure Storage World. Page 18
Dashboards FlashArray Capacity Dashboards The rectangle is colored according to the volume's total space occupied by snapshot data. The widget is configured as a provider to the Volume Snapshot Percentage of Total Raw Space - Historical Trend sparkline chart widget. Volume Snapshot Percentage of Total Raw Space - Historical Trend Click one or more volumes in the Volume Total Raw Space Used Colored by Volume Snapshot Percentage of Total widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Snapshot Percent of Total Space. Purpose: View the percentage amount of physical space occupied by snapshot data over a specified time range. The sparkline is created by plotting the FlashArray data collected every five minutes over the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Top 25 Volumes by Raw Space Used (GB) Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Used Space. Purpose: View the top 25 volumes across all arrays in the Pure Storage World that occupy the largest amount of physical space that is not shared between volumes, excluding array metadata and snapshots. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. Page 19
Dashboards FlashArray Capacity Dashboards The widget is configured as a provider to the Volume Raw Space Used (GB) - Historical Trend sparkline chart widget. Volume Raw Space Used (GB) - Historical Trend Click one or more arrays in the Top 25 Volumes by Raw Space Used (GB) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Used Space. Purpose: View raw space usage for a Top 25 volume over a specified time range. The sparkline is created by plotting the FlashArray data collected every five minutes over the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Top 25 Hosts by Raw Space Used (GB) Widget Type: Top-N. Object Type: FlashArray Host. Metrics: Used Space. Purpose: View the top 25 hosts across all arrays in the Pure Storage World with the largest amount of physical space occupied by volume data that is not shared between volumes, excluding array metadata and snapshots. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. The widget is configured as a provider to the Host Raw Space Used (GB) - Historical Trend sparkline chart widget. Page 20
Dashboards FlashArray Capacity Dashboards Host Raw Space Used (GB) - Historical Trend Click one or more arrays in the Top 25 Hosts by Raw Space Used (GB) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Host. Metrics: Used Space. Purpose: View raw space usage for a Top 25 host over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Top 25 Volumes by Data Reduction Ratio Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Data Reduction. Purpose: View the top 25 volumes across all arrays in the Pure Storage World that have the highest data reduction ratios. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. Page 21
Dashboards FlashArray Capacity Dashboards Top 25 Volumes by Raw Snapshot Space (GB) Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Snapshot Space. Purpose: View the top 25 volumes across all arrays in the Pure Storage World that have the largest physical space occupied by data unique to one or more snapshots. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. Top 25 Volumes by Provisioned Space (GB) Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Provisioned Space. Purpose: View the top 25 volumes across all arrays in the Pure Storage World that have the largest provisioned sizes reported to hosts. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. Top 25 Hosts by Provisioned Space (GB) Widget Type: Top-N. Page 22
Dashboards FlashArray Capacity Dashboards Object Type: FlashArray Host. Metrics: Provisioned Space. Purpose: View the top 25 hosts across all arrays in the Pure Storage World that have the largest provisioned sizes reported by the volumes to which they are connected. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. Page 23
Dashboards FlashArray Performance Dashboards FlashArray Performance Dashboards The FlashArray Performance dashboard displays, at a glance, bandwidth, latency, and IOPS statistics to help administrators intelligently balance workloads. FlashArray Write Bandwidth Colored by Write Latency (μs) Widget Type: Heat map. Object Type: Pure Storage FlashArray. Metrics: Sized by Input Per Second / Colored by Write Latency. Purpose: Determine and analyze the write bandwidth and latency metrics across all arrays in the Pure Storage World. Each rectangle in the heat map represents an array in the Pure Storage World. The rectangle is sized by number of bytes written per second relative to the other arrays, where the largest rectangle represents the array with the highest bandwidth. The rectangle is colored according to write latency, measured in microseconds. vrealize Operations Manager uses the most recently collected data to generate the heat map values. Click a rectangle and then click the Show Detail icon to drill down to the array details. Double-click a rectangle to view the array details relative to the entire Pure Storage World. The widget is configured as a provider to the FlashArray Write Latency (μs) - Historical Trend sparkline chart widget. FlashArray Write Latency (μs) - Historical Trend Click one or more arrays in the FlashArray Write Bandwidth Colored by Latency (μs) widget to display the sparkline data. Page 24
Dashboards FlashArray Performance Dashboards Widget Type: Sparkline. Object Type: Pure Storage FlashArray. Metrics: Write Latency. Purpose: View write latency for the selected array over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. FlashArray Read Bandwidth Colored by Read Latency (μs) Widget Type: Heat map. Object Type: Pure Storage FlashArray. Metrics: Sized by Output Per Second / Colored by Read Latency. Purpose: Determine and analyze the read bandwidth and latency metrics across all arrays in the Pure Storage World. Each rectangle in the heat map represents an array in the Pure Storage World. The rectangle is sized by number of bytes read per second relative to the other arrays, where the largest rectangle represents the array with the highest bandwidth. The rectangle is colored according to read latency, measured in microseconds. vrealize Operations Manager uses the most recently collected data to generate the heat map values. Click a rectangle and then click the Show Detail icon to drill down to the array details. Double-click a rectangle to view the array details relative to the entire Pure Storage World. The widget is configured as a provider to the FlashArray Read Latency (μs) - Historical Trend sparkline chart widget. Page 25
Dashboards FlashArray Performance Dashboards FlashArray Read Latency (μs) - Historical Trend Click one or more arrays in the FlashArray Read Bandwidth Colored by Latency (μs) widget to display the sparkline data. Widget Type: Sparkline. Object Type: Pure Storage FlashArray. Metrics: Read Latency. Purpose: View read latency for the selected array over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Volume Write Bandwidth (MB/s) Colored by Write Latency (μs) Widget Type: Heat map. Object Type: FlashArray Volume. Metrics: Sized by Input Per Second / Colored by Write Latency. Purpose: Determine and analyze the write bandwidth and latency metrics for all volumes across all arrays in the Pure Storage World. Each rectangle in the heat map represents a volume belonging to an array in the Pure Storage World. The rectangle is sized by number of bytes written per second relative to the other volumes, where the largest rectangle represents the volume with the highest bandwidth. The rectangle is colored according to write latency, measured in microseconds. vrealize Operations Manager uses the most recently collected data to generate the heat map values. Page 26
Dashboards FlashArray Performance Dashboards Click a rectangle and then click the Show Detail icon to drill down to the volume details. Double-click a rectangle to view the volume details relative to the entire Pure Storage World. The widget is configured as a provider to the Volume Write Latency (μs) - Historical Trend sparkline chart widget. Volume Write Latency (μs) - Historical Trend Click one or more volumes in the Volume Write Bandwidth (MB/s) Colored by Write Latency (μs) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Write Latency. Purpose: View write latency for the selected volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Page 27
Dashboards FlashArray Performance Dashboards Volume Read Bandwidth (MB/s) Colored by Read Latency (μs) Widget Type: Heat map. Object Type: FlashArray Volume. Metrics: Sized by Output Per Second / Colored by Read Latency. Purpose: Determine and analyze the read bandwidth and latency metrics for all volumes across all arrays in the Pure Storage World. Each rectangle in the heat map represents a volume belonging to an array in the Pure Storage World. The rectangle is sized by number of bytes read per second relative to the other volumes, where the largest rectangle represents the volume with the highest bandwidth. The rectangle is colored according to read latency, measured in microseconds. vrealize Operations Manager uses the most recently collected data to generate the heat map values. Click a rectangle and then click the Show Detail icon to drill down to the volume details. Double-click a rectangle to view the volume details relative to the entire Pure Storage World. The widget is configured as a provider to the Volume Read Latency (μs) - Historical Trend sparkline chart widget. Volume Read Latency (μs) - Historical Trend Click one or more volumes in the Volume Read Bandwidth (MB/s) Colored by Read Latency (μs) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Read Latency. Page 28
Dashboards FlashArray Performance Dashboards Purpose: View read latency for the selected volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Top 25 Volumes by Write Latency (μs) Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Write Latency. Purpose: View the top 25 volumes across all arrays in the Pure Storage World with the fastest average arrival-to-completion time for a host write operation. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. The widget is configured as a provider to the Volume Write Latency (μs) - Historical Trend sparkline chart widget. Volume Write Latency (μs) - Historical Trend Click one or more volumes in the Top 25 Volumes by Write Latency (μs) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Write Latency. Purpose: View write latency for a Top 25 volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Page 29
Dashboards FlashArray Performance Dashboards Top 25 Volumes by Read Latency (μs) Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Read Latency. Purpose: View the top 25 volumes across all arrays in the Pure Storage World with the fastest average arrival-to-completion time for a host read operation. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. The widget is configured as a provider to the Volume Read Latency (μs) - Historical Trend sparkline chart widget. Volume Read Latency (μs) - Historical Trend Click one or more volumes in the Top 25 Volumes by Read Latency (μs) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Read Latency. Purpose: View read latency for a Top 25 volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Top 25 Volumes by Write Bandwidth (MB/s) Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Input Per Second. Page 30
Dashboards FlashArray Performance Dashboards Purpose: View the top 25 volumes across all arrays in the Pure Storage World with the highest number of bytes written per second. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. The widget is configured as a provider to the Volume Write Bandwidth (MB/s) - Historical Trend sparkline chart widget. Volume Write Bandwidth (MB/s) - Historical Trend Click one or more volumes in the Top 25 Volumes by Write Bandwidth (MB/s) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Input Per Second. Purpose: View write bandwidth for a Top 25 volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Page 31
Dashboards FlashArray Performance Dashboards Top 25 Volumes by Read Bandwidth (MB/s) Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Output Per Second. Purpose: View the top 25 volumes across all arrays in the Pure Storage World with the highest number of bytes read per second. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. The widget is configured as a provider to the Volume Read Bandwidth (MB/s) - Historical Trend sparkline chart widget. Volume Read Bandwidth (MB/s) - Historical Trend Click one or more volumes in the Top 25 Volumes by Read Bandwidth (MB/s) widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Output Per Second. Purpose: View read bandwidth for a Top 25 volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Top 25 Volumes by Writes Per Second Widget Type: Top-N. Object Type: FlashArray Volume. Page 32
Dashboards FlashArray Performance Dashboards Metrics: Writes Per Second. Purpose: View the top 25 volumes across all arrays in the Pure Storage World with the highest number of write requests processed per second. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. The widget is configured as a provider to the Volume Writes Per Second - Historical Trend sparkline chart widget. Volume Writes Per Second - Historical Trend Click one or more volumes in the Top 25 Volumes by Writes Per Second widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Writes Per Second. Purpose: View IOPS metrics for a Top 25 volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Top 25 Volumes by Reads Per Second Widget Type: Top-N. Object Type: FlashArray Volume. Metrics: Reads Per Second. Purpose: View the top 25 volumes across all arrays in the Pure Storage World with the highest number of read requests processed per second. The default time range of the Top-N graph is the last 30 days. The chart is created by calculating the average of all data points collected every 5 minutes over the last 30 days. Page 33
Dashboards FlashArray Performance Dashboards The widget is configured as a provider to the Volume Reads Per Second - Historical Trend sparkline chart widget. Volume Reads Per Second - Historical Trend Click one or more volumes in the Top 25 Volumes by Reads Per Second widget to display the sparkline data. Widget Type: Sparkline. Object Type: FlashArray Volume. Metrics: Reads Per Second. Purpose: View IOPS metrics for a Top 25 volume over a specified time range. The default time range of each graph is the last six hours. Click the Time Range icon to extend the time range to as far back as 1 year. Page 34
Dashboards FlashArray Capacity and Performance Metrics FlashArray Capacity and Performance Metrics All vrealize Manager Operations dashboards, including the FlashArray Capacity and FlashArray Performance dashboards, are highly customizable. Refer to the vrealize Operations Manager User Guide for general steps on how to customize dashboards. The following table lists the metrics used to build the FlashArray capacity widgets, and the resources to which each metric applies: Page 35
Dashboards FlashArray Capacity and Performance Metrics The following table lists the metrics used to build the FlashArray performance widgets, and the resources to which each metric applies: Page 36
Environment Chapter 5. Environment Once configured, the Pure Storage FlashArray adapter begins to query Purity and pull FlashArray volume, host, host group, and array-level data and alert information into vrealize Operations Manager. The information that is collected includes parent-child relationships within the Pure Storage World and vsphere World. The data is pulled via the Pure Storage REST API protocol, which is built directly into the adapter. Multiple collectors can be run simultaneously. The collection process repeats itself every five minutes. The collection interval cannot be changed. The Pure Storage FlashArray adapter pulls FlashArray data into vrealize Operations Manager every five minutes. Therefore, the FlashArray information displayed in vrealize Operations Manager can lag up to five minutes behind the real-time data displayed in the Purity GUI. After the data has been pulled into vrealize Operations Manager, the information can be used to analyze capacity and performance statistics, monitor the health of the array objects, determine risks, forecast growth, analyze alerts, and generate reports. The Environment page of the vrealize Operations Manager includes various areas to help you analyze the state of the environment and quickly identify and resolve issues. The Pure Storage FlashArray adapter includes the following inventory trees: Page 37
Environment To view the list of FlashArray resources in hierarchical format, select Environment > FlashArray Resources, and then click the arrow to the left of each resource in the hierarchy to expand it all the way down to the datastore level. Click Pure Storage World to see a list of object types within the Pure Storage World. The number associated with each object type represents the number of objects at that level from which data is being collected. Click the object type to view the list of objects in the bottom half of the left pane. For example, click Pure Volume to display all of the volumes on the FlashArrays from which data is being collected. Page 38
Environment The Pure Storage World includes the following FlashArray object types, listed from highest to lowest object: Click a specific FlashArray object, such as a host group name, to display its details in the right pane. Double-click a FlashArray object to make it the focus, and then choose the tabs within the Environment page to analyze the details of the object. Page 39
Environment The Summary tab provides you with an overall view of the Health and Risk levels for the selected object. In the following example, vrealize Operations Manager has determined, based on internal calculations, that volume mi-xd56-002 is in healthy and risk-free states. However, some of its related objects specifically, some of its datastores - are experiencing issues, as displayed in the Top Health Alerts For Descendants widget. Click any of the badges to jump to the Alerts tab and view any alerts directly related to the selected object. Click an alert message to drill-down to the alert details, which includes the alert description and tips on how to resolve the issue. Page 40
Environment The Environment tab helps you evaluate the health and risk of the selected object as it relates to the overall object hierarchy. For example, through the Environment > Overview tab, view the object relationships to determine how an object that is in a critical state might be affecting other objects. In the hierarchy, each badge represents an individual object. Click any object within the hierarchy to see all of its related objects across all levels within the Pure Storage World and vsphere World, mapped from the virtual machine level all the way up to the Pure Storage FlashArray level. The Overview tab view defaults to the Health badge type. Specify another badge type to see the state of all objects in that badge view. The following table outlines the possible relationships between the resources within the hierarchy: Refer to Appendix A for a sample use case that dives into the Environment page of vrealize Operations Manager. Page 41
Environment Launching the Purity GUI from vrealize Operations Manager Launching the Purity GUI from vrealize Operations Manager You can always view capacity and performance metrics and alerts for a specific FlashArray in real time through the Purity GUI. To launch the Purity GUI in a separate browser tab, highlight any FlashArray resource and then select Actions > Open FlashArray in Browser. View the capacity and performance metrics through the Dashboard, Storage, Protection, and Analysis tabs. View the alerts through the Messages tab. Page 42
Alerts Chapter 6. Alerts Alerts help identify problem areas in the vrealize Operations environment. The Pure Storage FlashArray management pack includes preconfigured alerts, many of which are closely mapped to the alerts generated through the Purity array. vrealize Operations Manager leverages these alerts to analyze the all of the objects within the Pure Storage World hierarchy and generate health and risk alerts for problems areas. Health alerts mainly focus on FlashArray problems. For example, a health alert is generated when vrealize Operations Manage detects a disconnected cable or drive failure. Health alerts require immediate attention. Risk alerts mainly focus on capacity. For example, a risk alert is generated when vrealize Operations Manager detects that storage consumption has reached a high percentage of usable capacity. Alerts are further organized by criticality levels which indicate the current operational state of each object and whether any problems must be addressed. Alert criticality is quickly identifiable based on badge color and is divided into the following levels: INFO (no badge color): Informational messages that are generated due to a change in state. INFO messages can be used for reporting and analysis purposes. No action is required. WARNING (yellow): Important messages that warn of an impending error if action is not taken. IMMEDIATE (orange): Important messages that require attention. CRITICAL (red): Urgent messages that require immediate attention. Page 43
Alerts To see the list of preconfigured alerts for the Pure Storage FlashArray, select Content > Alert Definitions. The preconfigured alerts are categorized under adapter type PureStorageAdapter. Refer to Appendix B for a full list of Pure Storage World alerts and their descriptions. Page 44
Reports Chapter 7. Reports Generate vrealize Operations Manager reports to capture data at a specific point in time and display the output in PDF or CSV format for further analysis. vrealize Operations Manager includes a library of report templates you can use to generate reports. Reports can be generated on demand or configured to automatically generate at scheduled intervals. To see a full list of report templates, select Content > Reports. A list of Report Templates appears in the right pane. Click the Generated Reports tab to view a list reports that have been generated. Click the PDF of CSV icon next to any generated report to view the report output. The vrealize Manager Operations reports are highly customizable. For example, you can create report templates to display specific FlashArray resource information. Refer to the vrealize Operations Manager Customization and Administration Guide for general steps on how to customize reports. Page 45
Reports Sample Reports Sample Reports In the following examples, two report templates are created to display various FlashArray capacity and performance metrics. Displaying Raw Space Usage for all FlashArray Volumes To create a report template that displays a list of FlashArray volumes sorted in descending order by raw space used, specify the following report configurations: Name and Description Specify a name and description for the report template. Views Create a new List view with the following settings: Name and Description: Name and description of the list. Presentation: List. Subjects: Pure Volume. Data: Capacity Used Space. Formats Customize with your preferences. Layout Options Customize with your preferences. Here is a sample PDF output of the report: Page 46
Reports Sample Reports Page 47
Reports Sample Reports Displaying Performance Metrics for all FlashArray Volumes To create a report template that displays a list of bandwidth, IOPS, and latency metrics for all FlashArray volumes, sorted in descending order by input per second, specify the following report configurations: Name and Description Specify a name and description for the report template. Views Create a new List view with the following settings: Name and Description: Name and description of the list. Presentation: List. Subjects: Pure Volume. Data: Performance Input Per Second (and configure sort order to "Descending"), Performance Output Per Second, Performance Reads Per Second, Performance Writes Per Second, Performance Read Latency, Performance Write Latency. Formats Customize with your preferences. Layout Options Customize with your preferences. Here is a sample PDF output of the report: Page 48
Logs and Troubleshooting Chapter 8. Logs and Troubleshooting vrealize Operations Manager records adapter events, metrics, and errors through the adapter and collector log files. Diagnostic information for the Pure Storage adapter is stored in the collector.log file. The file contains information such as data collection and FlashArray connection details. The Pure Storage adapter is constantly collecting FlashArray data. As such, the PureStorageAdapter solution should always in be a Collection State of "Collecting" and a Collection Status of "Data receiving." If the PureStorageAdapter solution is not in those states, check the collector.log file to diagnose the problem. In the collector.log file, PureStorageAdapter events are identified by the com.purestorage.vrops.adapter.purestorageadapter method. Page 49
Logs and Troubleshooting Viewing Pure Storage Adapter Log Events In the following example, PureStorageAdapter starts the data collection cycle for FlashArray pure-c35 at 01:14:42: As the data is being collected and reported to vrealize Operations Manager, PureStorageAdapter connects the objects within and between FlashArray pure-c35 and its datasources in vsphere World: The PureStorageAdapter data collection cycle ends at 01:14:51, taking 8713 ms to complete. The data collection cycle repeats itself every five minutes. Viewing Pure Storage Adapter Log Events To view the collector.log details: 1. In the left pane, click Administration. 2. Select Support > Logs. 3. Double-click the COLLECTOR folder. 4. In the COLLECTOR folder, double-click the collector.log file. PureStorageAdapter events are identified by the com.purestorage.vrops.adapter.purestorageadapter method. Page 50
Logs and Troubleshooting Login Permissions Login Permissions Issue: Adapter is installed but does not appear in the vrealize Solutions tab. Solution: Verify that you have the correct set of permissions to view the adapter. Log in with a vrealize administrator account. Page 51
Logs and Troubleshooting Login Permissions Page 52
Use Case: Analyzing Array Capacity Appendix A. Use Case: Analyzing Array Capacity As the storage administrator, you must monitor the FlashArrays to ensure that capacity and performance metrics stay within safe ranges, and address alerts as they arise. In this use case, we dive into vrealize Operations Manager to examine the details behind an array that has reached a critically high capacity level. In the FlashArray Capacity Colored by Utilization heat map widget of the FlashArray Capacity dashboard, notice that pure-ha111 array is nearing full capacity, as indicated by the red color. Hover over the array rectangle to view capacity details. Click the rectangle for pure-ha111 to display the capacity utilization trendline in the Capacity Utilization (%) - Historical Trend sparkline widget. Analyze the capacity utilization trend over the past six months (default). Page 53
Use Case: Analyzing Array Capacity In the Capacity Utilization (%) - Historical Trend sparkline widget, click the Time Range icon and change the time range of the trendline from "Last 6 hours" to Last 7 days. Notice that capacity has been steadily increasing over the past week. In the heat map, select the pure-ha111 rectangle and then click the Show Detail icon to shift the focus of vrealize Operations Manager to the pure-ha111 array environment. In the Summary tab, view the Health and Risk badges and their active alerts. The Health and Risk badges are colored based on the criticality of the triggered symptoms for the Pure Storage World object types, ranging from green representing no triggered standards through red representing at least one issue. The Health badge is green in color, meaning that array pure-ha111 is healthy with no triggered alerts. However, the array s Risk badge is red in color, which indicates that array capacity is at risk with at least one of the most critical triggered standards is at Critical level. The Top Alerts widgets list the alerts that are most likely to negatively affect your environment. In this example, the Top Health Alerts and Top Risk Alerts widgets display the alerts at the pureha111 level that are most likely to impact the Health and Risk badge colors, respectively. Page 54
Use Case: Analyzing Array Capacity Click any alert name to drill-down to the alert details. In this example, click the most critical alert to analyze the risk details for pure-ha111. You can also analyze the alert details through the Purity GUI by selecting Actions > Open FlashArray in Browser to launch the system in a separate tab. In the Purity GUI, select Messages > Alerts. Page 55
Use Case: Analyzing Array Capacity Returning to the Summary tab of vrealize Operations Manager, click the Analysis tab to further analyze the details behind the Risk levels. For example, the Analysis > Workload tab displays the workload capacity and determine if resources need to be balanced. In this example, as indicated by the red-colored badge, workload on pure-ha111 is over its capacity, with demand hovering at 96% of full capacity. Consumption is at a critically high level. Immediate action is required. Page 56
Use Case: Analyzing Array Capacity Click the Analysis tab to further analyze the details behind the Risk levels. For example, the Analysis > Capacity Remaining tab displays the remaining capacity count, as calculated by vrealize Operations Manager and displayed as a percentage. In this example, the red badge indicates that pure-ha111 is expected to run out of capacity soon or has already run out of capacity. Looking further into the details, vrealize Operations Manager calculates that the array, in fact, has 0% of space remaining. This further confirms that consumption is at a critically high level and that immediate action is required. Page 57
Use Case: Analyzing Array Capacity You can analyze the same consumption details in real time through the Dashboard tab of the Purity GUI. In the following example, the metrics in the Capacity bar of the Purity GUI match closely to the metrics in vrealize Operations Manager. Since the Pure Storage adapter pulls the array data into vrealize Operations Manager every five minutes, the numbers between the two views will not be perfect matches. Page 58
Use Case: Analyzing Array Capacity Click the Environment tab, and then click the pure-ha111 object to highlight all of the objects within the hierarchy that are related to pure-ha111. Within the Environment tab, click the Risk badge to view the risk level of each object and confirm that the high risk level associated with pure-ha111 is not due to another related object. The following example shows that none of the objects related to pure-ha111 are at high risk level. Based on all of the metrics and scores you have analyzed, you can confirm that you must immediately address the capacity utilization issue, either by decreasing capacity (for example, by destroying and eradicating snapshots) or adding capacity (for example, through an additional storage shelf or an additional FlashArray). Page 59
Use Case: Analyzing Array Capacity Page 60
Pure Storage World Alerts List Appendix B. Pure Storage World Alerts List The following table lists the Pure Storage World alerts. Page 61
Pure Storage World Alerts List Page 62
Pure Storage World Alerts List Page 63
Pure Storage World Alerts List Page 64
Pure Storage World Alerts List Page 65
Pure Storage World Alerts List Page 66
Legal Information End-User Agreement Appendix C. Legal Information End-User Agreement End User Agreement [http://www.purestorage.com/agreements/pure_enduser_agreement.pdf] Notices No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or stored in a database or retrieval system for any purpose without the express written permission of Pure Storage, Inc. Pure Storage, Inc., reserves the right to make changes to this document at any time without notice and assumes no responsibility for its use. This document contains the most current information available at the time of publication. When new or revised information becomes available, this entire document will be updated and distributed to all registered users Trademarks Pure Storage, the Pure Storage Logo, FlashArray, and other Pure trademarks are the property of Pure Storage, Inc. VMware and vrealize are trademarks or registered trademarks of VMware Corporation in the United States, other countries, or both. Other trademarks are the property of their respective owners. Copyright Copyright 2016 Pure Storage, Inc. All rights reserved. Page 67
Pure Storage FlashArray Management Pack for VMware vrealize Operations Manager User Guide (Version 1.1) Page lxviii