使用 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 提供 Azure.Monitor.Query .NET SDK 来读取指标定义和值。 使用 Azure.Identity 进行无密码身份验证。DefaultAzureCredential 有关详细信息，请参阅 Azure 服务的无密码连接。

首先，安装所需的 NuGet 包：

dotnet add package Azure.Identity
dotnet add package Azure.Monitor.Query

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

列出帐户级指标定义

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

using Azure;
using Azure.Identity;
using Azure.Monitor.Query;
using Azure.Monitor.Query.Models;

public static async Task ListStorageMetricDefinition()
{
    var resourceId = "<resource-ID>";
    var client = new MetricsQueryClient(new Uri("https://management.chinacloudapi.cn/"), new DefaultAzureCredential(new DefaultAzureCredentialOptions { AuthorityHost = AzureAuthorityHosts.AzureChina }));
    
    AsyncPageable<MetricDefinition> metricDefinitions = client.GetMetricDefinitionsAsync(resourceId, metricsNamespace);
    
    await foreach (var metricDefinition in metricDefinitions)
    {
        Console.WriteLine(metricDefinition.Id);
        Console.WriteLine(metricDefinition.ResourceId);
        Console.WriteLine(metricDefinition.Name);
        Console.WriteLine(metricDefinition.Unit);
    }
}

读取帐户级别指标值

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

public static async Task ReadStorageMetricValue()
{
    var resourceId = "<resource-ID>";
    var client = new MetricsQueryClient(new Uri("https://management.chinacloudapi.cn/"), new DefaultAzureCredential(new DefaultAzureCredentialOptions { AuthorityHost = AzureAuthorityHosts.AzureChina }));
    
    Response<MetricsQueryResult> result = await client.QueryResourceAsync(
        resourceId,
        new[] { "UsedCapacity" },
        new MetricsQueryOptions
        {
            Granularity = TimeSpan.FromHours(1),
            Aggregations = { MetricAggregationType.Average },
            TimeRange = new QueryTimeRange(TimeSpan.FromHours(3))
        });
    
    foreach (MetricResult metric in result.Value.Metrics)
    {
        Console.WriteLine(metric.Name);
        Console.WriteLine(metric.Unit);
        foreach(var item in metric.TimeSeries)
        {
            Console.WriteLine("Metadata:");
            foreach(var metadata in item.Metadata)
            {
                Console.WriteLine($"{metadata.Key}: {metadata.Value}");
            }
            Console.WriteLine("Values:");
            foreach(var value in item.Values)
            {
                Console.WriteLine($"TimeStamp: {value.TimeStamp}, Average: {value.Average}");
            }
        }
    }
}

读取多维指标值

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

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

public static async Task ReadStorageMetricValueTest()
{
    // Resource ID for Azure Files
    var resourceId = "<resource-ID>";
    var client = new MetricsQueryClient(new Uri("https://management.chinacloudapi.cn/"), new DefaultAzureCredential(new DefaultAzureCredentialOptions { AuthorityHost = AzureAuthorityHosts.AzureChina }));
    
    // Define a dimension filter to read metric data on specific dimension values
    // More conditions can be added with the 'or' and 'and' operators, example: ApiName eq 'GetFile' or ApiName eq 'PutRange'
    Response<MetricsQueryResult> result = await client.QueryResourceAsync(
        resourceId,
        new[] { "Transactions" },
        new MetricsQueryOptions
        {
            Granularity = TimeSpan.FromHours(1),
            Aggregations = { MetricAggregationType.Average },
            TimeRange = new QueryTimeRange(TimeSpan.FromHours(3)),
            Filter = "ApiName eq 'GetFile'"
        });
    
    foreach (MetricResult metric in result.Value.Metrics)
    {
        Console.WriteLine(metric.Name);
        Console.WriteLine(metric.Unit);
        foreach(var item in metric.TimeSeries)
        {
            Console.WriteLine("Metadata:");
            foreach(var metadata in item.Metadata)
            {
                Console.WriteLine($"{metadata.Key}: {metadata.Value}");
            }
            Console.WriteLine("Values:");
            foreach(var value in item.Values)
            {
                Console.WriteLine($"TimeStamp: {value.TimeStamp}, Average: {value.Average}");
            }
        }
    }