Query - Execute

서비스:

Application Insights

API 버전:

v1

분석 쿼리 실행
데이터에 대한 분석 쿼리를 실행합니다. 여기 분석 쿼리와 함께 POST를 사용하는 예제입니다.

POST https://api.applicationinsights.io/v1/apps/{appId}/query

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
appId	path	True	string	애플리케이션의 ID입니다. Azure Portal의 API 액세스 설정 블레이드에서 애플리케이션 ID입니다.

요청 본문

Name	필수	형식	Description
query	True	string	실행할 쿼리입니다.
applications		string[]	애플리케이션 간 쿼리에 대한 애플리케이션 ID 목록입니다.
timespan		string	선택 사항. 데이터를 쿼리할 시간 범위입니다. 이는 ISO8601 기간 값입니다. 이 시간 범위는 쿼리 식에 지정된 시간 외에 적용됩니다.

응답

Name	형식	Description
200 OK	queryResults	성공적인 응답
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	사용자 계정 가장

예제

queryPost

샘플 요청

HTTP

POST https://api.applicationinsights.io/v1/apps/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/query

{
  "timespan": "PT12H",
  "query": "requests | summarize count() by bin(timestamp, 1h)"
}

샘플 응답

상태 코드:

200

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "timestamp",
          "type": "datetime"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "2018-02-02T05:00:00Z",
          "255"
        ],
        [
          "2018-02-01T17:00:00Z",
          "148"
        ],
        [
          "2018-02-01T18:00:00Z",
          "453"
        ],
        [
          "2018-02-01T19:00:00Z",
          "404"
        ],
        [
          "2018-02-01T20:00:00Z",
          "403"
        ],
        [
          "2018-02-01T21:00:00Z",
          "405"
        ],
        [
          "2018-02-01T22:00:00Z",
          "438"
        ],
        [
          "2018-02-01T23:00:00Z",
          "403"
        ],
        [
          "2018-02-02T00:00:00Z",
          "423"
        ],
        [
          "2018-02-02T01:00:00Z",
          "403"
        ],
        [
          "2018-02-02T02:00:00Z",
          "425"
        ],
        [
          "2018-02-02T03:00:00Z",
          "437"
        ],
        [
          "2018-02-02T04:00:00Z",
          "420"
        ]
      ]
    }
  ]
}

정의

Name	Description
column	테이블 열입니다.
errorDetail	오류 세부 정보입니다.
errorInfo	오류에 대한 코드 및 메시지입니다.
errorResponse	오류 세부 정보입니다.
queryBody	분석 쿼리입니다. Analytics 쿼리 구문 대해 자세히 알아보세요.
queryResults	쿼리 응답입니다.
table	쿼리 응답 테이블입니다.

column

Object

테이블 열입니다.

Name	형식	Description
name	string	이 열의 이름입니다.
type	string	이 열의 데이터 형식입니다.

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	오류에 대한 코드 및 메시지입니다. 오류 세부 정보입니다.

queryBody

Object

분석 쿼리입니다. Analytics 쿼리 구문 대해 자세히 알아보세요.

Name	형식	Description
applications	string[]	애플리케이션 간 쿼리에 대한 애플리케이션 ID 목록입니다.
query	string	실행할 쿼리입니다.
timespan	string	선택 사항. 데이터를 쿼리할 시간 범위입니다. 이는 ISO8601 기간 값입니다. 이 시간 범위는 쿼리 식에 지정된 시간 외에 적용됩니다.

queryResults

Object

쿼리 응답입니다.

Name	형식	Description
tables	table[]	테이블, 열 및 행 목록입니다.

table

Object

쿼리 응답 테이블입니다.

Name	형식	Description
columns	column[]	이 테이블의 열 목록입니다.
name	string	테이블의 이름입니다.
rows	string[]	이 쿼리의 결과 행입니다.