Dela via

Query - Execute

Tjänst:
Application Insights
API-version:
v1

Köra en Analysfråga
Kör en Analysfråga för data. Här är ett exempel på hur du använder POST med en Analysfråga.

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

URI-parametrar

Name I Obligatorisk Typ Description
appId
 path True

string

ID för programmet. Det här är program-ID från bladet API-åtkomstinställningar i Azure-portalen.

Begärandetext

Name Obligatorisk Typ Description
query True

string

Frågan som ska köras.
applications

string[]

En lista över program-ID:er för frågor mellan program.
timespan

string

Valfritt. Tidsintervallet för att fråga efter data. Det här är ett ISO8601 tidsperiodsvärde. Det här tidsintervallet tillämpas utöver alla som anges i frågeuttrycket.

Svar

Name Typ Description
200 OK

queryResults

Lyckat svar
Other Status Codes

errorResponse

Ett felsvarsobjekt.

Säkerhet

oauth2

Ansluta till Azure Application Insights API

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

queryPost

Exempelbegäran

POST https://api.applicationinsights.io/v1/apps/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/query

{
  "timespan": "PT12H",
  "query": "requests | summarize count() by bin(timestamp, 1h)"
}

Exempelsvar

Statuskod:
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"
        ]
      ]
    }
  ]
}

Definitioner

Name Description
column

En tabellkolumn.
errorDetail

Felinformation.
errorInfo

Koden och meddelandet för ett fel.
errorResponse

Felinformation.
queryBody

Analytics-frågan. Läs mer om frågesyntaxen för Analytics
queryResults

Ett frågesvar.
table

En frågesvarstabell.

column

Objekt

En tabellkolumn.

Name Typ Description
name

string

Namnet på den här kolumnen.
type

string

Datatypen för den här kolumnen.

errorDetail

Objekt

Felinformation.

Name Typ Description
additionalProperties

object

code

string

Felets kod.
message

string

Ett mänskligt läsbart felmeddelande.
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ålet som är ansvarigt för felet.

errorInfo

Objekt

Koden och meddelandet för ett fel.

Name Typ Description
additionalProperties

object

code

string

En maskinläsbar felkod.
details

errorDetail[]

felinformation.
innererror

errorInfo

Koden och meddelandet för ett fel.
Inre felinformation om de finns.
message

string

Ett mänskligt läsbart felmeddelande.

errorResponse

Objekt

Felinformation.

Name Typ Description
error

errorInfo

Koden och meddelandet för ett fel.
Felinformationen.

queryBody

Objekt

Analytics-frågan. Läs mer om frågesyntaxen för Analytics

Name Typ Description
applications

string[]

En lista över program-ID:er 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 ISO8601 tidsperiodsvärde. Det här tidsintervallet tillämpas utöver alla som anges i frågeuttrycket.

queryResults

Objekt

Ett frågesvar.

Name Typ Description
tables

table[]

Listan över tabeller, kolumner och rader.

table

Objekt

En frågesvarstabell.

Name Typ Description
columns

column[]

Listan över kolumner i den här tabellen.
name

string

Tabellens namn.
rows

string[]

De resulterande raderna från den här frågan.