Query - Execute
Spuštění analytického dotazu
Spustí analytický dotaz na data.
Tady je příklad použití příkazu POST s analytickým dotazem.
POST https://api.applicationinsights.io/v1/apps/{appId}/query
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
app
|
path | True |
string |
ID aplikace. Toto je ID aplikace z okna Nastavení přístupu rozhraní API v Azure Portal. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
query | True |
string |
Dotaz, který se má provést. |
applications |
string[] |
Seznam ID aplikací pro dotazy mezi aplikacemi. |
|
timespan |
string |
Nepovinný parametr. Časový rozsah, pro který se má dotazovat na data. Jedná se o ISO8601 hodnotu časového období. Tento časový rozsah se použije kromě všech, které jsou zadané ve výrazu dotazu. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Úspěšná odpověď |
|
Other Status Codes |
Objekt odpovědi na chybu. |
Zabezpečení
oauth2
Připojení k rozhraní APLIKACE AZURE Insights API
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
queryPost
Ukázkový požadavek
POST https://api.applicationinsights.io/v1/apps/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/query
{
"timespan": "PT12H",
"query": "requests | summarize count() by bin(timestamp, 1h)"
}
Ukázková odpověď
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"
]
]
}
]
}
Definice
Name | Description |
---|---|
column |
Sloupec tabulky. |
error |
Podrobnosti o chybě. |
error |
Kód a zpráva o chybě. |
error |
Podrobnosti o chybě. |
query |
Analytický dotaz. Další informace o syntaxi analytických dotazů |
query |
Odpověď na dotaz. |
table |
Tabulka odpovědí na dotaz |
column
Sloupec tabulky.
Name | Typ | Description |
---|---|---|
name |
string |
Název tohoto sloupce |
type |
string |
Datový typ tohoto sloupce. |
errorDetail
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
Kód chyby. |
message |
string |
Chybová zpráva čitelná pro člověka. |
resources |
string[] |
Označuje prostředky, které byly zodpovědné za chybu. |
target |
string |
Určuje, která vlastnost v požadavku je za chybu zodpovědná. |
value |
string |
Určuje, která hodnota v cílovém objektu je zodpovědná za chybu. |
errorInfo
Kód a zpráva o chybě.
Name | Typ | Description |
---|---|---|
additionalProperties |
object |
|
code |
string |
Strojově čitelný kód chyby. |
details |
podrobnosti o chybě. |
|
innererror |
Kód a zpráva o chybě. |
|
message |
string |
Chybová zpráva čitelná pro člověka. |
errorResponse
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
error |
Kód a zpráva o chybě. |
queryBody
Analytický dotaz. Další informace o syntaxi analytických dotazů
Name | Typ | Description |
---|---|---|
applications |
string[] |
Seznam ID aplikací pro dotazy mezi aplikacemi. |
query |
string |
Dotaz, který se má provést. |
timespan |
string |
Nepovinný parametr. Časový rozsah, pro který se má dotazovat na data. Jedná se o ISO8601 hodnotu časového období. Tento časový rozsah se použije kromě všech, které jsou zadané ve výrazu dotazu. |
queryResults
Odpověď na dotaz.
Name | Typ | Description |
---|---|---|
tables |
table[] |
Seznam tabulek, sloupců a řádků. |
table
Tabulka odpovědí na dotaz
Name | Typ | Description |
---|---|---|
columns |
column[] |
Seznam sloupců v této tabulce |
name |
string |
Název tabulky. |
rows |
string[] |
Výsledné řádky z tohoto dotazu |