Bagikan melalui


Metrics - Get

Mengambil data metrik
Mendapatkan nilai metrik untuk satu metrik

GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}
GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}?timespan={timespan}&interval={interval}&aggregation={aggregation}&segment={segment}&top={top}&orderby={orderby}&filter={filter}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
appId
path True

string

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

metricId
path True

MetricId

ID metrik. Ini adalah metrik AI standar, atau metrik kustom khusus aplikasi.

aggregation
query

MetricsAggregation[]

Agregasi yang akan digunakan saat menghitung nilai metrik. Untuk mengambil lebih dari satu agregasi pada satu waktu, pisahkan dengan koma. Jika tidak ada agregasi yang ditentukan, maka agregasi default untuk metrik digunakan.

filter
query

string

Ekspresi yang digunakan untuk memfilter hasil. Nilai ini harus berupa ekspresi filter OData yang valid di mana kunci setiap klausa harus berupa dimensi yang berlaku untuk metrik yang Anda ambil.

interval
query

string (duration)

Interval waktu yang digunakan saat mengambil nilai metrik. Ini adalah durasi ISO8601. Jika interval dihilangkan, nilai metrik dikumpulkan di seluruh rentang waktu. Jika interval disediakan, server dapat menyesuaikan interval ke ukuran yang lebih tepat berdasarkan rentang waktu yang digunakan untuk kueri. Dalam semua kasus, interval aktual yang digunakan untuk kueri disertakan dalam respons.

orderby
query

string

Fungsi dan arah agregasi untuk mengurutkan segmen. Nilai ini hanya valid ketika segmen ditentukan.

segment
query

MetricsSegment[]

Nama dimensi untuk mengesegmentasi nilai metrik. Dimensi ini harus berlaku untuk metrik yang Anda ambil. Untuk segmentasi lebih dari satu dimensi pada satu waktu, pisahkan dengan koma (,). Dalam hal ini, data metrik akan disegmentasi dalam urutan dimensi tercantum dalam parameter .

timespan
query

string

Rentang waktu untuk mengambil nilai metrik. Ini adalah nilai periode waktu ISO8601. Jika rentang waktu dihilangkan, rentang waktu default PT12H ("12 jam terakhir") digunakan. Rentang waktu aktual yang dikueri dapat disesuaikan oleh berbasis server. Dalam semua kasus, rentang waktu aktual yang digunakan untuk kueri disertakan dalam respons.

top
query

integer (int32)

Jumlah segmen yang akan dikembalikan. Nilai ini hanya valid ketika segmen ditentukan.

Respons

Nama Jenis Deskripsi
200 OK

metricsResult

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

intervaledMetric
segmentedIntervaledMetric
simpleMetric

intervaledMetric

Permintaan sampel

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D

Respon sampel

{
  "value": {
    "start": "2018-02-04T10:01:35.086Z",
    "end": "2018-02-06T10:01:35.086Z",
    "interval": "P1D",
    "segments": [
      {
        "start": "2018-02-04T10:01:35.086Z",
        "end": "2018-02-05T00:00:00.000Z",
        "requests/count": {
          "sum": 4927
        }
      },
      {
        "start": "2018-02-05T00:00:00.000Z",
        "end": "2018-02-06T00:00:00.000Z",
        "requests/count": {
          "sum": 8460
        }
      },
      {
        "start": "2018-02-06T00:00:00.000Z",
        "end": "2018-02-06T10:01:35.086Z",
        "requests/count": {
          "sum": 3743
        }
      }
    ]
  }
}

segmentedIntervaledMetric

Permintaan sampel

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D&segment=operation/name,request/success

Respon sampel

{
  "value": {
    "start": "2018-10-22T10:40:09.065Z",
    "end": "2018-10-22T22:40:09.065Z",
    "segments": [
      {
        "operation/name": "GET Home/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 156483,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 3795,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /",
        "segments": [
          {
            "requests/count": null,
            "sum": 34168,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 12,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /FabrikamProd/Content/fonts/segoewp-light-webfont.eot",
        "segments": [
          {
            "requests/count": null,
            "sum": 9378,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /FabrikamProd/Content/fonts/segoewp-webfont.eot",
        "segments": [
          {
            "requests/count": null,
            "sum": 9370,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/Details",
        "segments": [
          {
            "requests/count": null,
            "sum": 1989,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 14,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1991,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Employees/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1990,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/GetLogEntries",
        "segments": [
          {
            "requests/count": null,
            "sum": 1985,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Employees/Details",
        "segments": [
          {
            "requests/count": null,
            "sum": 663,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 663,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Reports/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1086,
            "request/success": true
          }
        ]
      }
    ]
  }
}

simpleMetric

Permintaan sampel

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount

Respon sampel

{
  "value": {
    "start": "2016-01-01T02:00:00.000Z",
    "end": "2016-01-03T02:00:00.000Z",
    "requests/count": {
      "sum": 23
    }
  }
}

Definisi

Nama Deskripsi
errorDetail

Detail kesalahan.

errorInfo

Kode dan pesan untuk kesalahan.

errorResponse

Detail kesalahan.

MetricId

ID metrik. Ini adalah metrik AI standar, atau metrik kustom khusus aplikasi.

MetricsAggregation

Agregasi yang akan digunakan saat menghitung nilai metrik. Untuk mengambil lebih dari satu agregasi pada satu waktu, pisahkan dengan koma. Jika tidak ada agregasi yang ditentukan, maka agregasi default untuk metrik digunakan.

metricsResult

Hasil metrik.

metricsResultInfo

Data hasil metrik.

MetricsSegment

Nama dimensi untuk mengesegmentasi nilai metrik. Dimensi ini harus berlaku untuk metrik yang Anda ambil. Untuk segmentasi lebih dari satu dimensi pada satu waktu, pisahkan dengan koma (,). Dalam hal ini, data metrik akan disegmentasi dalam urutan dimensi tercantum dalam parameter .

metricsSegmentInfo

Segmen metrik

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.

MetricId

ID metrik. Ini adalah metrik AI standar, atau metrik kustom khusus aplikasi.

Nilai Deskripsi
availabilityResults/availabilityPercentage
availabilityResults/duration
billing/telemetryCount
client/networkDuration
client/processingDuration
client/receiveDuration
client/sendDuration
client/totalDuration
customEvents/count
dependencies/count
dependencies/duration
dependencies/failed
exceptions/browser
exceptions/count
exceptions/server
pageViews/count
pageViews/duration
performanceCounters/exceptionsPerSecond
performanceCounters/memoryAvailableBytes
performanceCounters/processCpuPercentage
performanceCounters/processIOBytesPerSecond
performanceCounters/processPrivateBytes
performanceCounters/processorCpuPercentage
performanceCounters/requestExecutionTime
performanceCounters/requestsInQueue
performanceCounters/requestsPerSecond
requests/count
requests/duration
requests/failed
sessions/count
users/authenticated
users/count

MetricsAggregation

Agregasi yang akan digunakan saat menghitung nilai metrik. Untuk mengambil lebih dari satu agregasi pada satu waktu, pisahkan dengan koma. Jika tidak ada agregasi yang ditentukan, maka agregasi default untuk metrik digunakan.

Nilai Deskripsi
avg
count
max
min
sum
unique

metricsResult

Hasil metrik.

Nama Jenis Deskripsi
value

metricsResultInfo

Data hasil metrik.

metricsResultInfo

Data hasil metrik.

Nama Jenis Deskripsi
end

string (date_time)

Waktu mulai metrik.

interval

string (duration)

Interval yang digunakan untuk mensegmentasi data metrik.

segments

metricsSegmentInfo[]

Data metrik tersegmentasi (jika tersegmentasi).

start

string (date_time)

Waktu mulai metrik.

MetricsSegment

Nama dimensi untuk mengesegmentasi nilai metrik. Dimensi ini harus berlaku untuk metrik yang Anda ambil. Untuk segmentasi lebih dari satu dimensi pada satu waktu, pisahkan dengan koma (,). Dalam hal ini, data metrik akan disegmentasi dalam urutan dimensi tercantum dalam parameter .

Nilai Deskripsi
applicationBuild
applicationVersion
authenticatedOrAnonymousTraffic
browser
browserVersion
city
cloudRoleName
cloudServiceName
continent
countryOrRegion
deploymentId
deploymentUnit
deviceType
environment
hostingLocation
instanceName

metricsSegmentInfo

Segmen metrik

Nama Jenis Deskripsi
end

string (date_time)

Waktu mulai segmen metrik (hanya ketika interval ditentukan).

segments

metricsSegmentInfo[]

Data metrik tersegmentasi (jika disegmentasi lebih lanjut).

start

string (date_time)

Waktu mulai segmen metrik (hanya ketika interval ditentukan).