MetricsExtensions.GetMetricSummary Method

Definition

Retrieve summary metric data

public static Microsoft.Azure.ApplicationInsights.Query.Models.MetricsSummaryResult GetMetricSummary (this Microsoft.Azure.ApplicationInsights.Query.IMetrics operations, string appId, string metricId, string timespan = default, System.Collections.Generic.IList<string> aggregation = default, int? top = default, string orderby = default, string filter = default);
static member GetMetricSummary : Microsoft.Azure.ApplicationInsights.Query.IMetrics * string * string * string * System.Collections.Generic.IList<string> * Nullable<int> * string * string -> Microsoft.Azure.ApplicationInsights.Query.Models.MetricsSummaryResult
<Extension()>
Public Function GetMetricSummary (operations As IMetrics, appId As String, metricId As String, Optional timespan As String = Nothing, Optional aggregation As IList(Of String) = Nothing, Optional top As Nullable(Of Integer) = Nothing, Optional orderby As String = Nothing, Optional filter As String = Nothing) As MetricsSummaryResult

Parameters

operations
IMetrics

The operations group for this extension method.

appId
String

ID of the application. This is Application ID from the API Access settings blade in the Azure portal.

metricId
String

ID of the metric. This is either a standard AI metric, or an application-specific custom metric. Possible values include: 'requests/count', 'requests/duration', 'requests/failed', 'users/count', 'users/authenticated', 'pageViews/count', 'pageViews/duration', 'client/processingDuration', 'client/receiveDuration', 'client/networkDuration', 'client/sendDuration', 'client/totalDuration', 'dependencies/count', 'dependencies/failed', 'dependencies/duration', 'exceptions/count', 'exceptions/browser', 'exceptions/server', 'sessions/count', 'performanceCounters/requestExecutionTime', 'performanceCounters/requestsPerSecond', 'performanceCounters/requestsInQueue', 'performanceCounters/memoryAvailableBytes', 'performanceCounters/exceptionsPerSecond', 'performanceCounters/processCpuPercentage', 'performanceCounters/processIOBytesPerSecond', 'performanceCounters/processPrivateBytes', 'performanceCounters/processorCpuPercentage', 'availabilityResults/availabilityPercentage', 'availabilityResults/duration', 'billing/telemetryCount', 'customEvents/count'

timespan
String

The timespan over which to retrieve metric values. This is an ISO8601 time period value. If timespan is omitted, a default time range of PT12H ("last 12 hours") is used. The actual timespan that is queried may be adjusted by the server based. In all cases, the actual time span used for the query is included in the response.

aggregation
IList<String>

The aggregation to use when computing the metric values. To retrieve more than one aggregation at a time, separate them with a comma. If no aggregation is specified, then the default aggregation for the metric is used.

top
Nullable<Int32>

The number of segments to return. This value is only valid when segment is specified.

orderby
String

The aggregation function and direction to sort the segments by. This value is only valid when segment is specified.

filter
String

An expression used to filter the results. This value should be a valid OData filter expression where the keys of each clause should be applicable dimensions for the metric you are retrieving.

Returns

Remarks

Gets summary metric values for a single metric

Applies to