Metrics - Get

Referens

Tjänst:: Application Insights

API-version:: v1

Hämta måttdata
Hämtar måttvärden för ett enda mått

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

Med valfria parametrar:

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-parametrar

Name	I	Obligatorisk	Typ	Description
appId	path	True	string	ID för programmet. Det här är Program-ID från bladet API-åtkomstinställningar i Azure Portal.
metricId	path	True	MetricId	ID för måttet. Det här är antingen ett STANDARD-AI-mått eller ett programspecifikt anpassat mått.
aggregation	query		MetricsAggregation[]	Den aggregering som ska användas vid beräkning av måttvärdena. Om du vill hämta mer än en aggregering åt gången separerar du dem med ett kommatecken. Om ingen aggregering anges används standardaggregeringen för måttet.
filter	query		string	Ett uttryck som används för att filtrera resultaten. Det här värdet ska vara ett giltigt OData-filteruttryck där nycklarna för varje sats ska vara tillämpliga dimensioner för det mått som du hämtar.
interval	query		string duration	Tidsintervallet som ska användas vid hämtning av måttvärden. Det här är en ISO8601 varaktighet. Om intervall utelämnas aggregeras måttvärdet över hela tidsintervallet. Om intervall anges kan servern justera intervallet till en mer lämplig storlek baserat på det tidsintervall som används för frågan. I samtliga fall ingår det faktiska intervallet som används för frågan i svaret.
orderby	query		string	Sammansättningsfunktionen och riktningen för att sortera segmenten efter. Det här värdet är endast giltigt när segment har angetts.
segment	query		MetricsSegment[]	Namnet på den dimension som måttvärdena ska segmenteras efter. Den här dimensionen måste gälla för det mått som du hämtar. Om du vill segmentera med mer än en dimension i taget separerar du dem med ett kommatecken (,). I det här fallet segmenteras måttdata i den ordning som dimensionerna anges i parametern .
timespan	query		string	Tidsintervallet för att hämta måttvärden. Det här är ett värde för ISO8601 tidsperiod. Om tidsintervallet utelämnas används ett standardtidsintervall på `PT12H` ("de senaste 12 timmarna"). Det faktiska tidsintervallet som efterfrågas kan justeras av servern. I samtliga fall ingår det faktiska tidsintervallet som används för frågan i svaret.
top	query		integer int32	Antalet segment som ska returneras. Det här värdet är endast giltigt när segment har angetts.

Svar

Name	Typ	Description
200 OK	metricsResult	Lyckat svar
Other Status Codes	errorResponse	Ett felsvarsobjekt.

Säkerhet

oauth2

Ansluta till Azure Application Insights API

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

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

intervaledMetric

segmentedIntervaledMetric

simpleMetric

intervaledMetric

Exempelbegäran

HTTP

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

Exempelsvar

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

Exempelbegäran

HTTP

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

Exempelsvar

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

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

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

Definitioner

Name	Description
errorDetail	Felinformation.
errorInfo	Koden och meddelandet för ett fel.
errorResponse	Felinformation.
MetricId	ID för måttet. Det här är antingen ett STANDARD-AI-mått eller ett programspecifikt anpassat mått.
MetricsAggregation	Den aggregering som ska användas vid beräkning av måttvärdena. Om du vill hämta mer än en aggregering åt gången separerar du dem med ett kommatecken. Om ingen aggregering anges används standardaggregeringen för måttet.
metricsResult	Ett måttresultat.
metricsResultInfo	Ett måttresultatdata.
MetricsSegment	Namnet på den dimension som måttvärdena ska segmenteras efter. Den här dimensionen måste gälla för det mått som du hämtar. Om du vill segmentera med mer än en dimension i taget separerar du dem med ett kommatecken (,). I det här fallet segmenteras måttdata i den ordning som dimensionerna anges i parametern .
metricsSegmentInfo	Ett måttsegment

errorDetail

Felinformation.

Name	Typ	Description
additionalProperties	object
code	string	Felkoden.
message	string	Ett felmeddelande som kan läsas av människor.
resources	string[]	Anger resurser som var ansvariga för felet.
target	string	Anger vilken egenskap i begäran som ansvarar för felet.
value	string	Anger vilket värde i "mål" som ansvarar för felet.

errorInfo

Koden och meddelandet för ett fel.

Name	Typ	Description
additionalProperties	object
code	string	En felkod som kan läsas av datorn.
details	errorDetail[]	felinformation.
innererror	errorInfo	Koden och meddelandet för ett fel. Inre felinformation om de finns.
message	string	Ett felmeddelande som kan läsas av människor.

errorResponse

Felinformation.

Name	Typ	Description
error	errorInfo	Koden och meddelandet för ett fel. Felinformationen.

MetricId

ID för måttet. Det här är antingen ett STANDARD-AI-mått eller ett programspecifikt anpassat mått.

Name	Typ	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

Den aggregering som ska användas vid beräkning av måttvärdena. Om du vill hämta mer än en aggregering åt gången separerar du dem med ett kommatecken. Om ingen aggregering anges används standardaggregeringen för måttet.

Name	Typ	Description
avg	string
count	string
max	string
min	string
sum	string
unique	string

metricsResult

Ett måttresultat.

Name	Typ	Description
value	metricsResultInfo	Ett måttresultatdata.

metricsResultInfo

Ett måttresultatdata.

Name	Typ	Description
end	string	Starttid för måttet.
interval	string	Det intervall som används för att segmentera måttdata.
segments	metricsSegmentInfo[]	Segmenterade måttdata (om segmenterade).
start	string	Starttid för måttet.

MetricsSegment

Namnet på den dimension som måttvärdena ska segmenteras efter. Den här dimensionen måste gälla för det mått som du hämtar. Om du vill segmentera med mer än en dimension i taget separerar du dem med ett kommatecken (,). I det här fallet segmenteras måttdata i den ordning som dimensionerna anges i parametern .

Name	Typ	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

Ett måttsegment

Name	Typ	Description
end	string	Starttid för måttsegmentet (endast när ett intervall angavs).
segments	metricsSegmentInfo[]	Segmenterade måttdata (om de segmenteras ytterligare).
start	string	Starttid för måttsegmentet (endast när ett intervall angavs).

Dela via

Metrics - Get

URI-parametrar

Svar

Säkerhet

oauth2

Omfattningar

Exempel

intervaledMetric

Exempelbegäran

Exempelsvar

segmentedIntervaledMetric

Exempelbegäran

Exempelsvar

simpleMetric

Exempelbegäran

Exempelsvar

Definitioner

errorDetail

errorInfo

errorResponse

MetricId

MetricsAggregation

metricsResult

metricsResultInfo

MetricsSegment

metricsSegmentInfo

Ytterligare resurser