Dela via

Metrics - Get Multiple

Tjänst:
Application Insights
API-version:
v1

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

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

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.

Begärandetext

Name Typ Description
body

metricsPostBodySchema[]

Frågan om batchbaserade mått.

Svar

Name Typ Description
200 OK

metricsResults[]

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

postMetric

Exempelbegäran

POST https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics

[
  {
    "id": "failed",
    "parameters": {
      "metricId": "requests/failed",
      "timespan": "P2D",
      "interval": "P1D"
    }
  },
  {
    "id": "count",
    "parameters": {
      "metricId": "requests/count",
      "timespan": "P2D",
      "interval": "P1D"
    }
  }
]

Exempelsvar

Statuskod:
200 
[
  {
    "id": "failed",
    "status": 200,
    "body": {
      "value": {
        "start": "2018-01-22T19:59:12.488Z",
        "end": "2018-01-24T19:59:12.488Z",
        "interval": "P1D",
        "segments": [
          {
            "start": "2018-01-22T19:59:12.488Z",
            "end": "2018-01-23T00:00:00.000Z",
            "requests/failed": {
              "sum": 277
            }
          },
          {
            "start": "2018-01-23T00:00:00.000Z",
            "end": "2018-01-24T00:00:00.000Z",
            "requests/failed": {
              "sum": 1599
            }
          },
          {
            "start": "2018-01-24T00:00:00.000Z",
            "end": "2018-01-24T19:59:12.488Z",
            "requests/failed": {
              "sum": 1392
            }
          }
        ]
      }
    }
  },
  {
    "id": "count",
    "status": 200,
    "body": {
      "value": {
        "start": "2018-01-22T19:59:12.488Z",
        "end": "2018-01-24T19:59:12.488Z",
        "interval": "P1D",
        "segments": [
          {
            "start": "2018-01-22T19:59:12.488Z",
            "end": "2018-01-23T00:00:00.000Z",
            "requests/count": {
              "sum": 1225
            }
          },
          {
            "start": "2018-01-23T00:00:00.000Z",
            "end": "2018-01-24T00:00:00.000Z",
            "requests/count": {
              "sum": 7382
            }
          },
          {
            "start": "2018-01-24T00:00:00.000Z",
            "end": "2018-01-24T19:59:12.488Z",
            "requests/count": {
              "sum": 6674
            }
          }
        ]
      }
    }
  }
]

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

En måttbegäran
metricsResult

Ett måttresultat.
metricsResultInfo

Ett måttresultatdata.
metricsResults

En uppsättning måttresultat.
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
Parameters

Parametrarna för en enskild måttfråga

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
requests/count
requests/duration
requests/failed
users/count
users/authenticated
pageViews/count
pageViews/duration
client/processingDuration
client/receiveDuration
client/networkDuration
client/sendDuration
client/totalDuration
dependencies/count
dependencies/failed
dependencies/duration
exceptions/count
exceptions/browser
exceptions/server
sessions/count
performanceCounters/requestExecutionTime
performanceCounters/requestsPerSecond
performanceCounters/requestsInQueue
performanceCounters/memoryAvailableBytes
performanceCounters/exceptionsPerSecond
performanceCounters/processCpuPercentage
performanceCounters/processIOBytesPerSecond
performanceCounters/processPrivateBytes
performanceCounters/processorCpuPercentage
availabilityResults/availabilityPercentage
availabilityResults/duration
billing/telemetryCount
customEvents/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
min
max
avg
sum
count
unique

metricsPostBodySchema

Objekt

En måttbegäran

Name Typ Description
id

string

En identifierare för den här frågan. Måste vara unikt i begärans posttext. Den här identifieraren är egenskapen "id" för svarsobjektet som representerar den här frågan.
parameters

Parameters

Parametrarna för en enskild måttfråga

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.

metricsResults

Objekt

En uppsättning måttresultat.

Name Typ Description
body

metricsResult

Resultatet av den här måttfrågan.
id

string

Det angivna ID:t för det här måttet.
status

integer (int32)

HTTP-statuskoden för den här måttfrågan.

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

Parameters

Objekt

Parametrarna för en enskild måttfråga

Name Typ Description
aggregation

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

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

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

MetricId

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

string

Aggregeringsfunktionen och riktningen för att sortera segmenten efter. Det här värdet är endast giltigt när segment har angetts.
segment

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

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

integer (int32)

Antalet segment som ska returneras. Det här värdet är endast giltigt när segment har angetts.