Re: OCUM Rest api

Daniel_Maryuma · ‎2020-08-01

Hey,

1. Can i get specific fields with the api of ocum?

2. How can i obtain fields that are not present on the api? e.g the cli command "lun serial -x" presents the Hex-Serial of the lun, But on ocum api i cant get even the serial number of the lun (which i can convert it to hex later then).

thanks,

donny_lang · ‎2020-08-03

1. If you go to https://<AIQUM server hostname>/docs/api/ you can see the (in my opinion, fantastic) API documentation, which includes a list of filters which you can use to restrict API output to relevant data.

2. I don't believe you can use the API to obtain data from fields that aren't available on the AIQUM API. However, you may be able to get the info by querying the cluster directly using its own REST API (there is even a "pass-through" call that you can use to pass CLI commands directly if there isn't an API call currently available for your use case).

Daniel_Maryuma · ‎2020-08-04

First of all thank you for responding.

1. My client wants to query performance, but on OCUM9.7 there's only Workload Tab (from what i am found) for query performance(iops,latency etc..)on lun, volumes and aggr. and its only query average for 15 days.. and the client want it to be real-time..

2. i would like to know what you mean by "pass-through call that you can use to pass CLI commands".

i wish to have it all by OCUM, not on cluster api.

thanks!

paul_stejskal · ‎2020-08-04

AIQUM is real time performance monitoring. Can you explain more what you want? You should be able to go in and view specific graphs.

I wrote a KB a while back that describes how to do it, which is a little out of date with AIQUM 9.7 (written for like 9.5 I think), but should still be the same. Basically you go to the volume view and there should be tabs when you get to the performance part. You may have to switch to a perf view.

Here's the KB: https://kb.netapp.com/Advice_and_Troubleshooting/Data_Infrastructure_Management/OnCommand_Suite/How_to_rectify_performance_issues_using_monitoring_too...

I probably need to add to it or we can make more KBs.

If you get stuck, let us know!

Daniel_Maryuma · ‎2020-08-06

I just want to get performance metrics for nodes,aggr,volume and luns using AIQUM9.7

paul_stejskal · ‎2020-08-10

Once your controllers are added, on the left is a menu, click Volumes or whichever. This example shows how to get performance graphs:

Then click the volume(s) you want and you'll be able to view performance as needed.

Daniel_Maryuma · ‎2020-08-10

Thank you, but i wish to have by Rest API only..

paul_stejskal · ‎2020-08-10

I think you will find it under /storage-provider/workloads . Try that.

Retrieves all workloads.

Examples

Retrieving a list of workloads filtered using ???name???:
```
GET "/api/storage-provider/workloads?name=test_scr"
```
Retrieving a list of workloads filtered using ???type???:
```
GET "/api/storage-provider/workloads?type=lun"
```

Retrieving a list of workloads filtered using ???svm.uuid???:

GET "/api/storage-provider/workloads?svm.uuid=3714280e-fecb-11e9-8054-00a098d7b0b9"

Retrieving a list of workloads filtered using ???assigned_performance_service_level.key???:

GET "/api/storage-provider/workloads?assigned_performance_service_level.key=112480e-fecb-1e349-5654-00a098d8b0b9"

Retrieving a list of workloads filtered using ???type??? and ???svm.key???:

GET "/api/storage-provider/workloads?type=lun&svm.key=8601116e-1b56-11e9-bdec-00a098d87b4b:type=vserver,uuid=3714280e-fecb-11e9-8054-00a098d7b0b9"

Retrieving a list of workloads filtered using ???cluster.name??? and ???svm.name???:

GET "/api/storage-provider/workloads?cluster.name=AFFA201-206-6-78&&svm.name=vs_vserver"