Supported Target Version |
---|
PowerScale OneFS API 9.4.0.0 |
PowerScale OneFS API 9.5.0.0 |
Application Version and Upgrade Details
Application Version | Bug fixes / Enhancements |
---|---|
5.0.2 |
|
5.0.1 | If Cluster and One of the node Ips matched then Updating the MAC address of cluster and that Node as CU:00:00:00:00:FirstTwoCharsOfSerialNumber and ND:00:00:00:00:FirstTwoCharsOfSerialNumber respectively. |
5.0.0 |
|
Click here to view the earlier version updates
Application Version | Bug fixes / Enhancements |
---|---|
4.0.0 |
|
3.1.4 | PowerScale Nodes are mapped with external IPs |
3.1.3 |
|
3.1.2 |
|
3.1.1 |
|
3.1.0 | Timeout checkbox is added in the app configuration. |
3.0.1 |
|
3.0.0 | Initial resource discovery and monitoring implementations. |
Introduction
Dell PowerScale is a scale out network-attached storage platform offered by Dell EMC for high-volume storage, backup and archiving of unstructured data.
It provides a cluster-based storage array based on industry-standard hardware and is scalable to 50 petabytes in a single filesystem using its FreeBSD-derived OneFS file system. A PowerScale clustered storage system is composed of three or more nodes. Each node is a server integrated with proprietary operating system software called OneFS (based on FreeBSD), which unifies a cluster of nodes into a single shared resource.
Available resources under PowerScale are as follows:
- Cluster: OneFS works exclusively with dedicated platform nodes, referred to as a “cluster”
- Node: A single cluster consists of multiple nodes, which are rack-mountable enterprise appliances containing: memory, CPU, networking, Ethernet or low-latency InfiniBandinterconnects, disk controllers and storage media. As such, each node in the distributed cluster has compute as well as storage or capacity capabilities.
Prerequisites
- OpsRamp Classic Gateway 14.0.0 and above.
- OpsRamp Nextgen Gateway 14.0.0 and above.
Note: OpsRamp recommends using the latest Gateway version for full coverage of recent bug fixes, enhancements, etc.. - Ensure that “adapter integrations” add-on is enabled in client configuration. Once enabled you can see Dell PowerScale integration under Setup > Integrations > Adapter section
Roles and Permissions
Admin with read-only permission are the required roles and permissions for the Dell PowerScale Account to perform Discovery, Monitoring and Alert polling without any issues.
Hierarchy of Dell PowerScale resources
PowerScale Cluster
• PowerScale Node
• PowerScale Network Interface
• PowerScale Drive
• PowerScale Job
• PowerScale Network Pool
• PowerScale Quota
• PowerScale SyncIQ Policy
• PowerScale SnapShot
• PowerScale Nfs Export
• PowerScale Smb Share
Application Migration
Check for the gateway version as a prerequisite step - classic gateway-12.0.1 and above.
Notes:- You only have to follow these steps when you want to migrate from sdk 1.0 to sdk 2.0.
- For first time installation below steps are not required.
- Application name should be the same.
- Disable all installed integrations configurations for that application. This is to make sure no discovery and monitoring requests are processed.
- Install and Add the configuration to that sdk 2.0 application.
- During the migration from SDK 1.0 to SDK 2.0, ensure that you uncheck the Bypass Resource Reconciliation checkbox.
Note: refer to Configure and Install the Dell Powerscale Integration & View the Dell PowerScale details sections of this document.
Once all discoveries are completed with the sdk 2.0 application, follow any one of the approaches.
- Direct uninstallation of the sdk 1.0 adaptor application through the uninstall API with skipDeleteResources=true in the post request
End-Point:https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}
Request Body:{ "uninstallReason": "Test", "skipDeleteResources": true }
(OR) - Delete the configuration one by one through the Delete adaptor config API with the request parameter as skipDeleteResources=true
End-Point:https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/config/{configId}?skipDeleteResources=true.
- Finally, uninstall the adaptor application through API with skipDeleteResources=true in the post request.
End-Point:https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}
Request Body:{ "uninstallReason": "Test", "skipDeleteResources": true }
- Direct uninstallation of the sdk 1.0 adaptor application through the uninstall API with skipDeleteResources=true in the post request
Supported Metrics
Click here to view the supported metrics
Native Type | Metric Name | Display Name | Metric Label | Units | Application Version | Description |
---|---|---|---|---|---|---|
PowerScale Cluster | powerscale_cluster_FreeCapacity | PowerScale Cluster Free Capacity | usage | GB | 3.0.0 | The number of free bytes in the Isilon filesystem. |
powerscale_cluster_UsedCapacity | PowerScale Cluster Used Capacity | usage | GB | 3.0.0 | The number of used bytes in the Isilon filesystem. | |
powerscale_cluster_TotalCapacity | PowerScale Cluster Total Capacity | usage | GB | 3.0.0 | The total number of bytes in the Isilon filesystem. | |
powerscale_cluster_CapacityUtilization | PowerScale Cluster Capacity Utilization | Usage | % | 3.0.0 | The percentage of the Isilon filesystem used for storage. | |
powerscale_cluster_avg_IORead | PowerScale Cluster Average IO Read | Performance | rops | 3.0.0 | The average cumulative operation rate (ops/sec) out of /ifs. | |
powerscale_cluster_min_IORead | PowerScale Cluster Minimum IO Read | Performance | rops | 3.0.0 | The minimum cumulative operation rate (ops/sec) out of /ifs. | |
powerscale_cluster_max_IORead | PowerScale Cluster Maximum IO Read | Performance | rops | 3.0.0 | The maximum cumulative operation rate (ops/sec) out of /ifs. | |
powerscale_cluster_avg_IOWrite | PowerScale Cluster Average IO Write | Performance | rops | 3.0.0 | The average cumulative operation rate (ops/sec) into /ifs. | |
powerscale_cluster_min_IOWrite | PowerScale Cluster Minimum IO Write | Performance | rops | 3.0.0 | The minimum cumulative operation rate (ops/sec) into /ifs. | |
powerscale_cluster_max_IOWrite | PowerScale Cluster Maximum IO Write | Performance | rops | 3.0.0 | The maximum cumulative operation rate (ops/sec) into /ifs. | |
powerscale_cluster_avg_ThroughputRead | PowerScale Cluster Average Throughput Read | Performance | Bps | 3.0.0 | The average cumulative throughput rate (bytes per second) out of /ifs. | |
powerscale_cluster_min_ThroughputRead | PowerScale Cluster Minimum Throughput Read | Performance | Bps | 3.0.0 | The minimum cumulative throughput rate (bytes per second) out of /ifs. | |
powerscale_cluster_max_ThroughputRead | PowerScale Cluster Maximum Throughput Read | Performance | Bps | 3.0.0 | The maximum cumulative throughput rate (bytes per second) out of /ifs. | |
powerscale_cluster_avg_ThroughputWrite | PowerScale Cluster Average Throughput Write | Performance | Bps | 3.0.0 | The average cumulative throughput rate (bytes per second) into /ifs. | |
powerscale_cluster_min_ThroughputWrite | PowerScale Cluster Minimum Throughput Write | Performance | Bps | 3.0.0 | The minimum cumulative throughput rate (bytes per second) into /ifs. | |
powerscale_cluster_max_ThroughputWrite | PowerScale Cluster Maximum Throughput Write | Performance | Bps | 3.0.0 | The maximum cumulative throughput rate (bytes per second) into /ifs. | |
powerscale_cluster_User_CPUUtilization | PowerScale Cluster CPU User | Usage | % | 3.0.0 | CPU User | |
powerscale_cluster_CPUNice | PowerScale Cluster CPU Nice | usage | % | 3.0.0 | CPU Nice | |
powerscale_cluster_system_CPUUtilization | PowerScale Cluster CPU System | usage | % | 3.0.0 | CPU System | |
powerscale_cluster_Interrupt_CPUUtilization | PowerScale Cluster CPU Interrupt | usage | % | 3.0.0 | CPU interrupt | |
powerscale_cluster_CPUIdle | PowerScale Cluster CPU Idle | usage | % | 3.0.0 | CPU idle in percentage | |
powerscale_cluster_DeployedUsable | PowerScale Cluster Deployed Usable | usage | TB | 3.0.0 | Deployed Usable - Capacity converted to Base 2 Tebibytes (TiB) post OS partitioning and drive formatting. Total capacity of /ifs | |
powerscale_cluster_DeployedUsableConsumed | PowerScale Cluster Deployed Usable Consumed | usage | TB | 3.0.0 | Deployed Usable Consumed - The amount of data written to the OneFS filesystem in Base 2 Tebibytes (TiB) including overhead. Total used capacity of /ifs | |
powerscale_cluster_DeployedUsableFree | PowerScale Cluster Deployed Usable Free | usage | TB | 3.0.0 | Deployed Usable Free - The calculated result of Deployed Usable - Deployed Usable Consumed. The free capacity of /ifs | |
powerscale_cluster_RawCapacity | PowerScale Cluster Raw Capacity | usage | TB | 3.0.0 | Raw Capacity - Disk Size * Disk Count in Base 10 Terabytes (TB). | |
powerscale_event_Statistics | PowerScale Event Statistics | 3.0.0 | Provides Dell PowerScale Event Statistics. | |||
powerscale_APIStats | PowerScale API Statistics | Usage | TB | 3.0.0 | Provides the number of PowerScale API calls made within the frequency and resources. | |
powerscale_storagepools_AvailBytes | PowerScale StoragePools Avail Bytes | usage | GB | 3.0.0 | Available Bytes | |
powerscale_storagepools_AvailHddBytes | PowerScale StoragePools Avail Hdd Bytes | usage | GB | 3.0.0 | Available HDD Bytes | |
powerscale_storagepools_AvailSsdBytes | PowerScale StoragePools Avail Ssd Bytes | usage | GB | 3.0.0 | Available SSD Bytes | |
powerscale_storagepools_FreeBytes | PowerScale StoragePools Free Bytes | usage | GB | 3.0.0 | Free Bytes | |
powerscale_storagepools_FreeHddBytes | PowerScale StoragePools Free Hdd Bytes | usage | GB | 3.0.0 | Free HDD Bytes | |
powerscale_storagepools_FreeSsdBytes | PowerScale StoragePools Free Ssd Bytes | usage | GB | 3.0.0 | Free SSD Bytes | |
powerscale_storagepools_PacketUsed | PowerScale StoragePools Packet Used | Usage | % | 3.0.0 | Packet Used | |
powerscale_storagepools_PacketUsedHdd | PowerScale StoragePools Packet Used Hdd | Usage | % | 3.0.0 | Packet Used HDD | |
powerscale_storagepools_PacketUsedSsd | PowerScale StoragePools Packet Used Ssd | Usage | % | 3.0.0 | Packet Used SSD | |
powerscale_storagepools_TotalBytes | PowerScale StoragePools Total Bytes | usage | GB | 3.0.0 | Total Bytes | |
powerscale_storagepools_TotalHddBytes | PowerScale StoragePools Total Hdd Bytes | usage | GB | 3.0.0 | Total HDD Bytes | |
powerscale_storagepools_TotalSsdBytes | PowerScale StoragePools Total Ssd Bytes | usage | GB | 3.0.0 | Total SSD Bytes | |
powerscale_storagepools_UsableBytes | PowerScale StoragePools Usable Bytes | usage | GB | 3.0.0 | Usable Bytes | |
powerscale_storagepools_UsableHddBytes | PowerScale StoragePools Usable Hdd Bytes | usage | GB | 3.0.0 | Usable HDD Bytes | |
powerscale_storagepools_UsableSsdBytes | PowerScale StoragePools Usable Ssd Bytes | usage | GB | 3.0.0 | Usable SSD Bytes | |
powerscale_storagepools_UsedHddBytes | PowerScale StoragePools Used Hdd Bytes | usage | GB | 3.0.0 | Used HDD Bytes | |
powerscale_storagepools_UsedSsdBytes | PowerScale StoragePools Used Ssd Bytes | usage | GB | 3.0.0 | Used SSD Bytes | |
powerscale_storagepools_VirtualHotSpareBytes | PowerScale StoragePools Virtual Hot Spare Bytes | usage | GB | 3.0.0 | Virtual Hot Spare Bytes | |
powerscale_syncIQ_TotalPolicies | PowerScale SyncIQ Total Policies | usage | count | 3.0.0 | Total Policies | |
powerscale_snapshot_Count | PowerScale Snapshot Count | usage | count | 3.0.0 | Snapshot count | |
powerscale_quota_NfsHard | PowerScale Quota Nfs Hard | usage | GB | 3.0.0 | Nfs hard | |
powerscale_nodepools_AvailBytes | PowerScale Nodepools Avail Bytes | usage | GB | 3.0.0 | Available Bytes | |
powerscale_nodepools_AvailHddBytes | PowerScale Nodepools Avail Hdd Bytes | usage | GB | 3.0.0 | Available HDD Bytes | |
powerscale_nodepools_AvailSsdBytes | PowerScale Nodepools Avail Ssd Bytes | usage | GB | 3.0.0 | Available SSD Bytes | |
powerscale_nodepools_FreeBytes | PowerScale Nodepools Free Bytes | usage | GB | 3.0.0 | Free Bytes | |
powerscale_nodepools_FreeHddBytes | PowerScale Nodepools Free Hdd Bytes | usage | GB | 3.0.0 | Free HDD Bytes | |
powerscale_nodepools_FreeSsdBytes | PowerScale Nodepools Free Ssd Bytes | usage | GB | 3.0.0 | Free SSD Bytes | |
powerscale_nodepools_PacketUsed | PowerScale Nodepools Packet Used | Usage | % | 3.0.0 | Packet Used | |
powerscale_nodepools_PacketUsedHdd | PowerScale Nodepools Packet Used Hdd | usage | % | 3.0.0 | Packet Used HDD | |
powerscale_nodepools_PacketUsedSsd | PowerScale Nodepools Packet Used Ssd | usage | % | 3.0.0 | Packet Used SSD | |
powerscale_nodepools_TotalBytes | PowerScale Nodepools Total Bytes | usage | GB | 3.0.0 | Total Bytes | |
powerscale_nodepools_TotalHddBytes | PowerScale Nodepools Total Hdd Bytes | usage | GB | 3.0.0 | Total HDD Bytes | |
powerscale_nodepools_TotalSsdBytes | PowerScale Nodepools Total Ssd Bytes | usage | GB | 3.0.0 | Total SSD Bytes | |
powerscale_nodepools_UsableBytes | PowerScale Nodepools Usable Bytes | usage | GB | 3.0.0 | Usable Bytes | |
powerscale_nodepools_UsableHddBytes | PowerScale Nodepools Usable Hdd Bytes | usage | GB | 3.0.0 | Usable HDD Bytes | |
powerscale_nodepools_UsableSsdBytes | PowerScale Nodepools Usable Ssd Bytes | usage | GB | 3.0.0 | Usable SSD Bytes | |
powerscale_nodepools_UsedHddBytes | PowerScale Nodepools Used Hdd Bytes | usage | GB | 3.0.0 | Used HDD Bytes | |
powerscale_nodepools_UsedSsdBytes | PowerScale Nodepools Used Ssd Bytes | usage | GB | 3.0.0 | Used SSD Bytes | |
powerscale_nodepools_VirtualHotSpareBytes | PowerScale Nodepools Virtual Hot Spare Bytes | usage | GB | 3.0.0 | Virtual Hot Spare Bytes | |
powerscale_bootDrive_LifeRemaining | PowerScale Boot Drive Life Remaining | Availability | % | 3.0.0 | The percentage of Boot Drive Life Remaining | |
powerscale_cluster_nodes_Count | PowerScale Cluster Nodes Count | Availability | count | 3.0.0 | Count of the Cluster devices | |
powerscale_cluster_upNodes_Count | PowerScale Cluster Up Nodes Count | Availability | count | 3.0.0 | Count of the Cluster online devices | |
powerscale_cluster_downNodes_Count | PowerScale Cluster Down Nodes Count | Availability | count | 3.0.0 | Count of the Cluster down devices | |
powerscale_cluster_roNodes_Count | PowerScale Cluster Read Only Nodes Count | Availability | count | 3.0.0 | Count of the Cluster read only nodes | |
powerscale_cluster_nodes_BatteriesState | PowerScale Cluster Nodes BatteriesState | Availability | None | 3.0.0 | Cluster nodes NVRAM battery status information. Possible values : OK - 0, ATTN - 1 | |
powerscale_cluster_nodes_PSState | PowerScale Cluster Nodes PSState | Availability | None | 3.0.0 | Cluster node's power supplies state. Possible values : OK - 0, ATTN - 1 | |
powerscale_cluster_nodePools_RawTotalInTiB | PowerScale Cluster NodePools Raw Total In TiB | Usage | TiB | 3.0.0 | Cluster NodePools Raw Total In TiB | |
powerscale_cluster_nodePools_FreeInTiB | PowerScale Cluster NodePools Free In TiB | usage | TiB | 3.0.0 | Cluster NodePools Free In TiB | |
powerscale_cluster_nodePools_VHSInTiB | PowerScale Cluster NodePools VHS In TiB | usage | TiB | 3.0.0 | TiB Reserved for virtual hot spare in the cluster node pools. | |
powerscale_cluster_nodePools_VHSInPct | PowerScale Cluster NodePools VHS In Pct | usage | % | 3.0.0 | PowerScale Cluster NodePools VHS In Percentage. | |
powerscale_cluster_nodePools_UsableInTiB | PowerScale Cluster NodePools Usable In TiB | usage | TiB | 3.0.0 | Total TiB in the Cluster NodePools drives when virtual hot spare is taken into account. | |
powerscale_cluster_nodePools_UsedInTiB | PowerScale Cluster NodePools Used In TiB | usage | TiB | 3.0.0 | Used TiB in the Cluster NodePools | |
powerscale_cluster_nodePools_AvailInTiB | PowerScale Cluster NodePools Avail In TiB | usage | TiB | 3.0.0 | Available free TiB remaining in the Cluster NodePools when virtual hot spare is taken into account. | |
powerscale_cluster_nodePools_UsedInPct | PowerScale Cluster NodePools Used In Pct | usage | % | 3.0.0 | PowerScale Cluster NodePools Used In Percentage. | |
powerscale_cluster_SnapshotsTotalInTiB | PowerScale Cluster Snapshots Total In TiB | usage | TiB | 3.0.0 | Sum of sizes in TiB of all snapshots. | |
powerscale_cluster_SnapshotsActiveInTiB | PowerScale Cluster Snapshots Active In TiB | usage | TiB | 3.0.0 | Sum of sizes of active snapshots. | |
powerscale_cluster_SnapshotsDeletingInTiB | PowerScale Cluster Snapshots Deleting In TiB | usage | TiB | 3.0.0 | Sum of sizes of delete-pending snapshots. | |
powerscale_cluster_Snapshot_UsageInTiB | PowerScale Cluster Snapshots Usage In TiB | usage | TiB | 3.0.0 | Sum of sizes of snapshots which has same path. | |
PowerScale Node | powerscale_node_TotalCapacity | PowerScale Node Total Capacity | usage | GB | 3.0.0 | The number of total bytes on /ifs on the node. |
powerscale_node_FreeCapacity | PowerScale Node Free Capacity | usage | GB | 3.0.0 | The number of free bytes on /ifs on the node. | |
powerscale_node_UsedCapacity | PowerScale Node Used Capacity | usage | GB | 3.0.0 | The number of used bytes on /ifs on the node. | |
powerscale_node_CapacityUtilization | Powerscale Node Capacity Utilization | Usage | % | 3.0.0 | Capacity utilized by powerscale node | |
powerscale_node_avg_IORead | PowerScale Node Average IO Read | Performance | rops | 3.0.0 | The average cumulative operation rate (ops/sec) out of /ifs on node. | |
powerscale_node_min_IORead | PowerScale Node Minimum IO Read | Performance | rops | 3.0.0 | The minimum cumulative operation rate (ops/sec) out of /ifs on node. | |
powerscale_node_max_IORead | PowerScale Node Maximum IO Read | Performance | rops | 3.0.0 | The maximum cumulative operation rate (ops/sec) out of /ifs on node. | |
powerscale_node_avg_IOWrite | PowerScale Node Average IO Write | Performance | rops | 3.0.0 | The average cumulative operation rate (ops/sec) into /ifs on node. | |
powerscale_node_min_IOWrite | PowerScale Node Minimum IO Write | Performance | rops | 3.0.0 | The minimum cumulative operation rate (ops/sec) into /ifs on node. | |
powerscale_node_max_IOWrite | PowerScale Node Maximum IO Write | Performance | rops | 3.0.0 | The maximum cumulative operation rate (ops/sec) into /ifs on node. | |
powerscale_node_avg_ThroughputRead | PowerScale Node Average Throughput Read | Performance | Bps | 3.0.0 | The average cumulative throughput rate (bytes per second) out of /ifs on node. | |
powerscale_node_min_ThroughputRead | PowerScale Node Minimum Throughput Read | Performance | Bps | 3.0.0 | The minimum cumulative throughput rate (bytes per second) out of /ifs on node. | |
powerscale_node_max_ThroughputRead | PowerScale Node Maximum Throughput Read | Performance | Bps | 3.0.0 | The maximum cumulative throughput rate (bytes per second) out of /ifs on node. | |
powerscale_node_avg_ThroughputWrite | PowerScale Node Average Throughput Write | Performance | Bps | 3.0.0 | The average cumulative throughput rate (bytes per second) into /ifs on node. | |
powerscale_node_min_ThroughputWrite | PowerScale Node Minimum Throughput Write | Performance | Bps | 3.0.0 | The minimum cumulative throughput rate (bytes per second) into /ifs on node. | |
powerscale_node_max_ThroughputWrite | PowerScale Node Maximum Throughput Write | Performance | Bps | 3.0.0 | The maximum cumulative throughput rate (bytes per second) into /ifs on node. | |
powerscale_node_Temperature | PowerScale Node Temperature | Thermal | Celsius | 3.0.0 | The temperature reported by the indicated temperature sensor in degrees C | |
powerscale_node_Amps | PowerScale Node Amps | Usage | amps | 3.0.0 | The currency reported by the indicated amp sensor in Amps. | |
powerscale_node_Power | PowerScale Node Power | Power | W | 3.0.0 | Power | |
powerscale_node_DiskInRateSum | PowerScale Node Disk In Rate Sum | Performance | rops | 3.0.0 | Sum of all disk IN per Node basis | |
powerscale_node_DiskOutRateSum | PowerScale Node Disk Out Rate Sum | Performance | rops | 3.0.0 | Sum of all disk OUT per Node basis | |
powerscale_node_user_CPUUtlization | PowerScale Node CPU User | Usage | % | 3.0.0 | CPU User | |
powerscale_node_CPUIdle | PowerScale Node CPU Idle | usage | % | 3.0.0 | CPU Idle | |
powerscale_node_Interrupt_CPUUtilization | PowerScale Node CPU Interrupt | usage | % | 3.0.0 | CPU Interrupt | |
powerscale_node_system_CPUUtlization | PowerScale Node CPU System | usage | % | 3.0.0 | CPU System | |
powerscale_node_CPUNice | PowerScale Node CPU Nice | usage | % | 3.0.0 | CPU Nice | |
powerscale_node_AvgLatency | PowerScale Node Average Latency | Performance | ms | 3.0.0 | average Protocol latency performance | |
powerscale_node_MaxLatency | PowerScale Node Maximum Latency | Performance | ms | 3.0.0 | maximum Protocol latency performance | |
powerscale_node_MinLatency | PowerScale Node Minimum Latency | Performance | ms | 3.0.0 | minimum Protocol latency performance | |
powerscale_node_DiskIOPS | PowerScale Node Disk IOPS | Performance | rops | 3.0.0 | disk IOPS | |
powerscale_node_DiskRead | PowerScale Node DiskRead | Performance | rops | 3.0.0 | disk reads | |
powerscale_node_DiskWrite | PowerScale Node DiskWrite | Performance | rops | 3.0.0 | disk writes | |
powerscale_node_NetworkInErrors_Per_Sec | PowerScale Node NetworkInError/Sec | Availability | Errors per Sec | 3.0.0 | Network input errors per-second | |
powerscale_node_NetworkInMegabytes_Per_Sec | PowerScale Node NetworkInMegabytes/Sec | Performance | MBps | 3.0.0 | Network input megabytes per-second | |
powerscale_node_NetworkInPackets_Per_Sec | PowerScale Node NetworkInPackets/Sec | Performance | packets/sec | 3.0.0 | Network input packets per-second | |
powerscale_node_NetworkOutErrors_Per_Sec | PowerScale Node NetworkOutErrors/Sec | Availability | Errors per Sec | 3.0.0 | Network output errors per-second | |
powerscale_node_NetworkOutMegabytes_Per_Sec | PowerScale Node NetworkOutMegabytes/Sec | Performance | MBps | 3.0.0 | Network output megabytes per-second | |
powerscale_node_NetworkOutPackets_Per_Sec | PowerScale Node NetworkOutPackets/Sec | Performance | packets/sec | 3.0.0 | Network output packets per-second | |
powerscale_node_OnefsIn | PowerScale Node OnefsIn | Performance | MBps | 3.0.0 | OneFS throughput in MB/s in. | |
powerscale_node_OnefsOut | PowerScale Node OnefsOut | Performance | MBps | 3.0.0 | OneFS throughput in MB/s out. | |
powerscale_node_OnefsTotal | PowerScale Node OnefsTotal | Performance | MBps | 3.0.0 | OneFS throughput in MB/s total. | |
powerscale_node_ProtocolDataRead | PowerScale Node ProtocolDataRead | Performance | rops | 3.0.0 | Protocol date read operations per second. This is a variable number of output fields depending on the protocol being displayed. | |
powerscale_node_ProtocolDataWrite | PowerScale Node ProtocolDataWrite | Performance | rops | 3.0.0 | Protocol data write operations per second. This is a variable number of output fields depending on the protocol being displayed. | |
powerscale_node_max_UserCPU | PowerScale Node Max User CPU | usage | 3.0.0 | Max User CPU | ||
powerscale_node_max_SystemCPU | PowerScale Node Max System CPU | usage | 3.0.0 | Max System CPU | ||
powerscale_node_DiskOutRateAll | PowerScale Node Disk Out Rate All | Performance | rops | 3.0.0 | Show the value of each disk OUT values per node basis | |
powerscale_node_DiskInRateAll | PowerScale Node Disk In Rate All | Performance | rops | 3.0.0 | Show the value of each disk IN values per node basis | |
PowerScale Network Interface | powerscale_networkinterface_Status | PowerScale Network Interface Status | Availability | — | 3.0.0 | PowerScale Network Interface status. Possible values are: up, no_carrier, active, inactive, disabled, unknown |
powerscale_networkinterface_NetworkInErrors_Per_Sec_Pct | PowerScale Network Interface InError Per Sec Pct | Availability | % | 4.0.0 | PowerScale Network Interface InError rate Percentage | |
powerscale_networkinterface_NetworkOutErrors_Per_Sec_Pct | PowerScale Network Interface OutError Per Sec Pct | Availability | % | 4.0.0 | PowerScale Network Interface OutError rate Percentage | |
PowerScale Drive | powerscale_drive_avg_Latency | PowerScale Drive Average Latency | Performance | ms | 3.0.0 | The average operation latency. |
powerscale_drive_State | powerscale_drive_State | Availability | None | 3.0.0 | This drive's state as presented to the UI. Possible values : SMARTFAIL - 0, REPLACE - 1, ERASE - 2, SED_ERROR - 3. | |
PowerScale Job | powerscale_job_State | PowerScale Job State | Availability | None | 3.0.0 | Current state of the job. Possible values : running - 0, paused_user - 1, paused_system - 2, paused_policy - 3, paused_priority - 4, cancelled_user - 5, cancelled_system - 6, failed - 7, succeeded - 8, failed_not_retried - 9, unknown - 10. |
PowerScale Quota | powerscale_quota_AdvisoryThresholdInTiB | PowerScale Quota AdvisoryThreshold In TiB | usage | TiB | 3.0.0 | Usage TiB at which notifications will be sent but writes will not be denied. |
powerscale_quota_HardThresholdInTiB | PowerScale Quota HardThreshold In TiB | usage | TiB | 3.0.0 | Usage TiB at which further writes will be denied. | |
powerscale_quota_LogicalUsageInTiB | PowerScale Quota LogicalUsage In TiB | usage | TiB | 3.0.0 | TiB used by governed data apparent to the filesystem. | |
powerscale_quota_PhysicalUsageInTiB | PowerScale Quota PhysicalUsage In TiB | usage | TiB | 3.0.0 | TiB is used for governed data and filesystem overhead. | |
powerscale_quota_ProtectionInTiB | PowerScale Quota Protection In TiB | usage | TiB | 3.0.0 | Difference between physical and logical data in TiB. | |
powerscale_quota_UsedInPct | PowerScale Quota Used In Pct | usage | % | 3.0.0 | PowerScale Quota Used In Percentage | |
powerscale_quota_FileCount | PowerScale Quota FileCount | usage | count | 3.0.0 | Number of inodes (filesystem entities) used by governed data. | |
PowerScale SyncIQ Policy | powerscale_syncIQPolicy_IsEnabled | PowerScale SyncIQPolicy IsEnabled | Availability | None | 3.0.0 | If true, jobs will be automatically run based on this policy, according to its schedule. |
powerscale_syncIQPolicy_LastJobState | PowerScale SyncIQPolicy LastJobState | Availability | None | 3.0.0 | This is the state of the most recent job for this policy. Possible values : finished - 0, unknown - 1, failed - 2. | |
powerscale_syncIQPolicy_IsJobRanLastday | PowerScale SyncIQPolicy IsJobRanLastday | None | 3.0.0 | This metric tells whether this Job ran last day or not. |
Default Monitoring Configurations
Dell PowerScale has default Global Device Management Policies, Global Templates, Global Monitors and Global Metrics in OpsRamp. You can customize these 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.
Default Global Device Management Policies
OpsRamp has a Global Device Management Policy for each Native Type of Dell PowerScale. 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: dell-power-scale PowerScale Cluster - 1 (i.e, appName = dell-power-scale, nativeType = PowerScale Cluster, version = 1)
Default Global Templates
OpsRamp has a Global template for each Native Type of Dell PowerScale. 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: dell-power-scale PowerScale Cluster Template - 1 (i.e, appName = dell-power-scale, nativeType = PowerScale Cluster, version = 1)
Default Global Monitors
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: PowerScale Cluster Monitor dell-power-scale PowerScale Cluster 1(i.e, monitorKey = PowerScale Cluster Monitor, appName = dell-power-scale, nativeType = PowerScale Cluster, version = 1)
Configure and Install the Dell Powerscale Integration
- From All Clients, select a client.
- Navigate to Setup > Account.
- Select the Integrations and Apps tab.
- The Installed Integrations page, where all the installed applications are displayed. If there are no installed applications, it will navigate to the Available Integrations and Apps page.
- Click + ADD on the Installed Integrations page. The Available Integrations and Apps page displays all the available applications along with the newly created application with the version.
- Search for the application using the search option available. Alternatively, use the All Categories option to search.
- Click ADD in the Dell PowerScale application.
- In the Configurations 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 | IP Address or Host name of the End Resource. |
API Port | API Port information. Note: By default 8080 is the port value. |
SSH Port | SSH Port information. Note: By default 22 is the port value. |
API Authentication Type | Select the API authentication type from the drop-down list. Note: By default Basic Auth is selected. |
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.
- Ip Address/Host Name and Port should be accessible from Gateway.
- 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.
- API Timeouts: These are the maximum API Timeouts that the application can use to connect and get responses from the end device.
- Connection Timeout in Secs: a time period in which a client should establish a connection with a server.
Note: By default 60 is selected. - Connection Request Timeout in Secs: a time period required to process an HTTP call: from sending a request to receiving a response.
Note: By default 60 is selected. - Socket Timeout in Secs: a maximum time of inactivity between two data packets when exchanging data with a server.
Note: By default 60 is selected.
- Connection Timeout in Secs: a time period in which a client should establish a connection with a server.
- By default Alert On rootResource is selected.
- Below are the default values set for:
- Event/Alert Severity Filter: provides severity alerts and gets integrated out of all possible alerts.
- Default Values: emergency, critical, warning, information, unknown.
- Possible Values: emergency, critical, warning, information, unknown.
- Event/Alert Severity Mapping: enables you to map the severities between Dell PowerScale and OpsRamp as severities are predefined values in each system.
- Default mappings: {“emergency”:“Critical”,“critical”:“Critical”,“warning”:“Warning”,“information”:“Info”,“unknown”:“Info”}
Note: You can change it as per your business use cases at any point in time from the Configuration page.
- Default mappings: {“emergency”:“Critical”,“critical”:“Critical”,“warning”:“Warning”,“information”:“Info”,“unknown”:“Info”}
- Event/Alert Severity Filter: provides severity alerts and gets integrated out of all possible alerts.
- 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. From the same page, you may Edit and Remove the created configuration.
Under the ADVANCED SETTINGS, Select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.
Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.
Click NEXT.
(Optional) Click +ADD to create a new collector by providing a name or use the pre-populated name.
- Select an existing registered profile.
- Click FINISH.
The application is installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed integration.
Modify the Configuration
See Modify an Installed Integration or Application article.
Note: Select the Dell PowerScale application.
View the Dell PowerScale Details
To discover resources for Dell PowerScale
- Navigate to Infrastructure > Search > Storage > Dell PowerScale.
- The Dell PowerScale page is displayed, select the application name.
- The RESOURCE DETAILS page appears from the right.
- Click the ellipsis (…) on the top right and select View details.
- Navigate to the Attributes tab to view the discovery details.
- Click the Metrics tab to view the metric details for Dell PowerScale.
Resource Filter Input Keys
Dell PowerScale app Resources are filtered and discovered based on below keys:
Note: You can filter the resources with the discoverable keys only.
Click here to view the Supported Input Keys
Resource Type | Supported Input Keys |
---|---|
All Types | resourceName |
hostName | |
aliasName | |
dnsName | |
ipAddress | |
macAddress | |
os | |
make | |
model | |
serialNumber | |
PowerScale Cluster | OneFS Version |
PowerScale Node | Node Capacity |
Node Type | |
PowerScale Job | StartTime |
EndTime | |
RunningTime | |
CreateTime | |
Type | |
Policy | |
Progress | |
Description | |
Pool Id | |
Groupnet | |
AccessZone | |
Sc Suspended Nodes | |
PowerScale Quota | Path |
Zone Name | |
Advisory Last Exceeded | |
Hard Last Exceeded | |
PowerScale SyncIQ Policy | Path |
Last Started | |
Last Success | |
PowerScale SnapShot | Schedule |
Path | |
PowerScale Nfs Export | Path |
Zone Name | |
PowerScale Smb Share | Zone Name |
Path | |
PowerScale Drive | Node ID |
Baynum |
Supported Alert Custom Macros
Customize the alert subject and description with below macros then it will generate alert based on customisation.
Supported macros keys:
Click here to view the alert subject and description with macros
${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}
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 uses the provided IpAddress/hostname, Credentials for both REST APIs and SSH communications. SSH communication is used for powerscale_bootDrive_LifeRemaining metric collection. Rest API communication is used for rest of the functionalities.
Credentials used should have sudo root privileges for ssh connection used for powerscale_bootDrive_LifeRemaining metric collection.
Application will send any duplicate/repeat failure alert notification for every 6 hours.
Application cannot control monitoring pause/resume actions based on above alerts.
Metrics can be used to monitor Dell PowerScale resources and can generate alerts based on the threshold values.
Dell PowerScale’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 emergency, critical, warning, information, unknown.
OpsRamp has given sample mappings to map Dell PowerScale 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.
No support of showing activity logs.
The Template Applied Time will only be displayed if the collector profile (Classic and NextGen Gateway) is version 18.1.0 or higher.
The minimum supported version for the option to get the latest snapshot metric is Nextgen-14.0.0.
For Network Interfaces, we are mapping the Ip Address with external IPs of network interfaces and ignoring internal ips based on available pool details like “Internal_MGMT”.
This application supports both Classic Gateway and NextGen Gateway.
The following read privilege is required to get the Zones API work:
- Auth access zones (ISI_PRIV_AUTH_ZONES)
For PowerScale Nodes, we are mapping the Ip Address with external IP of first network interface whose pool is not null and not Internal_MGMT and also Type is not internal.
Starting from version 5.0.1, to avoid node reconciliation with the cluster, we are mapping the MAC address with dummy values if both the Cluster and Node have the same IP Address.
Note: In the scenario where the Cluster and Node share the same IPAddress and have undergone reconciliation, during an upgrade, the cluster will retain the custom attributes of the node as well.
References
REST API Doc: https://developer.dell.com/apis/4088/versions/9.4.0.0/docs/1introduction.md
Troubleshooting
Before troubleshooting, ensure all prerequisites prerequisites are met.
If Dell PowerScale integrations fail to discover or monitor, troubleshoot using the following steps:
- Check if any alerts have been generation on PowerScale Cluster, the gateway, or in vprobe.
- If there is an error or alert related to the end device connectivity or authentication, try checking the reachability of the end device from the gateway with the following commands:
- to ping the IP address provided in the configuration:
{ping <IP Address>}
- to try telnet:
{telnet <IP Adress> <Port>}
- To run an API:
Prepare the request payload by using below sample request:
{ “apiVersion”: “debug/v1”, “module”: “Debug”, “app”: “dell-power-scale”, “action”: “Reachability”, “payload”: { “ipAddressOrHostName”: “
”, “protocol”: “https”, “port”: 443, “requestPath”: “ ”, “version”:“v1”,
“requestMethod”:"<get/post>", “userName”: “
”, “password”: “ ” } } Encode the request payload to base64
Log in to the gateway concole and connect to the GCLI terminal using the below command:
{## gcli}
Run the command using the previously generated base64 encoded string
{## sdkappdebug <base64 encoded string>}
- to ping the IP address provided in the configuration: