다음을 통해 공유


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 기간입니다. 간격을 생략하면 메트릭 값이 전체 시간 범위에서 집계됩니다. 간격이 제공되면 서버는 쿼리에 사용된 시간 간격에 따라 간격을 보다 적절한 크기로 조정할 수 있습니다. 모든 경우에 쿼리에 사용되는 실제 간격이 응답에 포함됩니다.

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 Application 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 메트릭 또는 애플리케이션별 사용자 지정 메트릭입니다.

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

MetricsAggregation

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

Description
avg
count
max
min
sum
unique

metricsResult

메트릭 결과입니다.

Name 형식 Description
value

metricsResultInfo

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

metricsResultInfo

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

Name 형식 Description
end

string (date_time)

메트릭의 시작 시간입니다.

interval

string (duration)

메트릭 데이터를 분할하는 데 사용되는 간격입니다.

segments

metricsSegmentInfo[]

분할된 메트릭 데이터(분할된 경우)입니다.

start

string (date_time)

메트릭의 시작 시간입니다.

MetricsSegment

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

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

metricsSegmentInfo

메트릭 세그먼트

Name 형식 Description
end

string (date_time)

메트릭 세그먼트의 시작 시간(간격이 지정된 경우에만)입니다.

segments

metricsSegmentInfo[]

분할된 메트릭 데이터(추가로 분할된 경우).

start

string (date_time)

메트릭 세그먼트의 시작 시간(간격이 지정된 경우에만)입니다.