From 7a1d49efbafac7a083865e04ef515b0df0f6808c Mon Sep 17 00:00:00 2001
From: Chris Grindstaff <chris@gstaff.org>
Date: Fri, 9 Aug 2024 16:51:18 -0400
Subject: [PATCH 1/2] doc: release notes for 24.08

---
 CHANGELOG.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 874f18c8f..d051ee4cd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,82 @@
 # Change Log
 ## [Releases](https://github.com/NetApp/harvest/releases)
 
+## 24.05.8 / 2024-08-12 Release
+
+- :gem: Harvest dashboards now include links to other relevant dashboards. This makes it easier to navigate relationships between cluster objects.
+
+- :star: Several of the existing dashboards include new panels in this release:
+  - The Security dashboard shows SSL certificate expiration dates and warns if certificates are expiring soon. Prometheus alerts are created for expired certificates and certificates that will expire within the next month. Thanks to @timstiller for the suggestion.
+  - The Volume and Aggregate dashboards include new panels showing inactive data trends. Thanks to @razaahmed for the suggestion.
+  - The Workload dashboard includes panels showing the QoS percentage utilization at the policy level for shared QoS policies. Thanks to Rusty Brown for the suggestion.
+  - The Datacenter dashboard includes the number of Qtrees, Quotas, and Workloads in the Object Count panel.
+  - The Aggregate dashboard now includes topk timeseries.
+  - The Metadata dashboard now includes a stats panel showing the number of failed collectors. Thanks to @mamoep for the suggestion.
+  - The Metadata dashboard Pollers table includes the resident set size of each poller process.
+  - The StorageGRID Tenant dashboard now includes an "average size per object" column in the Tenant Quota panel. Thanks to @ofu48167 for the contribution.
+
+- :ear_of_rice: Quotas and Qtrees templates are separated into individual templates instead of being combined as in earlier versions of Harvest.
+
+- The ChangeLog plugin monitors metric value changes in addition to label changes. Thanks to @pilot7777 for the suggestion.
+
+- Harvest collects quotas even when there are no qtrees. Thanks to @qrm1982 for reporting.
+
+- The StorageGRID collector supports single sign-on via a credential script auth token. Thanks to @santosh725 for suggesting.
+
+- Harvest supports OAuth 2.0 ONTAP collectors via a credential script auth token.
+
+- Harvest handles lun and namespace metrics with simple names.
+
+- Harvest collects `virtual_used` and `virtual_used_percent` metrics from volumes via REST on ONTAP versions 9.14.1+
+
+- Prometheus metrics retention has been increased to one year in the Docker compose workflow.
+
+- Harvest creates resolution metrics for health alerts. Thanks to @faguayot for suggesting.
+
+- Pollers report their status as the `poller_status` in native and container environments.
+
+- Grafana import allows you to specify a custom all value when importing. Thanks to ChrisGautcher for the suggestion.
+
+- Harvest includes remediation steps for EMS active sync events in the [EMS alert runbook](https://netapp.github.io/harvest/latest/resources/ems-alert-runbook/). Thanks to @Nikhita-13 for the contribution.
+
+- `bin/harvest doctor` reports when exporters are missing
+
+- Harvest allows exporting metrics without a prefix. This can be handy when collecting from a StorageGRID Prometheus instance. See the [storagegrid_metrics.yaml](https://github.com/NetApp/harvest/blob/4e3945c1f299f0f5e9cd0fff899c25121fd3599d/conf/storagegrid/11.6.0/storagegrid_metrics.yaml#L3) template for an example. Thanks to @Bhagyasri-Dolly for suggesting.
+
+- :closed_book: Documentation Additions:
+  - Harvest includes a new "Getting Started" tutorial. Thanks to MichelePardini for the suggestion.
+
+## Announcements
+
+:bangbang: **IMPORTANT** Harvest removed the Service Center row from the Workload dashboard and disabled collection of `qos_detail_service_time_latency` metrics. The metrics can be reenabled by setting `with_service_latency: true` in the WorkloadDetailVolume template file. See [#3015](https://github.com/NetApp/harvest/issues/3015) for details.
+
+:bangbang: **IMPORTANT** If using Docker Compose and you want to keep your historical Prometheus data, please
+read [how to migrate your Prometheus volume](https://github.com/NetApp/harvest/blob/main/docs/MigratePrometheusDocker.md)
+
+:bulb: **IMPORTANT** After upgrade, don't forget to re-import your dashboards, so you get all the new enhancements and fixes. You can import them via the 'bin/harvest grafana import' CLI, from the Grafana UI, or from the 'Maintenance > Reset Harvest Dashboards' button in NAbox3.
+
+## Thanks to all the awesome contributors
+
+:metal: Thanks to all the people who've opened issues, asked questions on Discord, and contributed code or dashboards
+this release:
+
+- @timstiller
+- @razaahmed
+- @mamoep
+- @ofu48167
+- @pilot7777
+- @qrm1982
+- @santosh725
+- @faguayot
+- @Nikhita
+- @Bhagyasri
+- @Falcon667
+- RustyBrown
+- ChrisGautcher
+- MichelePardini
+
+---
+
 ## 24.05.2 / 2024-06-13 Release
 :pushpin: This release is identical to 24.05.0, with the addition of two fixes:
 

From e6447e11fdafe381b3bbb6e39cc4516a6914e801 Mon Sep 17 00:00:00 2001
From: Chris Grindstaff <chris@gstaff.org>
Date: Mon, 12 Aug 2024 08:42:05 -0400
Subject: [PATCH 2/2] doc: release notes for 24.08

---
 CHANGELOG.md                    | 132 ++++++++++++++++++++++++++++++++
 cmd/tools/generate/counter.yaml |  16 ++++
 docs/ontap-metrics.md           |  78 +++++++++----------
 3 files changed, 187 insertions(+), 39 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d051ee4cd..f98b41b08 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -75,6 +75,138 @@ this release:
 - ChrisGautcher
 - MichelePardini
 
+:seedling:
+This release includes 40 features, 28 bug fixes, 13 documentation, 1 performance,
+2 testing, 5 refactoring, 12 miscellaneous, and 11 ci pull requests.
+
+### :rocket: Features
+- Prometheus Should Retain Data For Up To One Year ([#2919](https://github.com/NetApp/harvest/pull/2919))
+- Log Jitter During Best-Fit Template Loading ([#2920](https://github.com/NetApp/harvest/pull/2920))
+- Add Failed Collectors Stats In Metadata Dashboard ([#2929](https://github.com/NetApp/harvest/pull/2929))
+- Linking Dashboard Part-1 ([#2931](https://github.com/NetApp/harvest/pull/2931))
+- Poller's Should Collect And Export Their Status And Memory ([#2944](https://github.com/NetApp/harvest/pull/2944))
+- Include Rss In Poller Table Of Metadata Dashboard ([#2948](https://github.com/NetApp/harvest/pull/2948))
+- Grafana Import Should Allow You To Specify A Custom All Value ([#2953](https://github.com/NetApp/harvest/pull/2953))
+- Harvest Should Include Remediation Steps For Ems Active Sync Ev… ([#2963](https://github.com/NetApp/harvest/pull/2963))
+- Linking Dashboards Part-2 ([#2968](https://github.com/NetApp/harvest/pull/2968))
+- Support For Qos Percentage Utilization At Policy Level For Shared Qos Policies ([#2972](https://github.com/NetApp/harvest/pull/2972))
+- Linking Dashboards Part-3 ([#2976](https://github.com/NetApp/harvest/pull/2976))
+- Create Resolution Metrics For Health Alerts ([#2977](https://github.com/NetApp/harvest/pull/2977))
+- Add Qtree,Quota,Workload Counts To Datacenter Dashboard ([#2978](https://github.com/NetApp/harvest/pull/2978))
+- Harvest Should Track Poller Maxrss In Auto-Support ([#2982](https://github.com/NetApp/harvest/pull/2982))
+- Add Topk To Aggregate Dashboard Timeseries Panels ([#2987](https://github.com/NetApp/harvest/pull/2987))
+- Harvest Should Handle Lun And Namespace Metrics With Simple Names ([#2998](https://github.com/NetApp/harvest/pull/2998))
+- Harvest Should Log Rss And Maxrss Every Hour ([#2999](https://github.com/NetApp/harvest/pull/2999))
+- Implementing Certificate Expiry Detail In Security Dashboard ([#3000](https://github.com/NetApp/harvest/pull/3000))
+- Remove Topk Vars From Storagegrid Dashboards ([#3002](https://github.com/NetApp/harvest/pull/3002))
+- Add Inactive Data Metrics For Aggregate And Volume ([#3003](https://github.com/NetApp/harvest/pull/3003))
+- Harvest Should Remove Service Center Metrics ([#3019](https://github.com/NetApp/harvest/pull/3019))
+- Adding Quotas Detail In Asup ([#3020](https://github.com/NetApp/harvest/pull/3020))
+- Harvest Should Allow Exporting Metrics Without A Prefix ([#3022](https://github.com/NetApp/harvest/pull/3022))
+- Remove Service_time_latency Counter From Tests ([#3027](https://github.com/NetApp/harvest/pull/3027))
+- Harvest Should Collect Virtual_used And Virtual_used_percent ([#3031](https://github.com/NetApp/harvest/pull/3031))
+- Harvest Should Log Template Loading Errors ([#3036](https://github.com/NetApp/harvest/pull/3036))
+- Enable Changelog Plugin To Monitor Metric Value Change ([#3041](https://github.com/NetApp/harvest/pull/3041))
+- `--Debug` Cli Argument Should Enable Debug Logging ([#3043](https://github.com/NetApp/harvest/pull/3043))
+- Harvest Should Support Storagegrid Credentials Script With Auth… ([#3048](https://github.com/NetApp/harvest/pull/3048))
+- Harvest Doctor Should Report When Exporters Are Missing ([#3049](https://github.com/NetApp/harvest/pull/3049))
+- Update Qtree Template Doc -  Collect Quotas When No Qtrees ([#3056](https://github.com/NetApp/harvest/pull/3056))
+- Handled User/Group Quota In Historicallabels ([#3060](https://github.com/NetApp/harvest/pull/3060))
+- Support Oauth2.0 Via Credential Script - Phase1 ([#3066](https://github.com/NetApp/harvest/pull/3066))
+- Harvest Should Not Simultaneously Publish Quota Metrics From Qt… ([#3067](https://github.com/NetApp/harvest/pull/3067))
+- Split Qtree/Quota Rest Templates ([#3068](https://github.com/NetApp/harvest/pull/3068))
+- Adding Generated Instances/Metrics Count In Health Plugin Log ([#3074](https://github.com/NetApp/harvest/pull/3074))
+- Health Dashboard Should Indicate When There Are No Events ([#3077](https://github.com/NetApp/harvest/pull/3077))
+- Keyperfmetrics Collector Infrastructure ([#3078](https://github.com/NetApp/harvest/pull/3078))
+- Adding Ut For Qtree Non Exported Case ([#3085](https://github.com/NetApp/harvest/pull/3085))
+- Tenant Dashboard Should Include An `Average Size Per Object` Co… ([#3091](https://github.com/NetApp/harvest/pull/3091))
+
+### :bug: Bug Fixes
+- Zapi Rest Parity ([#2934](https://github.com/NetApp/harvest/pull/2934))
+- Rest Templates Should Not Have Hyphon ([#2943](https://github.com/NetApp/harvest/pull/2943))
+- Restore The Svm, Qtree, User, And Group Columns To The Quota Das… ([#2950](https://github.com/NetApp/harvest/pull/2950))
+- Harvest Should Log Errors When Grafana Import Fails ([#2962](https://github.com/NetApp/harvest/pull/2962))
+- Correct Details Folder Name While Import ([#2966](https://github.com/NetApp/harvest/pull/2966))
+- Handling Min-Max In Gradient ([#2969](https://github.com/NetApp/harvest/pull/2969))
+- Use Read/Write Data Due To Missing Historical Data In Dashboards ([#2979](https://github.com/NetApp/harvest/pull/2979))
+- Fixing Non-Exported Flexgroup Instances Error ([#2980](https://github.com/NetApp/harvest/pull/2980))
+- Add Shared Column For Workload Used % Tables ([#2986](https://github.com/NetApp/harvest/pull/2986))
+- Qos Sequential Reads And Writes % Panels ([#2992](https://github.com/NetApp/harvest/pull/2992))
+- Power Plugin Should Not Fail ([#2993](https://github.com/NetApp/harvest/pull/2993))
+- Use Avg_over_time For Qos Used % ([#3004](https://github.com/NetApp/harvest/pull/3004))
+- Add Missing Filtering For Metadata Dashboard ([#3005](https://github.com/NetApp/harvest/pull/3005))
+- Handle Endpoints In Metric Doc ([#3011](https://github.com/NetApp/harvest/pull/3011))
+- Handle Partial Aggregation For Flexgroup Perf Metrics ([#3018](https://github.com/NetApp/harvest/pull/3018))
+- Handle Volume Analytics Error Logging ([#3026](https://github.com/NetApp/harvest/pull/3026))
+- Vscan Plugin Should Handle Ipv6 Scanners ([#3028](https://github.com/NetApp/harvest/pull/3028))
+- Vscan Plugin Should Handle Ipv6 Scanners ([#3034](https://github.com/NetApp/harvest/pull/3034))
+- Object Store Metrics Collection For Aggregate ([#3045](https://github.com/NetApp/harvest/pull/3045))
+- Throughput Should Use Sum Aggregation ([#3052](https://github.com/NetApp/harvest/pull/3052))
+- Harvest Should Collect Power Metrics From A1000 And A900 Clusters ([#3063](https://github.com/NetApp/harvest/pull/3063))
+- Quota Dashboard Should Use Kibibytes Instead Of Kilobytes ([#3072](https://github.com/NetApp/harvest/pull/3072))
+- Namespace Dashboard Legends Have A Dangling } ([#3075](https://github.com/NetApp/harvest/pull/3075))
+- Add Color To Relevant Value Mapping Columns In Dashboards ([#3080](https://github.com/NetApp/harvest/pull/3080))
+- Poller Rss Panel Should Ignore Pid ([#3083](https://github.com/NetApp/harvest/pull/3083))
+- Remove Quota Asup From Rest ([#3087](https://github.com/NetApp/harvest/pull/3087))
+- Remove Threshold From Quota Rest Template ([#3093](https://github.com/NetApp/harvest/pull/3093))
+- Add Datacenter, Cluster Columns In Tables With Links ([#3094](https://github.com/NetApp/harvest/pull/3094))
+
+### :closed_book: Documentation
+- Update Docker Instructions ([#2940](https://github.com/NetApp/harvest/pull/2940))
+- Update Metric Docs For 9.15 ([#2957](https://github.com/NetApp/harvest/pull/2957))
+- Add Note For Hardware Requirement For Harvest ([#2964](https://github.com/NetApp/harvest/pull/2964))
+- Fix Standalone Harvest Container Deployment Steps ([#2981](https://github.com/NetApp/harvest/pull/2981))
+- Release Notes For 24.05.2 ([#2985](https://github.com/NetApp/harvest/pull/2985))
+- Add Description In Subsystem Latency Panels ([#3017](https://github.com/NetApp/harvest/pull/3017))
+- Update List Of Supported Fsx Dashboards ([#3037](https://github.com/NetApp/harvest/pull/3037))
+- Harvest Should Document The Least-Privilege Approach For Rest ([#3047](https://github.com/NetApp/harvest/pull/3047))
+- Harvest Getting Started Tutorial ([#3054](https://github.com/NetApp/harvest/pull/3054))
+- Describe How To Collect Support Bundle From Nabox4 ([#3071](https://github.com/NetApp/harvest/pull/3071))
+- Doc Update For Oauth 2.0 Support In Harvest ([#3073](https://github.com/NetApp/harvest/pull/3073))
+- Add Ems Permissions For Rest Least Privilege Approach ([#3088](https://github.com/NetApp/harvest/pull/3088))
+- Add container troubleshooting steps ([#3097](https://github.com/NetApp/harvest/pull/3097))
+ 
+### :zap: Performance
+- Improve Prometheus Render Escaping By 23% ([#2922](https://github.com/NetApp/harvest/pull/2922))
+
+### :wrench: Testing
+- Quota Tests ([#2924](https://github.com/NetApp/harvest/pull/2924))
+- Harvest Should Use Go-Cmp Instead Of Reflect.deepequal ([#3025](https://github.com/NetApp/harvest/pull/3025))
+
+### Refactoring
+- Use Builtin Maps Instead Of 3Rd Party ([#3009](https://github.com/NetApp/harvest/pull/3009))
+- Remove Dead Code And Reduce 3Rd Party Dependencies ([#3039](https://github.com/NetApp/harvest/pull/3039))
+- Remove Obsolete `Version` From Compose Files ([#3042](https://github.com/NetApp/harvest/pull/3042))
+- Update Description For Volume Arw Panel ([#3076](https://github.com/NetApp/harvest/pull/3076))
+- Remove Deprecated Compliance Dashboard ([#3081](https://github.com/NetApp/harvest/pull/3081))
+
+### Miscellaneous
+- Update Module Github.com/Zekrotja/Timedmap To V2 ([#2910](https://github.com/NetApp/harvest/pull/2910))
+- Update All Dependencies ([#2926](https://github.com/NetApp/harvest/pull/2926))
+- Bump Hashicorp Go-Version ([#2933](https://github.com/NetApp/harvest/pull/2933))
+- Update All Dependencies ([#2955](https://github.com/NetApp/harvest/pull/2955))
+- Move Gopsutil To V4 ([#2961](https://github.com/NetApp/harvest/pull/2961))
+- Update All Dependencies ([#2975](https://github.com/NetApp/harvest/pull/2975))
+- Update All Dependencies ([#2995](https://github.com/NetApp/harvest/pull/2995))
+- Update Module Github.com/Zekrotja/Timedmap To V2 ([#3010](https://github.com/NetApp/harvest/pull/3010))
+- Remove Unused Code ([#3016](https://github.com/NetApp/harvest/pull/3016))
+- Update All Dependencies ([#3040](https://github.com/NetApp/harvest/pull/3040))
+- Update Golang.org/X/Exp Digest To 8A7402a ([#3058](https://github.com/NetApp/harvest/pull/3058))
+- Update All Dependencies ([#3084](https://github.com/NetApp/harvest/pull/3084))
+
+### :hammer: CI
+- Fix Flaky Test For Expression ([#2927](https://github.com/NetApp/harvest/pull/2927))
+- Update To Use Colored-Line-Number For Linter ([#2930](https://github.com/NetApp/harvest/pull/2930))
+- Stop Pollers After Tests In Ci ([#2939](https://github.com/NetApp/harvest/pull/2939))
+- Add Zapi Rest Comparison To Ci ([#2945](https://github.com/NetApp/harvest/pull/2945))
+- Fix Container Stop In Ci ([#2946](https://github.com/NetApp/harvest/pull/2946))
+- Stop Containers After Tests ([#2958](https://github.com/NetApp/harvest/pull/2958))
+- Bump Go ([#2965](https://github.com/NetApp/harvest/pull/2965))
+- Run Tests Before Docker Publish ([#2990](https://github.com/NetApp/harvest/pull/2990))
+- Add Flexgroup Tests ([#3001](https://github.com/NetApp/harvest/pull/3001))
+- Bump Go ([#3032](https://github.com/NetApp/harvest/pull/3032))
+- Bump Go ([#3089](https://github.com/NetApp/harvest/pull/3089))
+
 ---
 
 ## 24.05.2 / 2024-06-13 Release
diff --git a/cmd/tools/generate/counter.yaml b/cmd/tools/generate/counter.yaml
index 6e309ed62..54ed69606 100644
--- a/cmd/tools/generate/counter.yaml
+++ b/cmd/tools/generate/counter.yaml
@@ -1,5 +1,21 @@
 counters:
 
+  - Name: aggr_object_store_logical_used
+    Description: Logical space usage of aggregates in the attached object store.
+    APIs:
+      - API: REST
+        Endpoint: api/private/cli/aggr/show-space
+        ONTAPCounter: object_store_logical_used
+        Template: conf/rest/9.12.0/aggr.yaml
+
+  - Name: aggr_object_store_physical_used
+    Description: Physical space usage of aggregates in the attached object store.
+    APIs:
+      - API: REST
+        Endpoint: api/private/cli/aggr/show-space
+        ONTAPCounter: object_store_physical_used
+        Template: conf/rest/9.12.0/aggr.yaml
+
   - Name: aggr_physical_used_wo_snapshots
     Description: Total Data Reduction Physical Used Without Snapshots
 
diff --git a/docs/ontap-metrics.md b/docs/ontap-metrics.md
index 404acba48..6296db046 100644
--- a/docs/ontap-metrics.md
+++ b/docs/ontap-metrics.md
@@ -7,7 +7,7 @@ These can be generated on demand by running `bin/harvest grafana metrics`. See
 - More information about ONTAP REST performance counters can be found [here](https://docs.netapp.com/us-en/ontap-pcmap-9121/index.html).
 
 ```
-Creation Date : 2024-Jun-26
+Creation Date : 2024-Aug-12
 ONTAP Version: 9.15.1
 ```
 ## Understanding the structure
@@ -9998,11 +9998,11 @@ The destination port used to forward the message.
 
 ### security_certificate_expiry_time
 
-Certificate expiration time, in ISO 8601 duration format or date and time format. Can be provided on POST if creating self-signed certificate. The expiration time range is between 1 day to 10 years.
+
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/security/certificates` | `expiry_time` | conf/rest/9.12.0/security_certificate.yaml |
+| REST | `api/private/cli/security/certificate` | `expiration` | conf/rest/9.12.0/security_certificate.yaml |
 | ZAPI | `security-certificate-get-iter` | `certificate-info.expiration-date` | conf/zapi/cdot/9.8.0/security_certificate.yaml |
 
 
@@ -12743,7 +12743,7 @@ Used space threshold which triggers autogrow. When the size-used is greater than
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `autosize_grow_threshold_percent` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `autosize_grow_threshold_percent` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-autosize-attributes.grow-threshold-percent` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -12753,7 +12753,7 @@ The maximum size (in bytes) to which the volume would be grown automatically. Th
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `max_autosize` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `max_autosize` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-autosize-attributes.maximum-size` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -12773,7 +12773,7 @@ Average latency in microseconds for the WAFL filesystem to process all the opera
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin1` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin1` | conf/rest/9.14.0/volume.yaml |
 
 
 ### volume_capacity_tier_footprint_percent
@@ -12782,7 +12782,7 @@ Average latency in microseconds for the WAFL filesystem to process all the opera
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin1_percent` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin1_percent` | conf/rest/9.14.0/volume.yaml |
 
 
 ### volume_filesystem_size
@@ -12791,7 +12791,7 @@ Filesystem size (in bytes) of the volume.  This is the total usable size of the
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `filesystem_size` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `filesystem_size` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.filesystem-size` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -12821,7 +12821,7 @@ volume_inode_files_used / volume_inode_total
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `inode_files_used, inode_files_total` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `inode_files_used, inode_files_total` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `inode_files_used, inode_files_total` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13001,7 +13001,7 @@ Number of NFS write operations per second to the volume
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume/efficiency/stat` | `num_compress_attempts` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume/efficiency/stat` | `num_compress_attempts` | conf/rest/9.14.0/volume.yaml |
 
 
 ### volume_num_compress_fail
@@ -13010,7 +13010,7 @@ Number of NFS write operations per second to the volume
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume/efficiency/stat` | `num_compress_fail` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume/efficiency/stat` | `num_compress_fail` | conf/rest/9.14.0/volume.yaml |
 
 
 ### volume_other_latency
@@ -13039,7 +13039,7 @@ amount of storage space that is currently available for overwrites, calculated b
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `overwrite_reserve_total, overwrite_reserve_used` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `overwrite_reserve_total, overwrite_reserve_used` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `overwrite_reserve_total, overwrite_reserve_used` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13049,7 +13049,7 @@ The size (in bytes) that is reserved for overwriting snapshotted data in an othe
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `overwrite_reserve` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `overwrite_reserve` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.overwrite-reserve` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13059,7 +13059,7 @@ The reserved size (in bytes) that is not available for new overwrites. The numbe
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `overwrite_reserve_used` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `overwrite_reserve_used` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.overwrite-reserve-used` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13069,7 +13069,7 @@ The reserved size (in bytes) that is not available for new overwrites. The numbe
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin0` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin0` | conf/rest/9.14.0/volume.yaml |
 
 
 ### volume_performance_tier_footprint_percent
@@ -13078,7 +13078,7 @@ The reserved size (in bytes) that is not available for new overwrites. The numbe
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin0_percent` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume/footprint` | `volume_blocks_footprint_bin0_percent` | conf/rest/9.14.0/volume.yaml |
 
 
 ### volume_read_data
@@ -13177,7 +13177,7 @@ Physical size of the volume, in bytes. The minimum size for a FlexVol volume is
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `size` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `size` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.size` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13187,7 +13187,7 @@ The size (in bytes) that is still available in the volume. This field is valid o
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `available` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `available` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.size-available` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13197,7 +13197,7 @@ Total usable size (in bytes) of the volume, not including WAFL reserve or volume
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `total` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `total` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.size-total` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13207,7 +13207,7 @@ Number of bytes used in the volume.  If the volume is restricted or offline, a v
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `used` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `used` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.size-used` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13217,7 +13217,7 @@ percentage of utilized storage space in a volume relative to its total capacity
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `percent_used` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `percent_used` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.percentage-size-used` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13227,7 +13227,7 @@ Number of Snapshot copies in the volume.
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `snapshot_count` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `snapshot_count` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-snapshot-attributes.snapshot-count` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13237,7 +13237,7 @@ The size (in bytes) that is available for Snapshot copies inside the Snapshot re
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `snapshot_reserve_available` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `snapshot_reserve_available` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.snapshot-reserve-available` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13247,7 +13247,7 @@ The percentage of volume disk space that has been set aside as reserve for snaps
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `percent_snapshot_space` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `percent_snapshot_space` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.percentage-snapshot-reserve` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13257,7 +13257,7 @@ The size (in bytes) in the volume that has been set aside as reserve for snapsho
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `snapshot_reserve_size` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `snapshot_reserve_size` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.snapshot-reserve-size` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13267,7 +13267,7 @@ amount of storage space currently used by a volume's snapshot reserve, which is
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `snapshot_reserve_size, snapshot_reserve_available` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `snapshot_reserve_size, snapshot_reserve_available` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `snapshot_reserve_size, snapshot_reserve_available` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13277,7 +13277,7 @@ Percentage of the volume reserved for snapshots that has been used. Note that in
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `snapshot_space_used` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `snapshot_space_used` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.percentage-snapshot-reserve-used` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13287,7 +13287,7 @@ Total free space (in bytes) available in the volume and the snapshot reserve. If
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `size_available_for_snapshots` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `size_available_for_snapshots` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.size-available-for-snapshots` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13297,7 +13297,7 @@ The size (in bytes) that is used by snapshots in the volume.
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `size_used_by_snapshots` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `size_used_by_snapshots` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.size-used-by-snapshots` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13307,7 +13307,7 @@ The size (in bytes) that should be available for the volume irrespective of avai
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `expected_available` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `expected_available` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.expected-available` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13317,7 +13317,7 @@ The size (in bytes) that is logically available in the volume.This is the amount
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `logical_available` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `logical_available` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.logical-available` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13327,7 +13327,7 @@ The size (in bytes) that is logically used in the volume.This value includes all
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `logical_used` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `logical_used` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.logical-used` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13337,7 +13337,7 @@ The size (in bytes) that is logically used by the active filesystem of the volum
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `logical_used_by_afs` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `logical_used_by_afs` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.logical-used-by-afs` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13347,7 +13347,7 @@ The size (in bytes) that is logically used across all Snapshot copies in the vol
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `logical_used_by_snapshots` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `logical_used_by_snapshots` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.logical-used-by-snapshots` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13357,7 +13357,7 @@ Percentage of the logical used size of the volume.This parameter is not supporte
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `logical_used_percent` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `logical_used_percent` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.logical-used-percent` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13367,7 +13367,7 @@ The size that is physically used in the performance tier of the volume and has a
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `performance_tier_inactive_user_data` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `performance_tier_inactive_user_data` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.performance-tier-inactive-user-data` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13377,7 +13377,7 @@ The size (in percent) that is physically used in the performance tier of the vol
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `performance_tier_inactive_user_data_percent` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `performance_tier_inactive_user_data_percent` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.performance-tier-inactive-user-data-percent` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13387,7 +13387,7 @@ The size (in bytes) that is physically used in the volume.This differs from 'tot
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `physical_used` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `virtual_used` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.physical-used` | conf/zapi/cdot/9.8.0/volume.yaml |
 
 
@@ -13397,7 +13397,7 @@ The size (in percent) that is physically used in the volume.The percentage is ba
 
 | API    | Endpoint | Metric | Template |
 |--------|----------|--------|---------|
-| REST | `api/private/cli/volume` | `physical_used_percent` | conf/rest/9.12.0/volume.yaml |
+| REST | `api/private/cli/volume` | `virtual_used_percent` | conf/rest/9.14.0/volume.yaml |
 | ZAPI | `volume-get-iter` | `volume-attributes.volume-space-attributes.physical-used-percent` | conf/zapi/cdot/9.8.0/volume.yaml |