Edit

Supported metrics for Microsoft.StorageCache/caches

The following table lists the metrics available for the Microsoft.StorageCache/caches resource type.

Table headings

  • Metric - The metric display name as it appears in the Azure portal.
  • Name in Rest API - Metric name as referred to in the REST API.
  • Advanced platform metrics - A premium, paid tier of platform metrics in Azure Monitor that provide more granular observability for Azure resources.
  • Unit - Unit of measure.
  • Aggregation - The default aggregation type. Valid values: Average, Minimum, Maximum, Total, Count.
  • Dimensions - Dimensions available for the metric.
  • Time Grains - Intervals at which the metric is sampled. For example, PT1M indicates that the metric is sampled every minute, PT30M every 30 minutes, PT1H every hour, and so on.
  • DS Export -S Whether the metric is exportable to Azure Monitor Logs via Diagnostic Settings.

For information on exporting metrics, see - Metrics export using data collection rules and Create diagnostic settings in Azure Monitor.

For information on metric retention, see Azure Monitor Metrics overview.

For a list of supported logs, see Supported log categories - Microsoft.StorageCache/caches

Metric Name in REST API Advanced platform metrics Unit Aggregation Dimensions Time Grains DS Export
Total Client IOPS

The rate of client file operations processed by the Cache.
ClientIOPS No Count Minimum, Maximum, Average <none> PT1M Yes
Average Client Latency

Average latency of client file operations to the Cache.
ClientLatency No MilliSeconds Minimum, Maximum, Average <none> PT1M Yes
Client Lock IOPS

Client file locking operations per second.
ClientLockIOPS No CountPerSecond Minimum, Maximum, Average <none> PT1M Yes
Client Metadata Read IOPS

The rate of client file operations sent to the Cache, excluding data reads, that do not modify persistent state.
ClientMetadataReadIOPS No CountPerSecond Minimum, Maximum, Average <none> PT1M Yes
Client Metadata Write IOPS

The rate of client file operations sent to the Cache, excluding data writes, that modify persistent state.
ClientMetadataWriteIOPS No CountPerSecond Minimum, Maximum, Average <none> PT1M Yes
Client Read IOPS

Client read operations per second.
ClientReadIOPS No CountPerSecond Minimum, Maximum, Average <none> PT1M Yes
Average Cache Read Throughput

Client read data transfer rate.
ClientReadThroughput No BytesPerSecond Minimum, Maximum, Average <none> PT1M Yes
Client Status

Client connection information.
ClientStatus No Count Total (Sum) ClientSource, CacheAddress, ClientAddress, Protocol, ConnectionType PT1M Yes
Client Write IOPS

Client write operations per second.
ClientWriteIOPS No CountPerSecond Minimum, Maximum, Average <none> PT1M Yes
Average Cache Write Throughput

Client write data transfer rate.
ClientWriteThroughput No BytesPerSecond Minimum, Maximum, Average <none> PT1M Yes
File Operations

Number of file operations per second.
FileOps No CountPerSecond Minimum, Maximum, Average SourceFile, Rank, FileType PT1M Yes
File Reads

Number of bytes per second read from a file.
FileReads No BytesPerSecond Minimum, Maximum, Average SourceFile, Rank, FileType PT1M Yes
File Updates

Number of directory updates and metadata operations per second.
FileUpdates No CountPerSecond Minimum, Maximum, Average SourceFile, Rank, FileType PT1M Yes
File Writes

Number of bytes per second written to a file.
FileWrites No BytesPerSecond Minimum, Maximum, Average SourceFile, Rank, FileType PT1M Yes
Storage Target Access Errors Received

The rate of access error responses received by the cache from a specific StorageTarget. For more information, see https://www.rfc-editor.org/rfc/rfc1813#section-2.6 (NFS3ERR_ACCES).
StorageTargetAccessErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
StorageTarget Asynchronous Write Throughput

The rate the Cache asynchronously writes data to a particular StorageTarget. These are opportunistic writes that do not cause clients to block.
StorageTargetAsyncWriteThroughput No BytesPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Blocks Recycled

Total number of 16k cache blocks recycled (freed) per Storage Target.
StorageTargetBlocksRecycled No Count Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target File Too Large Errors Received

The rate of file too large error responses received by the cache from a specific StorageTarget. For more information, see https://www.rfc-editor.org/rfc/rfc1813#section-2.6 (NFS3ERR_FBIG).
StorageTargetFileTooLargeErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
StorageTarget Fill Throughput

The rate the Cache reads data from the StorageTarget to handle a cache miss.
StorageTargetFillThroughput No BytesPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Total Flush Failures

The rate of file flush request failures reported by the writeback state machine for a specific StorageTarget.
StorageTargetFlushFailureErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Free Read Space

Read space available for caching files associated with a storage target.
StorageTargetFreeReadSpace No Bytes Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Free Write Space

Write space available for changed files associated with a storage target.
StorageTargetFreeWriteSpace No Bytes Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Health

Boolean results of connectivity test between the Cache and Storage Targets.
StorageTargetHealth No Count Minimum, Maximum, Average <none> PT1M Yes
Total StorageTarget IOPS

The rate of all file operations the Cache sends to a particular StorageTarget.
StorageTargetIOPS No Count Minimum, Maximum, Average StorageTarget PT1M Yes
StorageTarget Latency

The average round trip latency of all the file operations the Cache sends to a particular StorageTarget.
StorageTargetLatency No MilliSeconds Minimum, Maximum, Average StorageTarget PT1M Yes
StorageTarget Metadata Read IOPS

The rate of file operations that do not modify persistent state, and excluding the read operation, that the Cache sends to a particular StorageTarget.
StorageTargetMetadataReadIOPS No CountPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
StorageTarget Metadata Write IOPS

The rate of file operations that do modify persistent state and excluding the write operation, that the Cache sends to a particular StorageTarget.
StorageTargetMetadataWriteIOPS No CountPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target No Space Errors Received

The rate of no space available error responses received by the cache from a specific StorageTarget. For more information, see https://www.rfc-editor.org/rfc/rfc1813#section-2.6 (NFS3ERR_NOSPC).
StorageTargetNoSpaceErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Permission Errors Received

The rate of permission error responses received by the cache from a specific StorageTarget. For more information, see https://www.rfc-editor.org/rfc/rfc1813#section-2.6 (NFS3ERR_PERM).
StorageTargetPermissionErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Quota Limit Errors Received

The rate of quota limit error responses received by the cache from a specific StorageTarget. For more information, see https://www.rfc-editor.org/rfc/rfc1813#section-2.6 (NFS3ERR_DQUOT).
StorageTargetQuotaLimitErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
StorageTarget Read Ahead Throughput

The rate the Cache opportunistically reads data from the StorageTarget.
StorageTargetReadAheadThroughput No BytesPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
StorageTarget Read IOPS

The rate of file read operations the Cache sends to a particular StorageTarget.
StorageTargetReadIOPS No CountPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Read-Only Filesystem Errors Received

The rate of read-only filesystem error responses received by the cache from a specific StorageTarget. For more information, see https://www.rfc-editor.org/rfc/rfc1813#section-2.6 (NFS3ERR_ROFS).
StorageTargetReadOnlyErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Recycle Rate

Cache space recycle rate associated with a storage target in the HPC Cache. This is the rate at which existing data is cleared from the cache to make room for new data.
StorageTargetRecycleRate No BytesPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Request Too Small Errors Received

The rate of request too small error responses received by the cache from a specific StorageTarget. For more information, see https://www.rfc-editor.org/rfc/rfc1813#section-2.6 (NFS3ERR_TOOSMALL).
StorageTargetRequestTooSmallErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Retryable Flush Request Errors

The rate of retryable file flush errors reported by the writeback state machine for a specific StorageTarget.
StorageTargetRetryableFlushErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Space Allocation

Total space (read and write) allocated for a storage target.
StorageTargetSpaceAllocation No Bytes Minimum, Maximum, Average StorageTarget PT1M Yes
StorageTarget Synchronous Write Throughput

The rate the Cache synchronously writes data to a particular StorageTarget. These are writes that do cause clients to block.
StorageTargetSyncWriteThroughput No BytesPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Total Cache Ops

The rate of operations the cache is servicing for the namespace represented by a specific StorageTarget.
StorageTargetTotalCacheOps No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Total Read Space

Total read space allocated for caching files associated with a storage target.
StorageTargetTotalReadSpace No Bytes Minimum, Maximum, Average StorageTarget PT1M Yes
StorageTarget Total Read Throughput

The total rate that the Cache reads data from a particular StorageTarget.
StorageTargetTotalReadThroughput No BytesPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Total Write Space

Total write space allocated for changed files associated with a storage target.
StorageTargetTotalWriteSpace No Bytes Minimum, Maximum, Average StorageTarget PT1M Yes
StorageTarget Total Write Throughput

The total rate that the Cache writes data to a particular StorageTarget.
StorageTargetTotalWriteThroughput No BytesPerSecond Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Uncoverable Flush Request Errors

The rate of unrecoverable file flush errors reported by the writeback state machine for a specific StorageTarget.
StorageTargetUnrecoverableFlushErrors No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Update Found Asynchronous Verification Cache Ops

The rate of file updates discovered by asynchronous verification operations sent by the cache to a specific StorageTarget.
StorageTargetUpdateFoundAsyncCacheOps No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Update Found Synchronous Verification Cache Ops

The rate of file updates discovered by synchronous verification operations sent by the cache to a specific StorageTarget.
StorageTargetUpdateFoundSyncCacheOps No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Used Read Space

Read space used by cached files associated with a storage target.
StorageTargetUsedReadSpace No Bytes Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Used Write Space

Write space used by changed files associated with a storage target.
StorageTargetUsedWriteSpace No Bytes Minimum, Maximum, Average StorageTarget PT1M Yes
Storage Target Asynchronous Verification Cache Ops

The rate of asynchronous verification operations sent by the cache to a specific StorageTarget.
StorageTargetVerificationAsyncCacheOps No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
Storage Target Synchronous Verification Cache Ops

The rate of synchronous verification operations sent by the cache to a specific StorageTarget.
StorageTargetVerificationSyncCacheOps No Count Minimum, Maximum, Average, Total (Sum) StorageTarget PT1M Yes
StorageTarget Write IOPS

The rate of the file write operations the Cache sends to a particular StorageTarget.
StorageTargetWriteIOPS No Count Minimum, Maximum, Average StorageTarget PT1M Yes
Total Blocks Recycled

Total number of 16k cache blocks recycled (freed) for the HPC Cache.
TotalBlocksRecycled No Count Minimum, Maximum, Average <none> PT1M Yes
Free Read Space

Total space available for caching read files.
TotalFreeReadSpace No Bytes Minimum, Maximum, Average <none> PT1M Yes
Free Write Read Space

Total write space available to store changed data in the cache.
TotalFreeWriteSpace No Bytes Minimum, Maximum, Average <none> PT1M Yes
Recycle Rate

Total cache space recycle rate in the HPC Cache. This is the rate at which existing data is cleared from the cache to make room for new data.
TotalRecycleRate No BytesPerSecond Minimum, Maximum, Average <none> PT1M Yes
Used Read Space

Total read space used by changed files for the HPC Cache.
TotalUsedReadSpace No Bytes Minimum, Maximum, Average <none> PT1M Yes
Used Write Space

Total write space used by changed files for the HPC Cache.
TotalUsedWriteSpace No Bytes Minimum, Maximum, Average <none> PT1M Yes
Uptime

Boolean results of connectivity test between the Cache and monitoring system.
Uptime No Count Minimum, Maximum, Average <none> PT1M Yes

Next steps