Metrics - Get

서비스:: Application Insights

API 버전:: v1

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

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

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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

Object

오류 세부 정보입니다.

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

errorInfo

Object

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

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

errorResponse

Object

오류 세부 정보입니다.

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

MetricId

열거형

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

값	Description
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

MetricsAggregation

열거형

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

값	Description
min
max
avg
sum
count
unique

metricsResult

Object

메트릭 결과입니다.

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

metricsResultInfo

Object

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

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

Object

메트릭 세그먼트

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

다음을 통해 공유

Metrics - Get

URI 매개 변수

응답

보안

oauth2

범위

예제

intervaledMetric

샘플 요청

샘플 응답

segmentedIntervaledMetric

샘플 요청

샘플 응답

simpleMetric

샘플 요청

샘플 응답

정의

errorDetail

errorInfo

errorResponse

MetricId

MetricsAggregation

metricsResult

metricsResultInfo

MetricsSegment

metricsSegmentInfo