Använda Azure Monitor för att analysera Azure Files-mått

Du kan analysera mått för Azure Storage med mått från andra Azure-tjänster med hjälp av Azure Monitor Metrics Explorer. Öppna Metrics Explorer genom att välja Mått från Azure Monitor-menyn . Mer information om hur du använder det här verktyget finns i Analysera mått med Azure Monitor Metrics Explorer.

För mått som stöder dimensioner kan du filtrera måttet med önskat dimensionsvärde. En fullständig lista över de dimensioner som Azure Storage stöder finns i Måttdimensioner.

Visa en lista över måttdefinitionen

Du kan lista måttdefinitionen för ditt lagringskonto eller Azure Files-tjänsten. Använd cmdleten Get-AzMetricDefinition .

I det här exemplet ersätter du <resource-ID> platshållaren med resurs-ID:t för hela lagringskontot eller resurs-ID:t för Azure Files-tjänsten. Du hittar de här resurs-ID:na på sidorna Egenskaper för ditt lagringskonto i Azure-portalen.

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

Läsa måttvärden

Du kan läsa måttvärden på kontonivå för ditt lagringskonto eller Azure Files-tjänsten. Använd cmdleten Get-AzMetric .

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

Läsa måttvärden med dimensioner

När ett mått stöder dimensioner kan du läsa måttvärden och filtrera dem med hjälp av dimensionsvärden. Använd cmdleten 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"

Visa en lista över måttdefinitionen på kontonivå

Du kan lista måttdefinitionen för ditt lagringskonto eller Azure Files-tjänsten. Använd kommandot az monitor metrics list-definitions.

I det här exemplet ersätter du <resource-ID> platshållaren med resurs-ID:t för hela lagringskontot eller resurs-ID:t för Azure Files-tjänsten. Du hittar de här resurs-ID:na på sidorna Egenskaper för ditt lagringskonto i Azure-portalen.

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

Läsa måttvärden på kontonivå

Du kan läsa måttvärdena för ditt lagringskonto eller Azure Files-tjänsten. Använd kommandot az monitor metrics list.

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

Läsa måttvärden med dimensioner

När ett mått stöder dimensioner kan du läsa måttvärden och filtrera dem med hjälp av dimensionsvärden. Använd kommandot az monitor metrics list.

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

Azure Monitor tillhandahåller .NET SDK för att läsa måttdefinitioner och värden. Exempelkoden visar hur du använder SDK med olika parametrar. Du måste använda 0.18.0-preview eller en senare version för lagringsmått.

I de här exemplen <resource-ID> ersätter du platshållaren med resurs-ID:t för hela lagringskontot eller Azure Files-tjänsten. Du hittar de här resurs-ID:na på sidorna Egenskaper för ditt lagringskonto i Azure-portalen.

Ersätt variabeln <subscription-ID> med ID:t för din prenumeration. Vägledning om hur du hämtar värden för , och , finns i Använda portalen för att skapa ett Microsoft Entra-program och tjänstens huvudnamn som kan komma åt resurser.<AccessKey><application-ID><tenant-ID>

Visa en lista över måttdefinitionen på kontonivå

I följande exempel visas hur du listar en måttdefinition på kontonivå:

    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
        }
    }

Läsa måttvärden på kontonivå

I följande exempel visas hur du läser UsedCapacity data på kontonivå:

    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
        }
    }

Läsa flerdimensionella måttvärden

För flerdimensionella mått måste du definiera metadatafilter om du vill läsa måttdata för specifika dimensionsvärden.

I följande exempel visas hur du läser måttdata för måttet som stöder flerdimensionella mått:

    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://azure.microsoft.com/documentation/articles/resource-group-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
        }
    }