Introduction
The Hitachi Operations Center Analyzer detail view (Analyzer detail view) database is a high speed, size-optimized NoSQL database with extremely effective storage and retrieval capabilities. It has the capacity to store time series data with a fine precision for an extended duration, including minute-level data. An expressive, potent, and succinct query language can be used to query this data (MQL). MQL differs from the widely used Structured Query Language because of its distinctive design (SQL).
The Analyzer detail view REST API allows you to build an application around the Analyzer detail view database.
The following diagram shows the architecture of the Analyzer detail view REST API server.

Pre-requisites
- OpsRamp Classic Gateway 12.0.1 and above.
Hierarchy of Hitachi OpsCenter
Hitachi VSP Storage Array
• Hitachi VSP Cache
• Hitachi VSP Journal
• Hitachi VSP LDEV
• Hitachi VSP MPB
• Hitachi VSP Parity Group
• Hitachi VSP Pool
• Hitachi VSP Port
• Hitachi VSP Tier LDEV
• Hitachi VSP Tier Pool
Default monitoring configurations
Hitachi VSP OpsCenter Detailview has default Global Device Management Policies, Global Templates, Global Monitors and Global metrics in OpsRamp. Users can customize these default monitoring configurations as per their 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.
Default Global Device Management Policies
OpsRamp has a Global Device Management Policy for each Native Type of VSP OpsCenter Detailview. 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: hitachi-vsp-opscenter-detailview Hitachi VSP Port - 1 (i.e, appName = hitachi-vsp-opscenter-detailview, nativeType = Hitachi VSP Port, version = 1)
Default Global Templates
OpsRamp has a Global template for each Native Type of VSP OpsCenter Detailview. You can find those templates at Setup -> Monitoring -> Templates -> Search with suggested names in global scope. Each template follows below naming convention:
{appName nativeType 'Template' - version}
Ex: hitachi-vsp-opscenter-detailview Hitachi VSP Port Template - 1 (i.e, appName = hitachi-vsp-opscenter-detailview, nativeType = Hitachi VSP Port, version = 1)
Default Global Monitors available
OpsRamp has a Global Monitors for each Native Type which has monitoring support. You 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: Hitachi VSP Port Monitor hitachi-vsp-opscenter-detailview Hitachi VSP Port 1 (i.e, monitorKey = Hitachi VSP Port Monitor Monitor, appName = hitachi-vsp-opscenter-detailview, nativeType = Hitachi VSP Port, version = 1)
Configure and install the integration
- From All Clients, select a client.
- Go to Setup > Integrations and Apps.
- 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.

- Click + ADD on the INSTALLED APPS page. The AVAILABLE APPS 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.

- Click ADD in the Hitachi VSP Opcenter Detailview application.
- In the Configuration page, click + ADD. The Add Configuration page appears.
- Enter the below mentioned BASIC INFORMATION:
Functionality | Description |
---|---|
Name | Enter the name for the configuration. |
IP Address/Host Name | Enter the Host name or the IP address. |
Port | API Port information |
Serial Number | Enter the serial number. |
Credentials | Select the credentials from the drop-down list. Note: Click + Add to create a credential. |
Notes:
- By default the Is Secure checkbox is selected.
- Select App Failure Notifications: if turned on, you will be notified in case of an application failure that is, Connectivity Exception, Authentication Exception.
- Select the below mentioned CUSTOM ATTRIBUTE:
Functionality | Description |
---|---|
Custom Attribute | Select the custom attribute from the drop down list box. |
Value | Select the value from the drop down list box. |
Note: The custom attribute that you add here will be assigned to all the resources that are created by the integration. You can add a maximum of five custom attributes (key and value pair).
- 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.
- In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:
- Minutes
- Hourly
- Daily
- Weekly
- Monthly
- Click ADD.

- Now the configuration is saved and displayed on the configurations page after you save it.
Note: From the same page, you may Edit and Remove the created configuration. - Click NEXT.
- In the Installation page, select an existing registered gateway profile, and click FINISH.

The application is now installed and displayed on the Installed Integration page. Use the search field to find the installed application.
Modify the Configuration
See Modify an Installed Integration or Application article.
Note: Select the Hitachi VSP Opcenter Detailview application.
View the Hitachi VSP Opcenter Detailview details
The discovered resource(s) are displayed in Infrastructure > Resources > Hitachi VSP, with Native Resource Type as Hitachi VSP Storage Array. You can navigate to the Attributes tab to view the discovery details, and the Metrics tab to view the metric details for Hitachi VSP.


Supported Alert Custom Macros
- Customize the alert subject and description with below macros then it will generate alert based on customisation.
Supported macros keys:
${resource.name}
${resource.ip}
${resource.mac}
${resource.aliasname}
${resource.os}
${resource.type}
${resource.dnsname}
${resource.alternateip}
${resource.make}
${resource.model}
${resource.serialnumber}
${resource.systemId}
${Custome Attributes in the resource}
${parent.resource.name}
Supported Metrics
Component | Metric Names | Unit | Description |
---|---|---|---|
raidStorage | hitachivsp_raidStorage_writePending | MB | Of the cache memory, the cache memory size used by write pending data. |
hitachivsp_raidStorage_cacheUsage | MB | Of the cache memory in the storage system, the amount that is being used. | |
hitachivsp_raidStorage_sideFileUsage | MB | Of the cache memory, the cache memory size used by the side file. | |
hitachivsp_raidStorage_chaCachePathUsageRate | % | Average (%) of the access path usage rate in the device between the channel adapter and cache switch. | |
hitachivsp_raidStorage_dkaCachePathUsageRate | % | Average (%) of the access path usage rate in the device between the disk adapter and cache switch. | |
hitachivsp_raidStorage_transferRate | KB/sec | Transfer speed | |
hitachivsp_raidStorage_readTransRate | KB/sec | Read transfer speed | |
hitachivsp_raidStorage_writeTransRate | KB/sec | Write transfer speed | |
hitachivsp_raidStorage_totalIOPS | Operations/sec | Frequency of operations (number of times per second). | |
hitachivsp_raidStorage_readIOPS | Operations/sec | Frequency of read operations (number of times per second). | |
hitachivsp_raidStorage_writeIOPS | Operations/sec | Frequency of write operations (number of times per second). | |
hitachivsp_raidStorage_readHit | % | Cache hit rate of read operations. | |
raidPort | hitachivsp_raidPort_totalIOPS | Operations/sec | Average frequency of read and write operations for the storage system port (number of times per second). |
hitachivsp_raidPort_initiatorResponseTime | ms | Average processing time per read/write processing request for a storage system port (Initiator port value/External port value). | |
hitachivsp_raidPort_initiatorTotalIOPS | Operations/sec | Average frequency of read and write operations for a storage system port (number of operations per second) (Initiator port value/External port value). | |
hitachivsp_raidPort_initiatorTransferRate | KB/sec | Average transfer rate of read and write operations for a storage system port (Initiator port value/External port value). | |
hitachivsp_raidPort_maxIOPS | Operations/sec | Maximum frequency of read and write. | |
hitachivsp_raidPort_transferRate | KB/sec | Average read and write transfer speed for the storage system port. | |
hitachivsp_raidPort_maxTransferRate | KB/sec | Maximum read and write transfer speed for the storage system port Notes: If either of the following conditions is satisfied, the average value is used for this field when the data is stored in a record every minute or when the data is displayed as the real-time report:
| |
hitachivsp_raidPort_responseTime | ms | Average processing time per read/write processing request for a storage system port. | |
raidPool | hitachivsp_raidPool_tierRelocationProgressRate | % | Progress of tier relocation (%). Note: Depending on the current status of data placement among the tiers, the amount of time required for tier relocation (as predicted by the progress percentage) might not match the actual time required. |
hitachivsp_raidPool_totalPoolCapacityMB | MB | Virtual capacity of all Dynamic Provisioning VVOLs mapped to the pool. This value is not exactly the same as the device capacity information that is recognized by the host because this capacity information is managed by the storage system. | |
hitachivsp_raidPool_touchedCapacityInGB | GB | Amount of pool capacity that is actually being used. Notes:
| |
hitachivsp_raidPool_unTouchedCapacityInGB | GB | Unused capacity in the pool. Notes:
| |
hitachivsp_raidPool_subRate | % | Pool Subscription Rate Total Actual Capacity: Capacity of the pool. Note: If the pool contains a parity group whose drive type is FMC and also Accelerated Compression is enabled, the value is the amount that includes the capacity of the expanded area. Total Managed Capacity: Virtual capacity of all Dynamic Provisioning VVOLs mapped to the pool. Note: This value is not exactly the same as the device capacity information that is recognized by the host because this capacity information is managed by the storage system. | |
hitachivsp_raidPool_managedCapacityInGB | GB | Virtual capacity of all Dynamic Provisioning VVOLs mapped to the pool. Note: This value is not exactly the same as the device capacity information that is recognized by the host because this capacity information is managed by the storage system. | |
hitachivsp_raidPool_physicalcapacityInGB | GB | Total amount of the physical capacity of the parity groups that make up the pool. | |
hitachivsp_raidPool_percentUsageRate | % | Usage rate of the pool capacity. Note: This value is not exactly the same as the device capacity information that is recognized by the host because this capacity information is managed by the storage system. For the Dynamic Provisioning VVOLs for which pool areas are reserved, the percentage includes the capacity for the reserved pages. | |
hitachivsp_raidPool_percentUsedCapacity | % | Percentage of pool Used capacity Used Capacity: Amount of pool capacity that is actually being used. Note: This value is not exactly the same as the device capacity information that is recognized by the host because this capacity information is managed by the storage system. If the settings of the capacity saving function (dedupe and compression) are enabled, the amount is the amount actually used after the size of the capacity is reduced. Note that if the pool contains a parity group whose drive type is FMC and also Accelerated Compression is enabled, the value does not include the compressed amount. Total Actual Capacity: Capacity of the pool. Note: If the pool contains a parity group whose drive type is FMC and also Accelerated Compression is enabled, the value is the amount that includes the capacity of the expanded area. | |
hitachivsp_raidPool_transferRate | KB/sec | Total data transfer rate Read Xfer Rate: Total read data transfer rate for virtual volumes mapped to the Dynamic Provisioning pool Write xfer Rate: Total write data transfer rate for virtual volumes mapped to the Dynamic Provisioning pool Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_readTransRate | KB/sec | Total read data transfer rate for virtual volumes mapped to the Dynamic Provisioning pool. NotePerformance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_writeTransRate | KB/sec | Total write data transfer rate for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_readIOPS | Operations/sec | Frequency of read operations (times per second) for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_writeIOPS | Operations/sec | Frequency of write operations (times per second) for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_totalIOPS | Operations/sec | Frequency of operations (times per second) for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_readResponseTime | ms | Average processing time per read request for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_writeResponseTime | ms | Average processing time per write request for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_responseTime | ms | Read Response Time Rate: Average processing time per read request for virtual volumes mapped to the Dynamic Provisioning pool. Write Response Time Rate: Average processing time per write request for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_readKBPIO | KB/IO | Read transfer per operation Read Xfer Rate: Total read data transfer rate for virtual volumes mapped to the Dynamic Provisioning pool. Read IO Rate: Frequency of read operations (times per second) for virtual volumes mapped to the Dynamic Provisioning pool. | |
hitachivsp_raidPool_writeKBPIO | KB/IO | Write transfer per Operation Write Xfer Rate: Total write data transfer rate for virtual volumes mapped to the Dynamic Provisioning pool. Write IO Rate: Frequency of write operations (times per second) for virtual volumes mapped to the Dynamic Provisioning pool. | |
hitachivsp_raidPool_percentReadIOPS | % | Read IOPS Percentage Read IO Rate: Frequency of read operations (times per second) for virtual volumes mapped to the Dynamic Provisioning pool. Write IO Rate: Frequency of write operations (times per second) for virtual volumes mapped to the Dynamic Provisioning pool. Note: Performance values do not include information about virtual volumes that are used as S-VOLs of Thin Image. | |
hitachivsp_raidPool_dkcSavingCapacity | GB | Amount of the data is reduced when the capacity saving function (dedupe and compression) is used for pools. The amount is stored only when the capacity saving function (dedupe and compression) is enabled. In other cases, the amount is 0. | |
hitachivsp_raidPool_physicalCapacityUsed | GB | Total amount of used capacity in the physical capacity of the parity groups that make up the pool. Note: If the pool contains a parity group whose drive type is FMC and also Accelerated Compression is enabled, the value is the amount after compression. | |
hitachivsp_raidPool_physicalCapacityFree | GB | Total amount of free capacity in the physical capacity of the parity groups that make up the pool Note: If the pool contains a parity group whose drive type is FMC and also Accelerated Compression is enabled, the value is the amount after compression. | |
hitachivsp_raidPool_percentWriteIOPS | % | Frequency of read and write operations for each volume (number of operations per second). | |
hitachivsp_raidPool_physicalCapacityUsageRate | % | Usage percentage of the physical capacity of the parity groups that make up the pool. | |
hitachivsp_raidPool_poolCapacityGB | GB | Capacity of the pool (GB). This value is not exactly the same as the device capacity information that is recognized by the host because this capacity information is managed by the storage system. If the pool contains a parity group whose drive type is FMC and also Accelerated Compression is enabled, the value is the amount that includes the capacity of the expanded area. | |
hitachivsp_raidPool_movedPages | Number | Total number of moved pages. |
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
- If App Failure Notifications are enabled, an alert will be sent, however, either OpsCenter Detailview Gateway IP Address configurations or OpsCenter Detailview Manager IP Address configurations should be provided.
- 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 OpsCenter Detailview resources and can generate alerts based on the threshold values.
- OpsCenter Detailview Event/Alert polling will start only if the user enables Alert Polling in configuration. Possible values of Alert Severity Filter configuration property are ALERT_LOW,ALERT_MEDIUM,ALERT_HIGH.
- OpsRamp has given sample mappings to map OpsCenter Detailview Severity with OpsRamp Severities as part of 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.
- In OpsCenter Detailview, few resource names are null. For them, we are mapping id as resource name.
- Support for Macro replacement for threshold breach alerts (i.e, customisation for threshold breach alert’s subject, description).
- Component level thresholds can be configured on each resource level.
- No support of showing activity log and applied time.
- Support for the option to get Latest snapshot metric.