Metrics - Get

Başvuru

Hizmet:: Application Insights

API Sürümü:: v1

Ölçüm verilerini alma
Tek bir ölçüm için ölçüm değerlerini alır

GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
appId	path	True	string	Uygulamanın kimliği. Bu, Azure portalındaki API Erişim ayarları dikey penceresindeki Uygulama Kimliği'dir.
metricId	path	True	MetricId	Ölçümün kimliği. Bu standart bir yapay zeka ölçümü veya uygulamaya özgü bir özel ölçümdür.
aggregation	query		MetricsAggregation[]	Ölçüm değerleri hesaplanırken kullanılacak toplama. Bir kerede birden fazla toplama almak için bunları virgülle ayırın. Toplama belirtilmezse, ölçüm için varsayılan toplama kullanılır.
filter	query		string	Sonuçları filtrelemek için kullanılan ifade. Bu değer, her yan tümcenin anahtarlarının almakta olduğunuz ölçüm için geçerli boyutlar olması gereken geçerli bir OData filtre ifadesi olmalıdır.
interval	query		string (duration)	Ölçüm değerleri alınırken kullanılacak zaman aralığı. Bu ISO8601 bir süredir. Aralık atlanırsa ölçüm değeri tüm zaman aralığı boyunca toplanır. Aralık sağlanırsa, sunucu sorgu için kullanılan zaman aralığına göre aralığı daha uygun bir boyuta ayarlayabilir. Her durumda, sorgu için kullanılan gerçek aralık yanıta eklenir.
orderby	query		string	Segmentleri sıralamak için toplama işlevi ve yönü. Bu değer yalnızca segment belirtildiğinde geçerlidir.
segment	query		MetricsSegment[]	Ölçüm değerlerini segmentlere ayırmak için boyutun adı. Bu boyut, almakta olduğunuz ölçüm için geçerli olmalıdır. Bir kerede birden fazla boyuta göre segmentlere ayırmak için bunları virgülle (,) ayırın. Bu durumda ölçüm verileri, boyutların parametrede listelenme sırasına göre segmentlere ayrılmıştır.
timespan	query		string	Ölçüm değerlerinin alındığı zaman aralığı. Bu, ISO8601 bir zaman aralığı değeridir. Zaman aralığı atlanırsa, varsayılan `PT12H` zaman aralığı ("son 12 saat") kullanılır. Sorgulanan gerçek zaman aralığı sunucu tabanlı olarak ayarlanabilir. Her durumda, sorgu için kullanılan gerçek zaman aralığı yanıta eklenir.
top	query		integer (int32)	Döndürülecek segment sayısı. Bu değer yalnızca segment belirtildiğinde geçerlidir.

Yanıtlar

Name	Tür	Description
200 OK	metricsResult	Başarılı yanıt
Other Status Codes	errorResponse	Hata yanıtı nesnesi.

Güvenlik

oauth2

Azure Application 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

intervaledMetric

segmentedIntervaledMetric

simpleMetric

intervaledMetric

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

{
  "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

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

{
  "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

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

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

Tanımlar

Name	Description
errorDetail	Hata ayrıntıları.
errorInfo	Hatanın kodu ve iletisi.
errorResponse	Hata ayrıntıları.
MetricId	Ölçümün kimliği. Bu standart bir yapay zeka ölçümü veya uygulamaya özgü bir özel ölçümdür.
MetricsAggregation	Ölçüm değerleri hesaplanırken kullanılacak toplama. Bir kerede birden fazla toplama almak için bunları virgülle ayırın. Toplama belirtilmezse, ölçüm için varsayılan toplama kullanılır.
metricsResult	Ölçüm sonucu.
metricsResultInfo	Ölçüm sonucu verileri.
MetricsSegment	Ölçüm değerlerini segmentlere ayırmak için boyutun adı. Bu boyut, almakta olduğunuz ölçüm için geçerli olmalıdır. Bir kerede birden fazla boyuta göre segmentlere ayırmak için bunları virgülle (,) ayırın. Bu durumda ölçüm verileri, boyutların parametrede listelenme sırasına göre segmentlere ayrılmıştır.
metricsSegmentInfo	Ölçüm segmenti

errorDetail

Object

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	'target' içindeki hangi değerin hatadan sorumlu olduğunu gösterir.

errorInfo

Object

Hatanın kodu ve iletisi.

Name	Tür	Description
additionalProperties	object
code	string	Makine okunabilir bir hata kodu.
details	errorDetail[]	hata ayrıntıları.
innererror	errorInfo	Hatanın kodu ve iletisi. Varsa iç hata ayrıntıları.
message	string	okunabilir bir hata iletisi.

errorResponse

Object

Hata ayrıntıları.

Name	Tür	Description
error	errorInfo	Hatanın kodu ve iletisi. Hata ayrıntıları.

MetricId

Listeleme

Ölçümün kimliği. Bu standart bir yapay zeka ölçümü veya uygulamaya özgü bir özel ölçümdür.

Değer	Description
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

Listeleme

Ölçüm değerleri hesaplanırken kullanılacak toplama. Bir kerede birden fazla toplama almak için bunları virgülle ayırın. Toplama belirtilmezse, ölçüm için varsayılan toplama kullanılır.

Değer	Description
avg
count
max
min
sum
unique

metricsResult

Object

Ölçüm sonucu.

Name	Tür	Description
value	metricsResultInfo	Ölçüm sonucu verileri.

metricsResultInfo

Object

Ölçüm sonucu verileri.

Name	Tür	Description
end	string (date_time)	Ölçümün başlangıç saati.
interval	string (duration)	Ölçüm verilerini segmentlere ayırmak için kullanılan aralık.
segments	metricsSegmentInfo[]	Segmentlere ayrılmış ölçüm verileri (segmentlere ayrılmışsa).
start	string (date_time)	Ölçümün başlangıç saati.

MetricsSegment

Listeleme

Ölçüm değerlerini segmentlere ayırmak için boyutun adı. Bu boyut, almakta olduğunuz ölçüm için geçerli olmalıdır. Bir kerede birden fazla boyuta göre segmentlere ayırmak için bunları virgülle (,) ayırın. Bu durumda ölçüm verileri, boyutların parametrede listelenme sırasına göre segmentlere ayrılmıştır.

Değer	Description
applicationBuild
applicationVersion
authenticatedOrAnonymousTraffic
browser
browserVersion
city
cloudRoleName
cloudServiceName
continent
countryOrRegion
deploymentId
deploymentUnit
deviceType
environment
hostingLocation
instanceName

metricsSegmentInfo

Object

Ölçüm segmenti

Name	Tür	Description
end	string (date_time)	Ölçüm kesiminin başlangıç saati (yalnızca bir aralık belirtildiğinde).
segments	metricsSegmentInfo[]	Segmentlere ayrılmış ölçüm verileri (daha fazla segmentlere ayrılmışsa).
start	string (date_time)	Ölçüm kesiminin başlangıç saati (yalnızca bir aralık belirtildiğinde).

Aracılığıyla paylaş

Metrics - Get

URI Parametreleri

Yanıtlar

Güvenlik

oauth2

Kapsamlar

Örnekler

intervaledMetric

Örnek isteği

Örnek yanıt

segmentedIntervaledMetric

Örnek isteği

Örnek yanıt

simpleMetric

Örnek isteği

Örnek yanıt

Tanımlar

errorDetail

errorInfo

errorResponse

MetricId

MetricsAggregation

metricsResult

metricsResultInfo

MetricsSegment

metricsSegmentInfo

Ek kaynaklar