Query - Execute

參考

服務:: Application Insights

API 版本:: v1

執行分析查詢
執行數據的分析查詢。以下是搭配分析查詢使用POST的範例。

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

URI 參數

名稱	位於	必要	類型	Description
appId	path	True	string	應用程式的識別碼。這是 Azure 入口網站中 [API 存取設定] 刀鋒視窗中的應用程式識別碼。

要求本文

名稱	必要	類型	Description
query	True	string	要執行的查詢。
applications		string[]	跨應用程式查詢的應用程式識別碼清單。
timespan		string	選擇性。要查詢數據的時間範圍。這是ISO8601時間週期值。除了查詢表達式中指定的任何專案之外，還會套用這個時間範圍。

回應

名稱	類型	Description
200 OK	queryResults	成功的回應
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

範圍

名稱	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"
        ]
      ]
    }
  ]
}

定義

名稱	Description
column	數據表數據行。
errorDetail	錯誤詳細數據。
errorInfo	錯誤的程式代碼和訊息。
errorResponse	錯誤詳細數據。
queryBody	分析查詢。深入瞭解 Analytics 查詢語法
queryResults	查詢回應。
table	查詢回應表。

column

數據表數據行。

名稱	類型	Description
name	string	此資料行的名稱。
type	string	這個數據行的數據類型。

errorDetail

錯誤詳細數據。

名稱	類型	Description
additionalProperties	object
code	string	錯誤的程序代碼。
message	string	人類可讀取的錯誤訊息。
resources	string[]	指出負責錯誤的資源。
target	string	指出要求中的哪個屬性負責錯誤。
value	string	指出『target』中的哪個值負責錯誤。

errorInfo

錯誤的程式代碼和訊息。

名稱	類型	Description
additionalProperties	object
code	string	計算機可讀取的錯誤碼。
details	errorDetail[]	錯誤詳細數據。
innererror	errorInfo	錯誤的程式代碼和訊息。如果內部錯誤詳細資料存在，則為。
message	string	人類可讀取的錯誤訊息。

errorResponse

錯誤詳細數據。

名稱	類型	Description
error	errorInfo	錯誤的程式代碼和訊息。錯誤詳細資料。

queryBody

分析查詢。深入瞭解 Analytics 查詢語法

名稱	類型	Description
applications	string[]	跨應用程式查詢的應用程式識別碼清單。
query	string	要執行的查詢。
timespan	string	選擇性。要查詢數據的時間範圍。這是ISO8601時間週期值。除了查詢表達式中指定的任何專案之外，還會套用這個時間範圍。

queryResults

查詢回應。

名稱	類型	Description
tables	table[]	數據表、資料列和數據列的清單。

table

查詢回應表。

名稱	類型	Description
columns	column[]	此資料表中的數據列清單。
name	string	資料表的名稱。
rows	string[]	此查詢所產生的數據列。

共用方式為