다음을 통해 공유


Metrics - Get

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

GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}
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에 연결

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

범위

Name Description
user_impersonation 사용자 계정 가장

예제

intervaledMetric
segmentedIntervaledMetric
simpleMetric

intervaledMetric

샘플 요청

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

샘플 응답

{
  "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

샘플 요청

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

샘플 응답

{
  "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

샘플 요청

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

샘플 응답

{
  "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

메트릭 세그먼트의 시작 시간(간격을 지정한 경우에만).