Azure Monitor を使用して Azure Files のメトリックを分析する

Azure Monitor Metrics Explorer を使用して、他の Azure サービスのメトリックと共に Azure Storage のメトリックを分析できます。 [Azure Monitor] メニューの [メトリック] を選択し、Metrics Explorer を開きます。 このツールの使用法の詳細については、「Azure Monitor Metrics Explorer を使用してメトリックを分析する」を参照してください。

ディメンションをサポートするメトリックについては、目的のディメンション値でメトリックをフィルター処理できます。 Azure Storage でサポートされるディメンションの完全な一覧については、「メトリックのディメンション」をご覧ください。

メトリック定義の一覧表示

ストレージ アカウントまたは Azure Files サービスのメトリック定義を一覧表示できます。 Get-AzMetricDefinition コマンドレットを使用します。

この例では、<resource-ID> プレースホルダーをストレージ アカウント全体のリソース ID または Azure Files サービスのリソース ID に置き換えます。 これらのリソース ID は、Azure portal 上のストレージ アカウントの [プロパティ] ページで確認できます。

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

メトリック値を読み取る

ストレージ アカウントまたは Azure Files サービスのアカウント レベルのメトリック値を読み取ることができます。 Get-AzMetric コマンドレットを使用します。

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

ディメンションのあるメトリック値を読み取る

メトリックにディメンションが付いている場合、メトリック値を読み取り、ディメンション値をフィルターにしてメトリック値を絞り込むことができます。 Get-AzMetric コマンドレットを使用します。

   $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 Files サービスのメトリック定義を一覧表示できます。 az monitor metrics list-definitions コマンドを使用します。

この例では、<resource-ID> プレースホルダーをストレージ アカウント全体のリソース ID または Azure Files サービスのリソース ID に置き換えます。 これらのリソース ID は、Azure portal 上のストレージ アカウントの [プロパティ] ページで確認できます。

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

アカウント レベルのメトリック値を読み取る

ストレージ アカウントまたは Azure Files サービスのメトリック値を読み取ることができます。 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 が用意されています。 でのパスワードレス認証には DefaultAzureCredential使用します。 詳細については、 Azure サービスのパスワードなしの接続に関するページを参照してください。

まず、必要な NuGet パッケージをインストールします。

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

これらの例では、 <resource-ID> プレースホルダーをストレージ アカウント全体のリソース ID または Azure Files サービスのリソース ID に置き換えます。 これらのリソース ID は、Azure portal 上のストレージ アカウントの [プロパティ] ページで確認できます。

アカウント レベルのメトリック定義を一覧表示する

次の例は、アカウント レベルでメトリック定義を一覧表示する方法を示しています。

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 DefaultAzureCredential());
    
    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 DefaultAzureCredential());
    
    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 DefaultAzureCredential());
    
    // 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}");
            }
        }
    }