Metrics - Get

Başvuru

Service:: Application Insights

API Version:: 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}

With optional parameters:

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 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ü özel ölçümdür.
aggregation	query		MetricsAggregation[]	Ölçüm değerlerini hesaplarken 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 zaman aralığı değeridir. Zaman aralığı atlanırsa, varsayılan zaman aralığı `PT12H` ("son 12 saat") kullanılır. Sorgulanan gerçek zaman aralığı sunucu tabanlı tarafından ayarlanabilir. Her durumda, sorgu için kullanılan gerçek zaman aralığı yanıta eklenir.
top	query		integer int32	Döndürülecek segmentlerin 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 Uygulaması Insights API'sine bağlanma

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Scopes

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

Örnekler

intervaledMetric

segmentedIntervaledMetric

simpleMetric

intervaledMetric

Sample Request

HTTP

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

Sample Response

Status code:: 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

Sample Request

HTTP

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

Sample Response

Status code:: 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

Sample Request

HTTP

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

Sample Response

Status code:: 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ü özel ölçümdür.
MetricsAggregation	Ölçüm değerlerini hesaplarken 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 kesimi

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ı.

MetricId

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

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

MetricsAggregation

Ölçüm değerlerini hesaplarken 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.

Name	Tür	Description
avg	string
count	string
max	string
min	string
sum	string
unique	string

metricsResult

Ölçüm sonucu.

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

metricsResultInfo

Ölçüm sonucu verileri.

Name	Tür	Description
end	string	Ölçümün başlangıç saati.
interval	string	Ö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	Ölçümün başlangıç saati.

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.

Name	Tür	Description
applicationBuild	string
applicationVersion	string
authenticatedOrAnonymousTraffic	string
browser	string
browserVersion	string
city	string
cloudRoleName	string
cloudServiceName	string
continent	string
countryOrRegion	string
deploymentId	string
deploymentUnit	string
deviceType	string
environment	string
hostingLocation	string
instanceName	string

metricsSegmentInfo

Ölçüm kesimi

Name	Tür	Description
end	string	Ö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	Ölçüm kesiminin başlangıç saati (yalnızca bir aralık belirtildiğinde).

Metrics - Get

URI Parametreleri

Yanıtlar

Güvenlik

oauth2

Scopes

Örnekler

intervaledMetric

Sample Request

Sample Response

segmentedIntervaledMetric

Sample Request

Sample Response

simpleMetric

Sample Request

Sample Response

Tanımlar

errorDetail

errorInfo

errorResponse

MetricId

MetricsAggregation

metricsResult

metricsResultInfo

MetricsSegment

metricsSegmentInfo

Ek kaynaklar