Query - Execute

참조

Service:: Application Insights

API Version:: v1

분석 쿼리 실행
데이터에 대한 분석 쿼리를 실행합니다. 다음은 Analytics 쿼리와 함께 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 애플리케이션 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	사용자 계정 가장

예제

queryPost

Sample Request

HTTP

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

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

Sample Response

Status code:: 200

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

Response Body

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

테이블 열입니다.

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

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

queryBody

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

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

queryResults

쿼리 응답입니다.

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

table

쿼리 응답 테이블입니다.

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