使用 Azure Monitor 分析 Azure 文件存储指标

你可以使用 Azure Monitor Metrics Explorer 来分析 Azure 存储的指标，同时结合其他 Azure 服务的指标进行比较。 在 Azure Monitor 菜单中选择指标，以打开指标浏览器。 有关使用此工具的详细信息，请参阅使用 Azure Monitor 指标资源管理器分析指标。

对于支持维度的指标，可使用所需的维度值筛选指标。 有关 Azure 存储支持的维度的完整列表，请参阅指标维度。

列出指标定义

你可以列出存储帐户或 Azure 文件存储服务的指标定义。 请使用 Get-AzMetricDefinition cmdlet。

在本示例中，将 <resource-ID> 占位符替换为整个存储帐户的资源 ID 或 Azure 文件存储服务的资源 ID。 你可以在 Azure 门户中存储帐户的“属性”页上找到这些资源 ID。

   $resourceId = "<resource-ID>"
   Get-AzMetricDefinition -ResourceId $resourceId

读取指标值

你可以读取存储帐户或 Azure 文件存储服务的帐户级别指标值。 使用 Get-AzMetric cmdlet。

   $resourceId = "<resource-ID>"
   Get-AzMetric -ResourceId $resourceId -MetricNames "UsedCapacity" -TimeGrain 01:00:00

读取具有维度的指标值

当指标支持维度时，可以通过使用维度值来读取指标值并对其进行筛选。 使用 Get-AzMetric cmdlet。

   $resourceId = "<resource-ID>"
   Get-AzMetric -ResourceId $resourceId -MetricNames "UsedCapacity" -TimeGrain 01:00:00

$resourceId = "<resource-ID>"
$dimFilter = [String](New-AzMetricFilter -Dimension ApiName -Operator eq -Value "GetFile" 3> $null)
Get-AzMetric -ResourceId $resourceId -MetricName Transactions -TimeGrain 01:00:00 -MetricFilter $dimFilter -AggregationType "Total"

列出帐户级指标定义

你可以列出存储帐户或 Azure 文件存储服务的指标定义。 使用 az monitor metrics list-definitions 命令。

在本示例中，将 <resource-ID> 占位符替换为整个存储帐户的资源 ID 或 Azure 文件存储服务的资源 ID。 你可以在 Azure 门户中存储帐户的“属性”页上找到这些资源 ID。

   az monitor metrics list-definitions --resource <resource-ID>

读取帐户级指标值

你可以读取存储帐户或 Azure 文件存储服务的指标值。 请使用 az monitor metrics list 命令。

   az monitor metrics list --resource <resource-ID> --metric "UsedCapacity" --interval PT1H

读取具有维度的指标值

当指标支持维度时，可以通过使用维度值来读取指标值并对其进行筛选。 请使用 az monitor metrics list 命令。

az monitor metrics list --resource <resource-ID> --metric "Transactions" --interval PT1H --filter "ApiName eq 'GetFile' " --aggregation "Total" 

Azure Monitor 提供 .NET SDK，用于读取指标定义和值。 示例代码演示如何通过不同的参数来使用 SDK。 对于存储指标，需使用 0.18.0-preview 或更高版本。

在这些示例中，将 <resource-ID> 占位符替换为整个存储帐户或 Azure 文件存储服务的资源 ID。 你可以在 Azure 门户中存储帐户的“属性”页上找到这些资源 ID。

将 <subscription-ID> 占位符值替换为你的订阅 ID。 有关如何获取 <tenant-ID>、<application-ID> 和 <AccessKey> 的值的指南，请参阅使用门户创建可访问资源的 Microsoft Entra 应用程序和服务主体。

列出帐户级指标定义

以下示例演示如何列出帐户级别的指标定义：

    public static async Task ListStorageMetricDefinition()
    {
        var resourceId = "<resource-ID>";
        var subscriptionId = "<subscription-ID>";
        var tenantId = "<tenant-ID>";
        var applicationId = "<application-ID>";
        var accessKey = "<AccessKey>";


        MonitorManagementClient readOnlyClient = AuthenticateWithReadOnlyClient(tenantId, applicationId, accessKey, subscriptionId).Result;
        IEnumerable<MetricDefinition> metricDefinitions = await readOnlyClient.MetricDefinitions.ListAsync(resourceUri: resourceId, cancellationToken: new CancellationToken());

        foreach (var metricDefinition in metricDefinitions)
        {
            // Enumerate metric definition:
            //    Id
            //    ResourceId
            //    Name
            //    Unit
            //    MetricAvailabilities
            //    PrimaryAggregationType
            //    Dimensions
            //    IsDimensionRequired
        }
    }

读取帐户级别指标值

以下示例演示如何读取帐户级别的 UsedCapacity 数据：

    public static async Task ReadStorageMetricValue()
    {
        var resourceId = "<resource-ID>";
        var subscriptionId = "<subscription-ID>";
        var tenantId = "<tenant-ID>";
        var applicationId = "<application-ID>";
        var accessKey = "<AccessKey>";

        MonitorClient readOnlyClient = AuthenticateWithReadOnlyClient(tenantId, applicationId, accessKey, subscriptionId).Result;

        Microsoft.Azure.Management.Monitor.Models.Response Response;

        string startDate = DateTime.Now.AddHours(-3).ToUniversalTime().ToString("o");
        string endDate = DateTime.Now.ToUniversalTime().ToString("o");
        string timeSpan = startDate + "/" + endDate;

        Response = await readOnlyClient.Metrics.ListAsync(
            resourceUri: resourceId,
            timespan: timeSpan,
            interval: System.TimeSpan.FromHours(1),
            metricnames: "UsedCapacity",

            aggregation: "Average",
            resultType: ResultType.Data,
            cancellationToken: CancellationToken.None);

        foreach (var metric in Response.Value)
        {
            // Enumerate metric value
            //    Id
            //    Name
            //    Type
            //    Unit
            //    Timeseries
            //        - Data
            //        - Metadatavalues
        }
    }

读取多维指标值

对于多维指标，如果需要读取基于特定维度值的指标数据，则需定义元数据筛选器。

以下示例演示如何根据支持多维的指标读取指标数据：

    public static async Task ReadStorageMetricValueTest()
    {
        // Resource ID for Azure Files
        var resourceId = "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}/fileServices/default";
        var subscriptionId = "<subscription-ID}";
        // How to identify Tenant ID, Application ID and Access Key: https://docs.azure.cn/active-directory/develop/howto-create-service-principal-portal
        var tenantId = "<tenant-ID>";
        var applicationId = "<application-ID>";
        var accessKey = "<AccessKey>";

        MonitorManagementClient readOnlyClient = AuthenticateWithReadOnlyClient(tenantId, applicationId, accessKey, subscriptionId).Result;

        Microsoft.Azure.Management.Monitor.Models.Response Response;

        string startDate = DateTime.Now.AddHours(-3).ToUniversalTime().ToString("o");
        string endDate = DateTime.Now.ToUniversalTime().ToString("o");
        string timeSpan = startDate + "/" + endDate;
        // It's applicable to define meta data filter when a metric support dimension
        // More conditions can be added with the 'or' and 'and' operators, example: BlobType eq 'BlockBlob' or BlobType eq 'PageBlob'
        ODataQuery<MetadataValue> odataFilterMetrics = new ODataQuery<MetadataValue>(
            string.Format("BlobType eq '{0}'", "BlockBlob"));

        Response = readOnlyClient.Metrics.List(
                        resourceUri: resourceId,
                        timespan: timeSpan,
                        interval: System.TimeSpan.FromHours(1),
                        metricnames: "BlobCapacity",
                        odataQuery: odataFilterMetrics,
                        aggregation: "Average",
                        resultType: ResultType.Data);

        foreach (var metric in Response.Value)
        {
            //Enumerate metric value
            //    Id
            //    Name
            //    Type
            //    Unit
            //    Timeseries
            //        - Data
            //        - Metadatavalues
        }
    }