Query - Execute

リファレンス

サービス:: Application Insights

API バージョン:: v1

分析クエリを実行する
データに対して Analytics クエリを実行します。分析クエリで POST を使用する例を次に示します。

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

URI パラメーター

名前	/	必須	型	説明
appId	path	True	string	アプリケーションの ID。これは、Azure portalの [API アクセス設定] ブレードの [アプリケーション ID] です。

要求本文

名前	必須	型	説明
query	True	string	実行するクエリ。
applications		string[]	アプリケーション間クエリのアプリケーション ID の一覧。
timespan		string	省略可能。データのクエリを実行する期間。これは、ISO8601期間の値です。この期間は、クエリ式で指定されているに加えて適用されます。

応答

名前	型	説明
200 OK	queryResults	成功応答
Other Status Codes	errorResponse	エラー応答オブジェクト。

セキュリティ

oauth2

Azure アプリケーション Insights API に接続する

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

スコープ

名前	説明
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"
        ]
      ]
    }
  ]
}

定義

名前	説明
column	テーブル列。
errorDetail	エラーの詳細。
errorInfo	エラーのコードとメッセージ。
errorResponse	エラーの詳細。
queryBody	Analytics クエリ。 Analytics クエリ構文の詳細を確認する
queryResults	クエリ応答。
table	クエリ応答テーブル。

column

テーブル列。

名前	型	説明
name	string	この列の名前。
type	string	この列のデータ型。

errorDetail

エラーの詳細。

名前	型	説明
additionalProperties	object
code	string	エラーのコード。
message	string	人間が判読できるエラーメッセージ。
resources	string[]	エラーの原因となったリソースを示します。
target	string	要求のどのプロパティがエラーの原因であるかを示します。
value	string	'target' のどの値がエラーの原因であるかを示します。

errorInfo

エラーのコードとメッセージ。

名前	型	説明
additionalProperties	object
code	string	コンピューターで読み取り可能なエラーコード。
details	errorDetail[]	エラーの詳細。
innererror	errorInfo	エラーのコードとメッセージ。内部エラーの詳細 (存在する場合)。
message	string	人間が判読できるエラーメッセージ。

errorResponse

エラーの詳細。

名前	型	説明
error	errorInfo	エラーのコードとメッセージ。エラーの詳細です。

queryBody

Analytics クエリ。 Analytics クエリ構文の詳細を確認する

名前	型	説明
applications	string[]	アプリケーション間クエリのアプリケーション ID の一覧。
query	string	実行するクエリ。
timespan	string	省略可能。データのクエリを実行する期間。これは、ISO8601期間の値です。この期間は、クエリ式で指定されているに加えて適用されます。

queryResults

クエリ応答。

名前	型	説明
tables	table[]	テーブル、列、行の一覧。

table

クエリ応答テーブル。

名前	型	説明
columns	column[]	このテーブル内の列の一覧。
name	string	テーブルの名前。
rows	string[]	このクエリの結果の行。

次の方法で共有