Aracılığıyla paylaş


Query - Execute

Analiz sorgusu yürütme
Veriler için bir Analiz sorgusu yürütür. Aşağıda Post'un Analiz sorgusuyla kullanılmasına yönelik bir örnek verilmiştir.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
appId
path True

string

Uygulamanın kimliği. Bu, Azure portal API Erişim ayarları dikey penceresindeki Uygulama Kimliği'dir.

İstek Gövdesi

Name Gerekli Tür Description
query True

string

Yürütülecek sorgu.

applications

string[]

Uygulamalar arası sorgular için Uygulama Kimliklerinin listesi.

timespan

string

İsteğe bağlı. Verilerin sorgulandığı zaman aralığı. Bu ISO8601 zaman aralığı değeridir. Bu zaman aralığı, sorgu ifadesinde belirtilenlere ek olarak uygulanır.

Yanıtlar

Name Tür Description
200 OK

queryResults

Başarılı yanıt

Other Status Codes

errorResponse

Hata yanıtı nesnesi.

Güvenlik

oauth2

Azure Uygulaması Insights API'sine bağlanma

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

queryPost

Örnek isteği

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

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

Örnek yanıt

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

Tanımlar

Name Description
column

Tablo sütunu.

errorDetail

Hata ayrıntıları.

errorInfo

Hatanın kodu ve iletisi.

errorResponse

Hata ayrıntıları.

queryBody

Analiz sorgusu. Analiz sorgusu söz dizimi hakkında daha fazla bilgi edinin

queryResults

Sorgu yanıtı.

table

Sorgu yanıt tablosu.

column

Tablo sütunu.

Name Tür Description
name

string

Bu sütunun adı.

type

string

Bu sütunun veri türü.

errorDetail

Hata ayrıntıları.

Name Tür Description
additionalProperties

object

code

string

Hatanın kodu.

message

string

okunabilir bir hata iletisi.

resources

string[]

Hatadan sorumlu kaynakları gösterir.

target

string

İstekteki hangi özelliğin hatadan sorumlu olduğunu gösterir.

value

string

Hatadan 'target' içindeki hangi değerin sorumlu olduğunu gösterir.

errorInfo

Hatanın kodu ve iletisi.

Name Tür Description
additionalProperties

object

code

string

Makine tarafından okunabilir bir hata kodu.

details

errorDetail[]

hata ayrıntıları.

innererror

errorInfo

Hatanın kodu ve iletisi.
İç hata ayrıntıları varsa.

message

string

okunabilir bir hata iletisi.

errorResponse

Hata ayrıntıları.

Name Tür Description
error

errorInfo

Hatanın kodu ve iletisi.
Hata ayrıntıları.

queryBody

Analiz sorgusu. Analiz sorgusu söz dizimi hakkında daha fazla bilgi edinin

Name Tür Description
applications

string[]

Uygulamalar arası sorgular için Uygulama Kimliklerinin listesi.

query

string

Yürütülecek sorgu.

timespan

string

İsteğe bağlı. Verilerin sorgulandığı zaman aralığı. Bu ISO8601 zaman aralığı değeridir. Bu zaman aralığı, sorgu ifadesinde belirtilenlere ek olarak uygulanır.

queryResults

Sorgu yanıtı.

Name Tür Description
tables

table[]

Tablo, sütun ve satır listesi.

table

Sorgu yanıt tablosu.

Name Tür Description
columns

column[]

Bu tablodaki sütunların listesi.

name

string

Tablonun adı.

rows

string[]

Bu sorgudan elde edilen satırlar.