Query - Execute
Köra en Analytics-fråga
Kör en Analytics-fråga för data. Här är ett exempel på hur du använder POST med en Analytics-fråga.
POST https://api.applicationinsights.io/v1/apps/{appId}/query
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
app
|
path | True |
string |
ID för programmet. Det här är Program-ID från bladet API-åtkomstinställningar i Azure Portal. |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
query | True |
string |
Frågan som ska köras. |
applications |
string[] |
En lista över program-ID:t för frågor mellan program. |
|
timespan |
string |
Valfritt. Tidsintervallet för att fråga efter data. Det här är ett värde för ISO8601 tidsperiod. Det här tidsintervallet tillämpas utöver alla som anges i frågeuttrycket. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Lyckat svar |
|
Other Status Codes |
Ett felsvarsobjekt. |
Säkerhet
oauth2
Ansluta till Azure Application 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 | personifiera ditt användarkonto |
Exempel
queryPost
Sample Request
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
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"
]
]
}
]
}
Definitioner
Name | Description |
---|---|
column |
En tabellkolumn. |
error |
Felinformation. |
error |
Koden och meddelandet för ett fel. |
error |
Felinformation. |
query |
Analytics-frågan. Läs mer om analytics-frågesyntaxen |
query |
Ett frågesvar. |
table |
En frågesvarstabell. |
column
En tabellkolumn.
Name | Typ | Description |
---|---|---|
name |
string |
Namnet på den här kolumnen. |
type |
string |
Datatypen för den här kolumnen. |
errorDetail
Felinformation.
Name | Typ | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
Felkoden. |
message |
string |
Ett felmeddelande som kan läsas av människor. |
resources |
string[] |
Anger resurser som var ansvariga för felet. |
target |
string |
Anger vilken egenskap i begäran som ansvarar för felet. |
value |
string |
Anger vilket värde i "mål" som ansvarar för felet. |
errorInfo
Koden och meddelandet för ett fel.
Name | Typ | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
En felkod som kan läsas av datorn. |
details |
felinformation. |
|
innererror |
Koden och meddelandet för ett fel. |
|
message |
string |
Ett felmeddelande som kan läsas av människor. |
errorResponse
Felinformation.
Name | Typ | Description |
---|---|---|
error |
Koden och meddelandet för ett fel. |
queryBody
Analytics-frågan. Läs mer om analytics-frågesyntaxen
Name | Typ | Description |
---|---|---|
applications |
string[] |
En lista över program-ID:t för frågor mellan program. |
query |
string |
Frågan som ska köras. |
timespan |
string |
Valfritt. Tidsintervallet för att fråga efter data. Det här är ett värde för ISO8601 tidsperiod. Det här tidsintervallet tillämpas utöver alla som anges i frågeuttrycket. |
queryResults
Ett frågesvar.
Name | Typ | Description |
---|---|---|
tables |
table[] |
Listan över tabeller, kolumner och rader. |
table
En frågesvarstabell.
Name | Typ | Description |
---|---|---|
columns |
column[] |
Listan över kolumner i den här tabellen. |
name |
string |
Namnet på tabellen. |
rows |
string[] |
De resulterande raderna från den här frågan. |