Sdílet prostřednictvím


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
appId
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

queryResults

Úspěšná odpověď

Other Status Codes

errorResponse

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.

errorDetail

Podrobnosti o chybě.

errorInfo

Kód a zpráva o chybě.

errorResponse

Podrobnosti o chybě.

queryBody

Analytický dotaz. Další informace o syntaxi analytických dotazů

queryResults

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

errorDetail[]

podrobnosti o chybě.

innererror

errorInfo

Kód a zpráva o chybě.
Podrobnosti o vnitřní chybě, pokud existují.

message

string

Chybová zpráva čitelná pro člověka.

errorResponse

Podrobnosti o chybě.

Name Typ Description
error

errorInfo

Kód a zpráva o chybě.
Podrobnosti 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