Bagikan melalui


Query - Execute

Menjalankan kueri Analytics
Menjalankan kueri Analitik untuk data. Berikut adalah contoh untuk menggunakan POST dengan kueri Analytics.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
appId
path True

string

ID aplikasi. Ini adalah ID Aplikasi dari bilah pengaturan Akses API di portal Azure.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
query True

string

Kueri yang akan dijalankan.

applications

string[]

Daftar ID Aplikasi untuk kueri lintas aplikasi.

timespan

string

Pilihan. Rentang waktu untuk mengkueri data. Ini adalah nilai periode waktu ISO8601. Rentang waktu ini diterapkan selain yang ditentukan dalam ekspresi kueri.

Respons

Nama Jenis Deskripsi
200 OK

queryResults

Respons berhasil

Other Status Codes

errorResponse

Objek respons kesalahan.

Keamanan

oauth2

Menyambungkan ke API Azure Application Insights

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

queryPost

Permintaan sampel

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

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

Respon sampel

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

Definisi

Nama Deskripsi
column

Kolom tabel.

errorDetail

Detail kesalahan.

errorInfo

Kode dan pesan untuk kesalahan.

errorResponse

Detail kesalahan.

queryBody

Kueri Analitik. Pelajari selengkapnya tentang sintaks kueri Analytics

queryResults

Respons kueri.

table

Tabel respons kueri.

column

Kolom tabel.

Nama Jenis Deskripsi
name

string

Nama kolom ini.

type

string

Jenis data kolom ini.

errorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalProperties

object

code

string

Kode kesalahan.

message

string

Pesan kesalahan yang dapat dibaca manusia.

resources

string[]

Menunjukkan sumber daya yang bertanggung jawab atas kesalahan tersebut.

target

string

Menunjukkan properti mana dalam permintaan yang bertanggung jawab atas kesalahan tersebut.

value

string

Menunjukkan nilai mana dalam 'target' yang bertanggung jawab atas kesalahan tersebut.

errorInfo

Kode dan pesan untuk kesalahan.

Nama Jenis Deskripsi
additionalProperties

object

code

string

Kode kesalahan yang dapat dibaca mesin.

details

errorDetail[]

detail kesalahan.

innererror

errorInfo

Kode dan pesan untuk kesalahan.
Detail kesalahan dalam jika ada.

message

string

Pesan kesalahan yang dapat dibaca manusia.

errorResponse

Detail kesalahan.

Nama Jenis Deskripsi
error

errorInfo

Kode dan pesan untuk kesalahan.
Detail kesalahan.

queryBody

Kueri Analitik. Pelajari selengkapnya tentang sintaks kueri Analytics

Nama Jenis Deskripsi
applications

string[]

Daftar ID Aplikasi untuk kueri lintas aplikasi.

query

string

Kueri yang akan dijalankan.

timespan

string

Pilihan. Rentang waktu untuk mengkueri data. Ini adalah nilai periode waktu ISO8601. Rentang waktu ini diterapkan selain yang ditentukan dalam ekspresi kueri.

queryResults

Respons kueri.

Nama Jenis Deskripsi
tables

table[]

Daftar tabel, kolom, dan baris.

table

Tabel respons kueri.

Nama Jenis Deskripsi
columns

column[]

Daftar kolom dalam tabel ini.

name

string

Nama tabel.

rows

string[]

Baris yang dihasilkan dari kueri ini.