Использование Azure Monitor для анализа метрик Файлы Azure

Вы можете анализировать метрики для служба хранилища Azure с помощью метрик из других служб Azure с помощью обозревателя метрик Azure Monitor. Откройте обозреватель метрик, выбрав метрики в меню Azure Monitor . Дополнительные сведения об использовании этого средства см. в разделе "Анализ метрик" с помощью обозревателя метрик Azure Monitor.

Для метрик с поддержкой измерений можно выполнить фильтрацию по нужному значению измерения. Полный список измерений, поддерживаемых службой хранилища Azure, см. в разделе Измерения метрик.

Отображение определения метрики

Можно получить список определений метрик учетной записи хранения или службы "Файлы Azure". Используйте командлет Get-AzMetricDefinition.

В этом примере замените заполнитель <resource-ID> на ИД ресурса всей учетной записи хранения или ИД ресурса службы "Файлы Azure". Эти ИД ресурса можно найти на странице свойств учетной записи хранения на портале Azure.

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

Считывание значений метрик

Значения метрик можно получить на уровне учетной записи для учетной записи хранения или службы "Файлы Azure". Используйте командлет 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". Используйте команду az monitor metrics list-definitions.

В этом примере замените заполнитель <resource-ID> на ИД ресурса всей учетной записи хранения или ИД ресурса службы "Файлы Azure". Эти ИД ресурса можно найти на странице свойств учетной записи хранения на портале Azure.

   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 предоставляет пакет SDK для .NET для считывания определения и значений метрик. Пример кода демонстрирует использование пакета SDK с различными параметрами. Необходимо использовать 0.18.0-preview или более позднюю версию для метрик хранилища.

В этих примерах замените заполнитель <resource-ID> на ИД ресурса всей учетной записи хранения или службы "Файлы Azure". Эти ИД ресурса можно найти на странице свойств учетной записи хранения на портале Azure.

Замените переменную <subscription-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://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
        }
    }