Metrics - Get

참조

Service:: Application Insights

API Version:: v1

메트릭 데이터 검색
단일 메트릭에 대한 메트릭 값을 가져옵니다.

GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}

With optional parameters:

GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}?timespan={timespan}&interval={interval}&aggregation={aggregation}&segment={segment}&top={top}&orderby={orderby}&filter={filter}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
appId	path	True	string	애플리케이션의 ID입니다. Azure Portal API 액세스 설정 블레이드의 애플리케이션 ID입니다.
metricId	path	True	MetricId	메트릭의 ID입니다. 표준 AI 메트릭 또는 애플리케이션별 사용자 지정 메트릭입니다.
aggregation	query		MetricsAggregation[]	메트릭 값을 계산할 때 사용할 집계입니다. 한 번에 둘 이상의 집계를 검색하려면 쉼표로 구분합니다. 집계를 지정하지 않으면 메트릭에 대한 기본 집계가 사용됩니다.
filter	query		string	결과를 필터링하는 데 사용되는 식입니다. 이 값은 검색하는 메트릭에 대해 각 절의 키를 적용할 수 있는 유효한 OData 필터 식이어야 합니다.
interval	query		string duration	메트릭 값을 검색할 때 사용할 시간 간격입니다. ISO8601 기간입니다. 간격을 생략하면 메트릭 값이 전체 시간 범위에서 집계됩니다. interval이 제공되면 서버는 쿼리에 사용되는 시간 간격에 따라 간격을 보다 적절한 크기로 조정할 수 있습니다. 모든 경우에 쿼리에 사용되는 실제 간격이 응답에 포함됩니다.
orderby	query		string	세그먼트를 정렬할 집계 함수 및 방향입니다. 이 값은 세그먼트가 지정된 경우에만 유효합니다.
segment	query		MetricsSegment[]	메트릭 값을 구분할 차원의 이름입니다. 이 차원은 검색하는 메트릭에 적용할 수 있어야 합니다. 한 번에 둘 이상의 차원으로 분할하려면 쉼표(,)로 구분합니다. 이 경우 메트릭 데이터는 차원이 매개 변수에 나열되는 순서대로 분할됩니다.
timespan	query		string	메트릭 값을 검색할 시간 범위입니다. 이는 ISO8601 기간 값입니다. 시간 범위를 생략하면 기본 시간 범위 `PT12H` ("마지막 12시간")가 사용됩니다. 쿼리되는 실제 시간 범위는 서버 기반에서 조정할 수 있습니다. 모든 경우에 쿼리에 사용되는 실제 시간 범위가 응답에 포함됩니다.
top	query		integer int32	반환할 세그먼트 수입니다. 이 값은 세그먼트가 지정된 경우에만 유효합니다.

응답

Name	형식	Description
200 OK	metricsResult	성공적인 응답
Other Status Codes	errorResponse	오류 응답 개체입니다.

보안

oauth2

Azure 애플리케이션 Insights API에 연결

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

intervaledMetric

segmentedIntervaledMetric

simpleMetric

intervaledMetric

Sample Request

HTTP

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D

Sample Response

Status code:: 200

{
  "value": {
    "start": "2018-02-04T10:01:35.086Z",
    "end": "2018-02-06T10:01:35.086Z",
    "interval": "P1D",
    "segments": [
      {
        "start": "2018-02-04T10:01:35.086Z",
        "end": "2018-02-05T00:00:00.000Z",
        "requests/count": {
          "sum": 4927
        }
      },
      {
        "start": "2018-02-05T00:00:00.000Z",
        "end": "2018-02-06T00:00:00.000Z",
        "requests/count": {
          "sum": 8460
        }
      },
      {
        "start": "2018-02-06T00:00:00.000Z",
        "end": "2018-02-06T10:01:35.086Z",
        "requests/count": {
          "sum": 3743
        }
      }
    ]
  }
}

segmentedIntervaledMetric

Sample Request

HTTP

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D&segment=operation/name,request/success

Sample Response

Status code:: 200

{
  "value": {
    "start": "2018-10-22T10:40:09.065Z",
    "end": "2018-10-22T22:40:09.065Z",
    "segments": [
      {
        "operation/name": "GET Home/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 156483,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 3795,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /",
        "segments": [
          {
            "requests/count": null,
            "sum": 34168,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 12,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /FabrikamProd/Content/fonts/segoewp-light-webfont.eot",
        "segments": [
          {
            "requests/count": null,
            "sum": 9378,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /FabrikamProd/Content/fonts/segoewp-webfont.eot",
        "segments": [
          {
            "requests/count": null,
            "sum": 9370,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/Details",
        "segments": [
          {
            "requests/count": null,
            "sum": 1989,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 14,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1991,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Employees/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1990,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/GetLogEntries",
        "segments": [
          {
            "requests/count": null,
            "sum": 1985,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Employees/Details",
        "segments": [
          {
            "requests/count": null,
            "sum": 663,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 663,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Reports/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1086,
            "request/success": true
          }
        ]
      }
    ]
  }
}

simpleMetric

Sample Request

HTTP

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount

Sample Response

Status code:: 200

{
  "value": {
    "start": "2016-01-01T02:00:00.000Z",
    "end": "2016-01-03T02:00:00.000Z",
    "requests/count": {
      "sum": 23
    }
  }
}

정의

Name	Description
errorDetail	오류 세부 정보입니다.
errorInfo	오류에 대한 코드 및 메시지입니다.
errorResponse	오류 세부 정보입니다.
MetricId	메트릭의 ID입니다. 표준 AI 메트릭 또는 애플리케이션별 사용자 지정 메트릭입니다.
MetricsAggregation	메트릭 값을 계산할 때 사용할 집계입니다. 한 번에 둘 이상의 집계를 검색하려면 쉼표로 구분합니다. 집계를 지정하지 않으면 메트릭에 대한 기본 집계가 사용됩니다.
metricsResult	메트릭 결과입니다.
metricsResultInfo	메트릭 결과 데이터입니다.
MetricsSegment	메트릭 값을 구분할 차원의 이름입니다. 이 차원은 검색하는 메트릭에 적용할 수 있어야 합니다. 한 번에 둘 이상의 차원으로 분할하려면 쉼표(,)로 구분합니다. 이 경우 메트릭 데이터는 차원이 매개 변수에 나열되는 순서대로 분할됩니다.
metricsSegmentInfo	메트릭 세그먼트

errorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalProperties	object
code	string	오류의 코드입니다.
message	string	사람이 읽을 수 있는 오류 메시지입니다.
resources	string[]	오류를 담당한 리소스를 나타냅니다.
target	string	요청에서 오류를 담당하는 속성을 나타냅니다.
value	string	오류를 담당하는 '대상'의 값을 나타냅니다.

errorInfo

오류에 대한 코드 및 메시지입니다.

Name	형식	Description
additionalProperties	object
code	string	컴퓨터에서 읽을 수 있는 오류 코드입니다.
details	errorDetail[]	오류 세부 정보입니다.
innererror	errorInfo	오류에 대한 코드 및 메시지입니다. 내부 오류 세부 정보(있는 경우)
message	string	사람이 읽을 수 있는 오류 메시지입니다.

errorResponse

오류 세부 정보입니다.

Name	형식	Description
error	errorInfo	오류에 대한 코드 및 메시지입니다. 오류 세부 정보입니다.

MetricId

메트릭의 ID입니다. 표준 AI 메트릭 또는 애플리케이션별 사용자 지정 메트릭입니다.

Name	형식	Description
availabilityResults/availabilityPercentage	string
availabilityResults/duration	string
billing/telemetryCount	string
client/networkDuration	string
client/processingDuration	string
client/receiveDuration	string
client/sendDuration	string
client/totalDuration	string
customEvents/count	string
dependencies/count	string
dependencies/duration	string
dependencies/failed	string
exceptions/browser	string
exceptions/count	string
exceptions/server	string
pageViews/count	string
pageViews/duration	string
performanceCounters/exceptionsPerSecond	string
performanceCounters/memoryAvailableBytes	string
performanceCounters/processCpuPercentage	string
performanceCounters/processIOBytesPerSecond	string
performanceCounters/processPrivateBytes	string
performanceCounters/processorCpuPercentage	string
performanceCounters/requestExecutionTime	string
performanceCounters/requestsInQueue	string
performanceCounters/requestsPerSecond	string
requests/count	string
requests/duration	string
requests/failed	string
sessions/count	string
users/authenticated	string
users/count	string

MetricsAggregation

메트릭 값을 계산할 때 사용할 집계입니다. 한 번에 둘 이상의 집계를 검색하려면 쉼표로 구분합니다. 집계를 지정하지 않으면 메트릭에 대한 기본 집계가 사용됩니다.

Name	형식	Description
avg	string
count	string
max	string
min	string
sum	string
unique	string

metricsResult

메트릭 결과입니다.

Name	형식	Description
value	metricsResultInfo	메트릭 결과 데이터입니다.

metricsResultInfo

메트릭 결과 데이터입니다.

Name	형식	Description
end	string	메트릭의 시작 시간입니다.
interval	string	메트릭 데이터를 분할하는 데 사용되는 간격입니다.
segments	metricsSegmentInfo[]	분할된 메트릭 데이터(분할된 경우).
start	string	메트릭의 시작 시간입니다.

MetricsSegment

메트릭 값을 구분할 차원의 이름입니다. 이 차원은 검색하는 메트릭에 적용할 수 있어야 합니다. 한 번에 둘 이상의 차원으로 분할하려면 쉼표(,)로 구분합니다. 이 경우 메트릭 데이터는 차원이 매개 변수에 나열되는 순서대로 분할됩니다.

Name	형식	Description
applicationBuild	string
applicationVersion	string
authenticatedOrAnonymousTraffic	string
browser	string
browserVersion	string
city	string
cloudRoleName	string
cloudServiceName	string
continent	string
countryOrRegion	string
deploymentId	string
deploymentUnit	string
deviceType	string
environment	string
hostingLocation	string
instanceName	string

metricsSegmentInfo

메트릭 세그먼트

Name	형식	Description
end	string	메트릭 세그먼트의 시작 시간(간격을 지정한 경우에만).
segments	metricsSegmentInfo[]	분할된 메트릭 데이터(추가로 분할된 경우).
start	string	메트릭 세그먼트의 시작 시간(간격을 지정한 경우에만).

Share via

Metrics - Get

URI 매개 변수

응답

보안

oauth2

Scopes

예제

intervaledMetric

Sample Request

Sample Response

segmentedIntervaledMetric

Sample Request

Sample Response

simpleMetric

Sample Request

Sample Response

정의

errorDetail

errorInfo

errorResponse

MetricId

MetricsAggregation

metricsResult

metricsResultInfo

MetricsSegment

metricsSegmentInfo

추가 리소스