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-portalen.
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ärden. Om du vill hämta mer än en aggregering i taget separerar du dem med kommatecken. Om ingen aggregering har angetts används standardaggregering för måttet.
filter	query		string	Ett uttryck som används för att filtrera resultatet. 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 intervallet utelämnas aggregeras måttvärdet över hela tidsintervallet. Om intervallet 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 intervall som används för frågan i svaret.
orderby	query		string	Aggregeringsfunktionen 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å dimensionen 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 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 ISO8601 tidsperiodsvärde. Om tidsintervall 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ärden. Om du vill hämta mer än en aggregering i taget separerar du dem med kommatecken. Om ingen aggregering har angetts används standardaggregering för måttet.
metricsResult	Ett måttresultat.
metricsResultInfo	Ett måttresultatdata.
MetricsSegment	Namnet på dimensionen 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 kommatecken (,). I det här fallet segmenteras måttdata i den ordning som dimensionerna anges i parametern.
metricsSegmentInfo	Ett måttsegment

errorDetail

Objekt

Felinformation.

Name	Typ	Description
additionalProperties	object
code	string	Felets kod.
message	string	Ett mänskligt läsbart felmeddelande.
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ålet som är ansvarigt för felet.

errorInfo

Objekt

Koden och meddelandet för ett fel.

Name	Typ	Description
additionalProperties	object
code	string	En maskinläsbar felkod.
details	errorDetail[]	felinformation.
innererror	errorInfo	Koden och meddelandet för ett fel. Inre felinformation om de finns.
message	string	Ett mänskligt läsbart felmeddelande.

errorResponse

Objekt

Felinformation.

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

MetricId

Uppräkning

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

Värde	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

Uppräkning

Den aggregering som ska användas vid beräkning av måttvärden. Om du vill hämta mer än en aggregering i taget separerar du dem med kommatecken. Om ingen aggregering har angetts används standardaggregering för måttet.

Värde	Description
avg
count
max
min
sum
unique

metricsResult

Objekt

Ett måttresultat.

Name	Typ	Description
value	metricsResultInfo	Ett måttresultatdata.

metricsResultInfo

Objekt

Ett måttresultatdata.

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

MetricsSegment

Uppräkning

Namnet på dimensionen 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 kommatecken (,). I det här fallet segmenteras måttdata i den ordning som dimensionerna anges i parametern.

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

metricsSegmentInfo

Objekt

Ett måttsegment

Name	Typ	Description
end	string (date_time)	Starttid för måttsegmentet (endast när ett intervall angavs).
segments	metricsSegmentInfo[]	Segmenterade måttdata (om de segmenteras ytterligare).
start	string (date_time)	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