Metrics - Get

Referentie

Service:: Application Insights

API-versie:: v1

Metrische gegevens ophalen
Hiermee haalt u metrische waarden op voor één metrische waarde

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

Met optionele 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-parameters

Name	In	Vereist	Type	Description
appId	path	True	string	Id van de toepassing. Dit is de toepassings-id van de blade API-toegangsinstellingen in Azure Portal.
metricId	path	True	MetricId	Id van de metrische waarde. Dit is een standaard ai-metriek of een toepassingsspecifieke aangepaste metrische gegevens.
aggregation	query		MetricsAggregation[]	De aggregatie die moet worden gebruikt bij het berekenen van de metrische waarden. Als u meer dan één aggregatie tegelijk wilt ophalen, scheidt u deze met een komma. Als er geen aggregatie is opgegeven, wordt de standaardaggregatie voor de metrische waarde gebruikt.
filter	query		string	Een expressie die wordt gebruikt om de resultaten te filteren. Deze waarde moet een geldige OData-filterexpressie zijn waarbij de sleutels van elke component van toepassing moeten zijn op de metrische gegevens die u opzoekt.
interval	query		string (duration)	Het tijdsinterval dat moet worden gebruikt bij het ophalen van metrische waarden. Dit is een ISO8601 duur. Als het interval wordt weggelaten, wordt de metrische waarde gedurende de hele periode geaggregeerd. Als er een interval wordt opgegeven, kan de server het interval aanpassen aan een meer geschikte grootte op basis van de tijdsperiode die voor de query wordt gebruikt. In alle gevallen wordt het werkelijke interval dat voor de query wordt gebruikt, opgenomen in het antwoord.
orderby	query		string	De aggregatiefunctie en de richting voor het sorteren van de segmenten op. Deze waarde is alleen geldig wanneer segment is opgegeven.
segment	query		MetricsSegment[]	De naam van de dimensie waarop de metrische waarden moeten worden gesegmenteerd. Deze dimensie moet van toepassing zijn op de metrische gegevens die u opzoekt. Als u meerdere dimensies tegelijk wilt segmenteren, scheidt u deze met een komma (,). In dit geval worden de metrische gegevens gesegmenteerd in de volgorde waarin de dimensies worden vermeld in de parameter.
timespan	query		string	De tijdspanne voor het ophalen van metrische waarden. Dit is een ISO8601 tijdsperiodewaarde. Als de tijdsduur wordt weggelaten, wordt een standaardtijdsbereik van `PT12H` ('afgelopen 12 uur') gebruikt. De werkelijke tijdsperiode waarop een query wordt uitgevoerd, kan worden aangepast door de server. In alle gevallen wordt de werkelijke tijdsduur die voor de query wordt gebruikt, opgenomen in het antwoord.
top	query		integer (int32)	Het aantal segmenten dat moet worden geretourneerd. Deze waarde is alleen geldig wanneer segment is opgegeven.

Antwoorden

Name	Type	Description
200 OK	metricsResult	Geslaagde reactie
Other Status Codes	errorResponse	Een foutantwoordobject.

Beveiliging

oauth2

Verbinding maken met de Azure Application Insights-API

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

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

intervaledMetric

segmentedIntervaledMetric

simpleMetric

intervaledMetric

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 200

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

Definities

Name	Description
errorDetail	Foutdetails.
errorInfo	De code en het bericht voor een fout.
errorResponse	Foutdetails.
MetricId	Id van de metrische waarde. Dit is een standaard ai-metriek of een toepassingsspecifieke aangepaste metrische gegevens.
MetricsAggregation	De aggregatie die moet worden gebruikt bij het berekenen van de metrische waarden. Als u meer dan één aggregatie tegelijk wilt ophalen, scheidt u deze met een komma. Als er geen aggregatie is opgegeven, wordt de standaardaggregatie voor de metrische waarde gebruikt.
metricsResult	Een metrische waarde.
metricsResultInfo	Een metrische resultaatgegevens.
MetricsSegment	De naam van de dimensie waarop de metrische waarden moeten worden gesegmenteerd. Deze dimensie moet van toepassing zijn op de metrische gegevens die u opzoekt. Als u meerdere dimensies tegelijk wilt segmenteren, scheidt u deze met een komma (,). In dit geval worden de metrische gegevens gesegmenteerd in de volgorde waarin de dimensies worden vermeld in de parameter.
metricsSegmentInfo	Een metrisch segment

errorDetail

Object

Foutdetails.

Name	Type	Description
additionalProperties	object
code	string	De code van de fout.
message	string	Een door mensen leesbaar foutbericht.
resources	string[]	Geeft resources aan die verantwoordelijk zijn voor de fout.
target	string	Geeft aan welke eigenschap in de aanvraag verantwoordelijk is voor de fout.
value	string	Geeft aan welke waarde in 'doel' verantwoordelijk is voor de fout.

errorInfo

Object

De code en het bericht voor een fout.

Name	Type	Description
additionalProperties	object
code	string	Een door de machine leesbare foutcode.
details	errorDetail[]	foutdetails.
innererror	errorInfo	De code en het bericht voor een fout. Interne foutdetails als deze bestaan.
message	string	Een door mensen leesbaar foutbericht.

errorResponse

Object

Foutdetails.

Name	Type	Description
error	errorInfo	De code en het bericht voor een fout. De foutdetails.

MetricId

Inventarisatie

Id van de metrische waarde. Dit is een standaard ai-metriek of een toepassingsspecifieke aangepaste metrische gegevens.

Waarde	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

Inventarisatie

De aggregatie die moet worden gebruikt bij het berekenen van de metrische waarden. Als u meer dan één aggregatie tegelijk wilt ophalen, scheidt u deze met een komma. Als er geen aggregatie is opgegeven, wordt de standaardaggregatie voor de metrische waarde gebruikt.

Waarde	Description
avg
count
max
min
sum
unique

metricsResult

Object

Een metrische waarde.

Name	Type	Description
value	metricsResultInfo	Een metrische resultaatgegevens.

metricsResultInfo

Object

Een metrische resultaatgegevens.

Name	Type	Description
end	string (date_time)	Begintijd van de metrische waarde.
interval	string (duration)	Het interval dat wordt gebruikt om de metrische gegevens te segmenteren.
segments	metricsSegmentInfo[]	Gesegmenteerde metrische gegevens (indien gesegmenteerd).
start	string (date_time)	Begintijd van de metrische waarde.

MetricsSegment

Inventarisatie

De naam van de dimensie waarop de metrische waarden moeten worden gesegmenteerd. Deze dimensie moet van toepassing zijn op de metrische gegevens die u opzoekt. Als u meerdere dimensies tegelijk wilt segmenteren, scheidt u deze met een komma (,). In dit geval worden de metrische gegevens gesegmenteerd in de volgorde waarin de dimensies worden vermeld in de parameter.

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

metricsSegmentInfo

Object

Een metrisch segment

Name	Type	Description
end	string (date_time)	Begintijd van het metrische segment (alleen wanneer een interval is opgegeven).
segments	metricsSegmentInfo[]	Gesegmenteerde metrische gegevens (indien verder gesegmenteerd).
start	string (date_time)	Begintijd van het metrische segment (alleen wanneer een interval is opgegeven).

Delen via

Metrics - Get

URI-parameters

Antwoorden

Beveiliging

oauth2

Bereiken

Voorbeelden

intervaledMetric

Voorbeeldaanvraag

Voorbeeldrespons

segmentedIntervaledMetric

Voorbeeldaanvraag

Voorbeeldrespons

simpleMetric

Voorbeeldaanvraag

Voorbeeldrespons

Definities

errorDetail

errorInfo

errorResponse

MetricId

MetricsAggregation

metricsResult

metricsResultInfo

MetricsSegment

metricsSegmentInfo

Aanvullende resources