Supported Versions
HPE-3PAR Web Services API version 1.6.2

Introduction

HPE-3PAR StoreServ Storage is a family of flash-optimized storage systems that offer automated provisioning. This offers an advanced storage solution that uses a multi-tenant ability that distributes the load dynamically depending on the requirements set by each tenant. In addition, this single tier-1 storage system architecture is designed for in-built data security and availability.

HPE-3PAR StoreServ Storage regulates and manages itself. The rate at which the storage resources are consumed is constantly monitored. Compaction technologies such as thin provisioning, thin deduplication, and thin reclamation are incorporated and fully automated in HPE-3PAR StoreServ Storage systems. Thin provisioning allows a volume to be created and made available as a Logical Unit Number (LUN) to a host without the need to dedicate physical storage until it is actually needed.

HPE-3PAR StoreServ Storage systems include hardware components that physically store your data and software applications that manage your data.

The HPE-3PAR StoreServ Storage system is composed of the following logical data layers:

  • Physical Disk (PD)
  • Chunklet
  • Logical Disk (LD)
  • Common Provisioning Group (CPG)
  • Virtual Volume (VV)

Hierarchy of HPE-3PAR resources:

HPE-3PAR Storage System
   - HPE-3PAR Common Provisioning Group
     - HPE-3PAR Storage Volume
       - HPE-3PAR VLUN
      - HPE-3PAR Physical Disk
      - HPE-3PAR Host
            - HPE-3PAR Port
                 - HPE-3PAR Port Device
                 - HPE-3PAR FC Switch

Pre-Requisites

  • OpsRamp Classic Gateway 12.0.1 and above.

Default monitoring configurations

HPE-3PAR has default Global Device Management Policies, Global Templates, Global Monitors, and Global metrics in OpsRamp. You can customize the default monitoring configurations as per your business use cases by cloning respective global templates and global Device Management Policies. OpsRamp recommends doing this activity before installing the application to avoid noise alerts and data.

  1. Default Global Device Management Policies available

OpsRamp has a Global Device Management Policy for each Native Type of HPE-3PAR. You can find those Device Management Policies at Setup -> Resources -> Device Management Policies -> Search with suggested names in global scope. Each Device Management Policy follows below naming convention:

{appName nativeType - version}

Ex : hpe-3par HPE-3PAR Storage System - 1 (i.e, appName = hpe-3par, nativeType = HPE-3PAR Storage System, version = 1)

  1. Default Global Templates available

OpsRamp has a Global template for each Native Type of HPE-3PAR. You can find these templates at Setup -> Monitoring -> Templates -> Search with suggested names in global scope. Each template follows below naming convention:

{appName nativeType 'Template' - version}

Ex : hpe-3par HPE-3PAR Storage System Template - 1 (i.e, appName = hpe-3par, nativeType = HPE-3PAR Storage System, version = 1)

  1. Default Global Monitors available

OpsRamp will have a Global Monitors for each Native Type which has monitoring support. We can find those monitors at Setup -> Monitoring -> Monitors -> Search with suggested names in global scope. Each Monitors follows below naming convention :

{monitorKey appName nativeType - version}

Ex : HPE-3PAR Storage System Monitor hpe-3par HPE-3PAR Storage System 1(i.e, monitorKey = HPE-3PAR Storage System Monitor, appName = hpe-3par, nativeType = HPE-3PAR Storage System, version = 1)

Configure and install the integration

  1. From All Clients, select a client.
  2. Go to Setup > Integrations and Apps.
  3. Click Manage Apps.
    Notes:
  • If there are already installed applications, it will redirect to the INSTALLED APPS page, where all the installed applications are displayed.
  • If there are no installed applications, it will navigate to the ADD APP page.
Hpe3par
  1. Click + ADD on the INSTALLED APP page. The ADD APP page displays all the available applications along with the newly created application with the version.
    Note: You can even search for the application using the search option available. Also you can use the All Categories option to search
Hpe3par
  1. Click ADD in the hpe-3par application.
  2. Select an existing registered profile, and click Next.
  3. In the Configurations page, click + ADD. The Add Configuration page appears.
  4. Enter the below mentioned BASIC INFORMATION:
FuntionalityDescription
NameEnter the name for the configuration.
IP Address/Host NameIP address/host name of the target.
PortPort

Example: You can enter 8080 as a port value.
CredentialsSelect the credentials from the drop-down list.
NoteClick + Add to create a credential.

Notes:

  • By default the Is Secure checkbox is selected.
  • Select the following:
    • App Failure Notifications: if turned on, you will be notified in case of an application failure that is, Connectivity Exception, Authentication Exception.
    • Event/Alert Polling: enables integrating third party alerts into OpsRamp using further configurations.
  • Below are the default values set for:
    • Event/Alert Severity Filter: provided severity alerts get integrated out of all possible alerts.
      • Default Values: FATAL,CRITICAL, MAJOR, MINOR.
      • Possible Values: FATAL, CRITICAL, MAJOR, MINOR, DEGRADED, INFORMATIONAL, DEBUG, UNKNOWN.
    • Event Category: only provided category alerts get generated out of possible values.
      • Category 1 is used to identify a lifecycle.
      • Category 2 is used to identify an alert.
      • Possible values of Event Category configuration property are 1,2.
    • Event/Alert Severity Mapping: enables you to map the severities between HPE-3PAR and OpsRamp as severities are predefined values in each system.
      • Default mappings: “FATAL”:“Critical”,“CRITICAL”:“Critical”,“MAJOR”:“Warning”,“MINOR”:“Warning”,“DEGRADED”:“Warning”,“INFORMATIONAL”:“Info”,“DEBUG”:“Info”,“UNKNOWN”:“Info”.

        Note: You can change it as per your business use cases at any point in time from the Configuration page.
  1. In the RESOURCE TYPE section, select:

    • ALL: All the existing and future resources will be discovered.
    • SELECT: You can select one or multiple resources to be discovered.
  2. In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:

    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
  3. Click ADD.
    The configuration is saved and displayed on the page.

Hpe3par

After saving the configuration, the resources are as specified in the configuration profile and monitoring templates.

The configuration is saved and displayed on the page.

View the HPE-3PAR details

The HPE-3PAR integration is displayed in the Infrastructure > Resources > Storage.

Hpe3par
Hpe3par

Supported metrics

Metric NamesMetric Display NameUnitDescription
hpe_3par_system_license_StateHPE 3 PAR System License StateEnabled or disabled state of individual license
Hpe_3par_system_node_online_statusHPE 3 PAR System Node Online StatusOnline or Offline status of individual node
hpe_3par_system_capacity_AllocatedMiBHPE 3 PAR System Allocated CapacityMiBTotal allocated capacity.
hpe_3par_system_capacity_UtilizationHPE 3 PAR System Capacity Utilization%System Capacity Utilization
hpe_3par_system_capacity_FailedMiBHPE 3 PAR System Failed CapacityMiBFailed capacity in MiB
hpe_3par_system_capacity_OverProvisionedVirtualSizeMiBHPE 3 PAR System OverProvisionedVirtualSize CapacityMiBSystem contains an over provisioned Virtual Size MiB.
hpe_3par_system_capacity_OverProvisionedUsedMiBHPE 3 PAR System OverProvisionedUsed CapacityMiBSystem contains an over provisioned used MiB.
hpe_3par_system_capacity_OverProvisionedAllocatedMiBHPE 3 PAR System OverProvisionedAllocated CapacityMiBSystem contains an over provisioned allocated MiB
hpe_3par_system_capacity_OverProvisionedFreeMiBHPE 3 PAR System OverProvisionedFree CapacityMiBSystem contains an over provisioned free MiB.
hpe_3par_cacheMemoryStatistics_HitIOHPE 3 PAR HitIO CacheMemoryStatisticspsecNumber of Read/Write I/Os per second where data is in cache
hpe_3par_cacheMemoryStatistics_MissIOHPE 3 PAR MissIO CacheMemoryStatisticspsecNumber of Read/Write I/Os per second where data is not in cache.
hpe_3par_cacheMemoryStatistics_AccessIOHPE 3 PAR AccessIO CacheMemoryStatisticspsecNumber of read/write I/Os per second.
hpe_3par_cacheMemoryStatistics_HitPctHPE 3 PAR HitPct CacheMemoryStatistics%Hits divided by accesses and displayed in percentage
hpe_3par_cacheMemoryStatistics_TotalAccessIOHPE 3 PAR TotalAccessIO CacheMemoryStatisticspsecNumber of total read and write I/Os per second.
hpe_3par_cacheMemoryStatistics_LockBulkIOHPE 3 PAR LockBulkIO CacheMemoryStatisticspsecNumber of pages modified per second by host I/O and written to disk by the flusher.
hpe_3par_cacheMemoryStatistics_PageStatesHPE 3 PAR PageStates CacheMemoryStatisticscountInformation on page states.
hpe_3par_cacheMemoryStatistics_DirtyPagesHPE 3 PAR DirtyPages CacheMemoryStatisticscountCurrent number of dirty cluster memory pages per device type class in the system.
hpe_3par_cacheMemoryStatistics_MaxDirtyPagesHPE 3 PAR MaxDirtyPages CacheMemoryStatisticscountMaximum allowed number of dirty cluster memory pages per device type class in the system.
hpe_3par_cacheMemoryStatistics_DelayAckPagesHPE 3 PAR DelayAckPages CacheMemoryStatisticscountNumber of delayed acknowledgments (per device type class) to the host in order to throttle the host IO writes due to cache resource constraints.
hpe_3par_cpuStatistics_UserPctHPE 3 PAR UserPct CpuStatistics%Percent of CPU time in user-mode.
hpe_3par_cpuStatistics_SystemPctHPE 3 PAR SystemPct CpuStatistics%Percent of CPU time in system-mode.
hpe_3par_cpuStatistics_IdlePctHPE 3 PAR IdlePct CpuStatistics%Percent of CPU time in idle.
hpe_3par_cpuStatistics_InterruptsPerSecHPE 3 PAR InterruptsPerSec CpuStatisticspsecNumber of interrupts per second
hpe_3par_cpuStatistics_ContextSwitchesPerSecHPE 3 PAR ContextSwitchesPerSec CpuStatisticspsecNumber of context switches per second.
hpe_3par_physicalDiskCapacity_AllocatedMiBHPE 3 PAR Allocated PhysicalDiskCapacityMiBAllocated physical disk capacity in the system
hpe_3par_physicalDiskCapacity_AllocatedUtilizationHPE 3 PAR Allocated PhysicalDiskCapacity Utilization%Allocated physical disk capacity utilization in the system
hpe_3par_physicalDiskCapacity_FailedMiBHPE 3 PAR Failed PhysicalDiskCapacityMiBFailed physical disk capacity in the system.
hpe_3par_physicalDiskStatistics_IOHPE 3 PAR IO PhysicalDiskStatisticspsecNumber of IO per second.
hpe_3par_physicalDiskStatistics_KBytesHPE 3 PAR KBytes PhysicalDiskStatisticsKBpsNumber of kilobytes per second
hpe_3par_physicalDiskStatistics_ServiceTimeMSxHPE 3 PAR ServiceTimeMS PhysicalDiskStatisticsmsNumber of kilobytes per second
hpe_3par_physicalDiskStatistics_IOSizeKBHPE 3 PAR IOSizeKB PhysicalDiskStatisticsKBIO size in kilobytes statistic data.
hpe_3par_physicalDiskStatistics_QueueLengthxHPE 3 PAR QueueLength PhysicalDiskStatisticsIO size in kilobytes statistic data.
hpe_3par_physicalDiskStatistics_BusyPctHPE 3 PAR BusyPct PhysicalDiskStatistics%Busy percentage
hpe_3par_physicalDiskSpacedata_NormalChunkletsHPE 3 PAR PhysicalDiskSpacedata NormalChunkletscountNormal chunklets data
hpe_3par_physicalDiskSpacedata_SpareChunkletsHPE 3 PAR PhysicalDiskSpacedata SpareChunkletscountSpare chunklets data
hpe_3par_physicalDiskSpacedata_LifeLeftPctHPE 3 PAR PhysicalDiskSpacedata LifeLeftPct%Percentage of life left.
hpe_3par_physicalDiskSpacedata_TemperatureCHPE 3 PAR PhysicalDiskSpacedata TemperatureCCelsiusTemperature in Celsius.
hpe_3par_cpgSpaceData_TotalUsedSpaceMiBHPE 3 PAR CpgSpaceData Total Used SpaceMiBTotal Used CPG space in MiB
hpe_3par_cpgSpaceData_UserUsedSpaceMiBHPE 3 PAR CpgSpaceData User Used SpaceMiBUser Used CPG space in MiB
hpe_3par_cpgSpaceData_SnapUsedSpaceMiBHPE 3 PAR CpgSpaceData Snap Used SpaceMiBSnap Used CPG space in MiB
hpe_3par_cpgSpaceData_AdminUsedSpaceMiBHPE 3 PAR CpgSpaceData Admin Used SpaceMiBAdmin Used CPG space in MiB
hpe_3par_cpgSpaceData_TotalUsedSpaceUtilizationHPE 3 PAR CpgSpaceData Total Used Space Utilization%Total Used CPG space Percentage
hpe_3par_cpgSpaceData_UserUsedSpaceUtilizationHPE 3 PAR CpgSpaceData User UsedSpace Utilization%User Used CPG space Percentage
hpe_3par_cpgSpaceData_SnapUsedSpaceUtilizationHPE 3 PAR CpgSpaceData Snap Used Space Utilization%Snap Used CPG space Percentage
hpe_3par_cpgSpaceData_AdminUsedSpaceUtilizationHPE 3 PAR CpgSpaceData Admin Used Space Utilization%Admin Used CPG space Percentage
hpe_3par_cpgSpaceData_base_PrivateSpaceMiBHPE 3 PAR CpgSpaceData Base Private SpaceMiBBase Private CPG space in MiB
hpe_3par_cpgSpaceData_snapshot_PrivateSpaceMiBHPE 3 PAR CpgSpaceData Snapshot Private SpaceMiBSnapshot Private CPG space in MiB
hpe_3par_cpgSpaceData_GrowthMiBHPE 3 PAR CpgSpaceData GrowthMiBCPG space increases in MiB
hpe_3par_cpgSpaceData_DeduplicationGcKBPSHPE 3 PAR CpgSpaceData Deduplication GcKBpsDeduplication Garbage Collector in KBPS.
hpe_3par_cpgSpaceData_CapacityEfficiencyHPE 3 PAR CpgSpaceData CapacityEfficiencyCapacity efficiency attributes.
hpe_3par_cpgStatistics_IOHPE 3 PAR IO CpgStatisticspsecNumber of IO per second, which includes read, write, and total.
hpe_3par_cpgStatistics_IOHPE 3 PAR IO CpgStatisticsKBpsNumber of IO per second, which includes read, write, and total.
hpe_3par_cpgStatistics_KbytesHPE 3 PAR Kbytes CpgStatisticsKBpsNumber of kilobytes per second, which includes read, write, and total.
hpe_3par_cpgStatistics_ServiceTimeMSHPE 3 PAR ServiceTimeMS CpgStatisticsmsService time in ms, which includes read, write, and total.
hpe_3par_cpgStatistics_IOSizeKBHPE 3 PAR IOSizeKB CpgStatisticsKBObject IO size in kilobytes, which includes read, write, and total.
hpe_3par_cpgStatistics_QueueLengthHPE 3 PAR QueueLength CpgStatisticsQueue length
hpe_3par_cpgStatistics_BusyPctxHPE 3 PAR BusyPct CpgStatistics%Queue length
hpe_3par_cpg_StateHPE 3 PAR CPG StateOverall state of the CPG.
hpe_3par_portStatistics_SpeedHPE 3 PAR Speed PortStatisticsPort speed.
hpe_3par_portStatistics_IOHPE 3 PAR IO PortStatisticspsecNumber of IO per second.
hpe_3par_portStatistics_KBytesHPE 3 PAR KBytes PortStatisticsKBpssNumber of kilobytes per second
hpe_3par_portStatistics_ServiceTimeMSHPE 3 PAR ServiceTimeMS PortStatisticsmsService time in millisecond statistic data.
hpe_3par_portStatistics_IOSizeKBHPE 3 PAR IOSizeKB PortStatisticsKBIO size in kilobytes statistic data.
hpe_3par_portStatistics_QueueLengthxHPE 3 PAR QueueLength PortStatisticsIO size in kilobytes statistic data.
hpe_3par_portStatistics_BusyPctHPE 3 PAR BusyPct PortStatistics%Busy percentage
hpe_3par_port_LinkStatexHPE 3 PAR Port LinkStateBusy percentage
hpe_3par_port_FailoverStateHPE 3 PAR Port FailoverStateThe state of the failover operation, shown for the two ports indicated in the N:S:P and Partner columns.
hpe_3par_volumeSpaceData_rawReserved_UserMiBxHPE 3 PAR User RawReserved VolumeSpaceDataMiBThe state of the failover operation, shown for the two ports indicated in the N:S:P and Partner columns.
hpe_3par_volumeSpaceData_rawReserved_SnapMiBHPE 3 PAR Snap RawReserved VolumeSpaceDataMiBRaw reserved snap space in MiB
hpe_3par_volumeSpaceData_rawReserved_AdminMiBHPE 3 PAR Admin RawReserved VolumeSpaceDataMiBRaw reserved admin space in MiB
hpe_3par_volumeSpaceData_rawReserved_TotalMiBHPE 3 PAR Total RawReserved VolumeSpaceDataMiBRaw reserved total space in MiB
hpe_3par_volumeSpaceData_userSpace_UsedMiBHPE 3 PAR Used UserSpace VolumeSpaceDataMiBUsed user space in MiB
hpe_3par_volumeSpaceData_userSpace_UsedUtilizationHPE 3 PAR Used UserSpace Utilization VolumeSpaceData%Used user space utilization
hpe_3par_volumeSpaceData_snapSpace_UsedMiBHPE 3 PAR Used SnapSpace VolumeSpaceDataMiBUsed snapshot space in MiB
hpe_3par_volumeSpaceData_snapSpace_UsedUtilizationHPE 3 PAR Used SnapSpace Utilization VolumeSpaceData%Used snapshot space utilization
hpe_3par_volumeSpaceData_snapSpace_VcopyMiBHPE 3 PAR Vcopy SnapSpace VolumeSpaceDataMiBSnapshot virtual copy space in MiB
hpe_3par_volumeSpaceData_adminSpace_UsedMiBHPE 3 PAR Used AdminSpace VolumeSpaceDataMiBUsed admin space in MiB
hpe_3par_volumeSpaceData_adminSpace_UsedUtilizationHPE 3 PAR Used AdminSpace Utilization VolumeSpaceData%Used admin space utilization
hpe_3par_volumeSpaceData_adminSpace_VcopyMiBHPE 3 PAR Vcopy AdminSpace VolumeSpaceDataMiBAdmin virtual copy space in MiB
hpe_3par_volumeSpaceData_totalSpace_UsedMiBHPE 3 PAR Used TotalSpace VolumeSpaceDataMiBTotal used space in MiB
hpe_3par_volumeSpaceData_totalSpace_UsedUtilizationHPE 3 PAR Used TotalSpace Utilization VolumeSpaceData%Total used space utilization
hpe_3par_volumeSpaceData_totalSpace_VcopyMiBHPE 3 PAR Vcopy TotalSpace VolumeSpaceDataMiBTotal virtual copy size in MiB
hpe_3par_volumeSpaceData_totalSpace_HostWriteMiBHPE 3 PAR HostWrite TotalSpace VolumeSpaceDataMiBSpace write to the host in MiB
hpe_3par_volumeSpaceData_CapacityEfficiencyxHPE 3 PAR VolumeSpaceData CapacityEfficiencySpace write to the host in MiB
hpe_3par_volumeSpaceData_CompressionGcKBPSHPE 3 PAR VolumeSpaceData CompressionGcKBPSKBpsCompression garbage collector in KBPS.
hpe_3par_volumeSpaceData_CompressionStateHPE 3 PAR VolumeSpaceData CompressionStateVolume detailed compression state.
hpe_3par_volume_StateHPE 3 PAR Volume StateState of the volume.
hpe_3par_volume_DeduplicationStateHPE 3 PAR Volume DeduplicationStateVolume detailed deduplication state.
hpe_3par_vlunstatistics_IOHPE 3 PAR IO VlunStatisticspsecNumber of IO per second.
hpe_3par_vlunstatistics_KBytesHPE 3 PAR KBytes VlunStatisticsKBpsNumber of kilobytes per second.
hpe_3par_vlunstatistics_ServiceTimeMSHPE 3 PAR ServiceTimeMS VlunStatisticsmsService time in millisecond statistic data.
hpe_3par_vlunstatistics_IOSizeKBHPE 3 PAR IOSizeKB VlunStatisticsKBIO size in kilobytes statistic data.
hpe_3par_vlunstatistics_QueueLengthHPE 3 PAR QueueLength VlunStatisticsQueue length
hpe_3par_vlunstatistics_BusyPctHPE 3 PAR BusyPct VlunStatistics%Busy percentage

Risks, Limitations & Assumptions

  • Application can handle Critical/Recovery failure notifications for below two cases when user enables App Failure Notifications in configuration:
    • Connectivity Exception
    • Authentication Exception
  • Application will not send any duplicate/repeat failure alert notification until the already existing critical alert is recovered.
  • Application cannot control monitoring pause/resume actions based on above alerts.
  • Metrics can be used to monitor HPE-3PAR resources and generate alerts based on the threshold values.
  • OpsRamp referred to HPE Support developer guide to implement discovery, monitoring and alerts polling of HPE-3PAR. Given that support to show disk information was added in WSAPI 1.6.15 release, OpsRamp will use Physical disk statistical data reports API when the WSAPI version is less than 1.6.15. For version greater than or equals to 1.6.15, OpsRamp will use Querying physical disk information API to get data.
    Note: Currently, there is no reference of Fan Speed, Temperature, Power related metrics within the developer guide.
  • As few of the HPE-3PAR components didn’t have direct name information in WSAPI responses, OpsRamp proceeded with below assumptions :
    • For Physical Disk Discovery, OpsRamp considered Physical disk ID (if WSAPI version is less than 1.6.15) OR WWN (if WSAPI version is greater than or equals to 1.6.15) as Resource Name in OpsRamp.
    • For Ports Discovery, OpsRamp considered portWWN (Port WWN will present for FCoE and FC ports only) OR port portPos (when portWWN was not present in response) as Resource Name in OpsRamp.
    • For VLUN Discovery, OpsRamp considered lun value as Resource Name in OpsRamp.
  • HPE-3PAR’s Event/Alert Polling will be started only if the user enables Event/Alert Polling in configuration.
  • Possible values of Event/Alert Severity Filter configuration property are FATAL, CRITICAL, MAJOR, MINOR, DEGRADED, INFORMATIONAL, DEBUG, UNKNOWN.
  • Possible values of Event Category configuration property are 1,2. Category 1 is used to identify a lifecycle event and 2 is used to identify an alert.
  • OpsRamp has given sample mappings to map HPE-3PAR Severity with OpsRamp Severities as part of the Event/Alert Severity Mapping configuration file. Users can modify them as per their use-case at any point of time from the application configuration page. Possible OpsRamp Severities are Critical, Warning, Ok, Info.