topic Re: "percent-used" ("percentage-size-used") is calculated differently on differe in ONTAP Discussions

"percent-used" ("percentage-size-used") is calculated differently on different versions of ONTAP.

RazSK — Wed, 04 Jun 2025 11:07:19 GMT

Hello.
I have noticed some deviation in value of Volume "percent-used" value for volume show command on different C-Mode ONTAP versions. It is also true also for ZAPI volume-get-iter "percentage-size-used" value (which is the same).
What I have noticed:

On 8.3 and 9.2 "percent-used" = (Used data space + Snapshot Reserve Size) / Total Volume size
On 9.7 "percent-used" = Used data space / Data sector Size

So, on the latest 9.7 ONTAP calculation made differently.
Could someone tell from which ONTAP version calculation approach has changed? And point the doc where this is mentioned (because I couldn't find this place at least for now).

Thanks!

Re: "percent-used" ("percentage-size-used") is calculated differently on differe

Mjizzini — Wed, 03 Jun 2020 03:24:16 GMT

I reviewed the Ontap 9.7 documentation, we still have the same explanation for the field percent-used.

https://docs.netapp.com/ontap-9/topic/com.netapp.doc.dot-cm-cmpr-970/volume__show.html

[-percent-used <percent>] - Used Percentage
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of used space. This row is based on a value of used space that includes the space used by Snapshot copies or the Snapshot reserve (whichever is greater) in relation to the current volume size.

If you can provide more explanations or examples, will help us troubleshoot it further.

Re: "percent-used" ("percentage-size-used") is calculated differently on differe

RazSK — Wed, 03 Jun 2020 07:54:02 GMT

Hello @Mjizzini . Thank you for prompt response.
I will try to explain.

I am using volume-get-iter ZAPI call and use value of <percentage-size-used> from <volume-space-attributes> . As I have noticed on ONTAP 8.3 and 9.2 (I have those two version) I get percentage-size-used as (Used data space + Snapshot Reserve Size) / Total Volume size

However for same ZAPI call on ONTAP 9.7 I get value of percentage-size-used as Used data space / Data sector Size.

Then I've tried run volume show command with percent-used field on those ONTAP versions and noticed same situation.

Here are examples of output of this command:

C-Mode ONTAP 8.3RC1. Size of Snapshot reserve 10%. And it is shown as used space (alongside with used data 200kb which is less than 1%):

The same situation is for ONTAP 9.2:

However for ONTAP 9.7 the Snapshot reserve isn't included in this percentage. The value of percent used shows only data utilization (and snapshot spill, but not snapshot reserve size). Utilization is 3% despite Snapshot reserve is 50%:

I just want to know from which ONTAP version this calculation approach has changed and where this documented.

Thanks!

Re: "percent-used" ("percentage-size-used") is calculated differently on differe

EWILTS_SAS — Wed, 03 Jun 2020 14:56:14 GMT

Are you using logical-space enforcement or reporting anywhere? If so, all bets are off and df will lie to you. I don't know what the APIs will do - agree with df, an NFS host df, or some magical combination.

ONTAP CLI shows volume at 56% full with nearly 2TB free.

[6/3/2020 09:32:20] blue::> df -h xxxx_x_xx_xxxx -skip-snapshot-lines
Filesystem total used avail capacity Mounted on Vserver
/vol/xxxx_x_xx_xxxx/ 12TB 7421GB 5678GB 56% /xxxx_x_xx_xxxx

But it's actually about 99% full with ~210GB free.

[6/3/2020 09:32:48] blue::> vol show xxxx_x_xx_xxxx -fields is-space-enforcement-logical,is-space-reporting-logical,size,logical-used
vserver volume size logical-used is-space-reporting-logical is-space-enforcement-logical
------- -------------- ------- ------------ -------------------------- ----------------------------
xxx xxxx_x_xx_xxxx 12.79TB 12.58TB true true

and from NFS:
[17:08 ed.wilts@csi160 ~] > df -hP /xxxx-x/xx_xxxx
Filesystem Size Used Avail Use% Mounted on
xxx.xxx.xxx.xxxxxxx.xxx:/xxxx_x_xx_xxxx 13T 13T 213G 99% /xxxx-x/xx_xxxx

Re: "percent-used" ("percentage-size-used") is calculated differently on differe

Mjizzini — Thu, 04 Jun 2020 10:01:40 GMT

I can only answer one portion of your question. I tried it in my lab. The percent-used did change after 9.4.

I still have to check on documentation explaining the changes.

nas-cm92::> version NetApp Release 9.2P4: Tue May 01 19:23:51 UTC 2018 nas-cm92::> vol show -fields percent-used,percent-snapshot-space,used,snapshot-space-used,available -volume svmroot vserver volume available used percent-used percent-snapshot-space snapshot-space-used -------- ------- --------- ----- ------------ ---------------------- ------------------- maliksvm svmroot 18.77MB 232KB 6% 5% 0% nas-cm93::> version NetApp Release 9.3P18: Mon Dec 30 07:28:54 UTC 2019 nas-cm93::> vol show -fields percent-used,percent-snapshot-space,used,snapshot-space-used,available -volume svm_root -vserver mark93 vserver volume available used percent-used percent-snapshot-space snapshot-space-used ------- -------- --------- ----- ------------ ---------------------- ------------------- mark93 svm_root 18.59MB 420KB 7% 5% 0% nas-cm94::> version NetApp Release 9.4P8: Thu Jul 18 23:52:44 UTC 2019 nas-cm94::> vol show -fields percent-used,percent-snapshot-space,used,snapshot-space-used,available -volume svm_root -vserver vin vserver volume available used percent-used percent-snapshot-space snapshot-space-used ------- -------- --------- ----- ------------ ---------------------- ------------------- vin svm_root 18.54MB 472KB 2% 5% 0% nas-cm95::> version NetApp Release 9.5P10: Fri Dec 13 12:32:27 UTC 2019 nas-cm95::> vol show -fields percent-used,percent-snapshot-space,used,snapshot-space-used,available -volume svm_root -vserver rob vserver volume available used percent-used percent-snapshot-space snapshot-space-used ------- -------- --------- ----- ------------ ---------------------- ------------------- rob svm_root 18.41MB 604KB 3% 5% 0% nas-cm96::> version NetApp Release 9.6P8: Sat May 23 16:39:35 UTC 2020 nas-cm96::> vol show -fields percent-used,percent-snapshot-space,used,snapshot-space-used,available -volume svm_root -vserver cpttko vserver volume available used percent-used percent-snapshot-space snapshot-space-used ------- -------- --------- ----- ------------ ---------------------- ------------------- cpttko svm_root 18.49MB 520KB 2% 5% 0%

Re: "percent-used" ("percentage-size-used") is calculated differently on differe

RazSK — Thu, 04 Jun 2020 10:32:22 GMT

Hello @EWILTS_SAS . Thanks for the reply.
In my case both is-space-reporting-logical and is-space-enforcement-logical are false. Even if turn them to trues - usage percent remains the same. I read that it in that case space, saved by the storage efficiency features calculates as used space, but not Snapshot reserve.

Re: "percent-used" ("percentage-size-used") is calculated differently on differe

RazSK — Thu, 04 Jun 2020 10:34:20 GMT

Hello @Mjizzini . Many thanks for this investigation.
And, yes, it will be great to find place in documentation where this changes is described.