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 |
---|---|---|---|---|
app
|
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 |
Başarılı yanıt |
|
Other Status Codes |
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. |
error |
Hata ayrıntıları. |
error |
Hatanın kodu ve iletisi. |
error |
Hata ayrıntıları. |
query |
Analiz sorgusu. Analiz sorgusu söz dizimi hakkında daha fazla bilgi edinin |
query |
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 |
hata ayrıntıları. |
|
innererror |
Hatanın kodu ve iletisi. |
|
message |
string |
okunabilir bir hata iletisi. |
errorResponse
Hata ayrıntıları.
Name | Tür | Description |
---|---|---|
error |
Hatanın kodu ve iletisi. |
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. |