Sdílet prostřednictvím


Metrics - Get Multiple

Načtení dat metriky
Získá hodnoty metrik pro více metrik.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
appId
path True

string

ID aplikace. Toto je ID aplikace z okna Nastavení přístupu k rozhraní API v Azure Portal.

Text požadavku

Name Typ Description
body

metricsPostBodySchema[]

Dotaz na dávkové metriky

Odpovědi

Name Typ Description
200 OK

metricsResults[]

Úspěšná odpověď

Other Status Codes

errorResponse

Objekt odpovědi na chybu.

Zabezpečení

oauth2

Připojení k rozhraní API Aplikace Azure Insights

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

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

postMetric

Ukázkový požadavek

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"
    }
  }
]

Ukázková odpověď

[
  {
    "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
            }
          }
        ]
      }
    }
  }
]

Definice

Name Description
errorDetail

Podrobnosti o chybě.

errorInfo

Kód a zpráva pro chybu.

errorResponse

Podrobnosti o chybě.

MetricId

ID metriky Jedná se buď o standardní metriku AI, nebo o vlastní metriku specifickou pro aplikaci.

MetricsAggregation

Agregace, která se má použít při výpočtu hodnot metrik. Pokud chcete načíst více agregací najednou, oddělte je čárkou. Pokud není zadána žádná agregace, použije se výchozí agregace pro metriku.

metricsPostBodySchema

Žádost o metriku

metricsResult

Výsledek metriky.

metricsResultInfo

Data výsledku metriky.

metricsResults

Sada výsledků metrik.

MetricsSegment

Název dimenze, podle které se mají hodnoty metrik rozdělit. Tato dimenze musí být použitelná pro metriku, kterou načítáte. Pokud chcete segmentovat více dimenzí najednou, oddělte je čárkou (,). V tomto případě budou data metriky segmentována v pořadí, v jakém jsou dimenze uvedeny v parametru.

metricsSegmentInfo

Segment metriky

Parameters

Parametry pro jeden dotaz na metriky

errorDetail

Podrobnosti o chybě.

Name Typ Description
additionalProperties

object

code

string

Kód chyby.

message

string

Chybová zpráva čitelná pro člověka.

resources

string[]

Označuje prostředky, které byly zodpovědné za chybu.

target

string

Určuje, která vlastnost v požadavku je zodpovědná za chybu.

value

string

Označuje, která hodnota v "target" je zodpovědná za chybu.

errorInfo

Kód a zpráva pro chybu.

Name Typ Description
additionalProperties

object

code

string

Strojově čitelný kód chyby.

details

errorDetail[]

podrobnosti o chybě.

innererror

errorInfo

Kód a zpráva pro chybu.
Podrobnosti o vnitřní chybě, pokud existují.

message

string

Chybová zpráva čitelná pro člověka.

errorResponse

Podrobnosti o chybě.

Name Typ Description
error

errorInfo

Kód a zpráva pro chybu.
Podrobnosti o chybě

MetricId

ID metriky Jedná se buď o standardní metriku AI, nebo o vlastní metriku specifickou pro aplikaci.

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

Agregace, která se má použít při výpočtu hodnot metrik. Pokud chcete načíst více agregací najednou, oddělte je čárkou. Pokud není zadána žádná agregace, použije se výchozí agregace pro metriku.

Name Typ Description
avg

string

count

string

max

string

min

string

sum

string

unique

string

metricsPostBodySchema

Žádost o metriku

Name Typ Description
id

string

Identifikátor tohoto dotazu. Musí být jedinečný v textu požadavku. Tento identifikátor bude vlastnost id objektu odpovědi představujícího tento dotaz.

parameters

Parameters

Parametry pro jeden dotaz na metriky

metricsResult

Výsledek metriky.

Name Typ Description
value

metricsResultInfo

Data výsledku metriky.

metricsResultInfo

Data výsledku metriky.

Name Typ Description
end

string

Počáteční čas metriky.

interval

string

Interval použitý k segmentace dat metriky.

segments

metricsSegmentInfo[]

Segmentovaná data metrik (pokud jsou segmentovaná)

start

string

Počáteční čas metriky.

metricsResults

Sada výsledků metrik.

Name Typ Description
body

metricsResult

Výsledky tohoto dotazu na metriku

id

string

Zadané ID pro tuto metriku.

status

integer

Stavový kód HTTP tohoto dotazu na metriku.

MetricsSegment

Název dimenze, podle které se mají hodnoty metrik rozdělit. Tato dimenze musí být použitelná pro metriku, kterou načítáte. Pokud chcete segmentovat více dimenzí najednou, oddělte je čárkou (,). V tomto případě budou data metriky segmentována v pořadí, v jakém jsou dimenze uvedeny v parametru.

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

Segment metriky

Name Typ Description
end

string

Počáteční čas segmentu metriky (pouze při zadání intervalu)

segments

metricsSegmentInfo[]

Segmentovaná data metrik (pokud jsou dále segmentovaná)

start

string

Počáteční čas segmentu metriky (pouze při zadání intervalu)

Parameters

Parametry pro jeden dotaz na metriky

Name Typ Description
aggregation

MetricsAggregation[]

Agregace, která se má použít při výpočtu hodnot metrik. Pokud chcete načíst více agregací najednou, oddělte je čárkou. Pokud není zadána žádná agregace, použije se výchozí agregace pro metriku.

filter

string

Výraz použitý k filtrování výsledků. Tato hodnota by měla být platným výrazem filtru OData, kde klíče každé klauzule by měly být použitelné dimenze pro metriku, kterou načítáte.

interval

string

Časový interval, který se má použít při načítání hodnot metrik. Jedná se o ISO8601 dobu trvání. Pokud je interval vynechán, hodnota metriky se agreguje v celém časovém rozsahu. Pokud je zadán interval, server může upravit interval na vhodnější velikost na základě časového rozsahu použitého pro dotaz. Ve všech případech je do odpovědi zahrnut skutečný interval použitý pro dotaz.

metricId

MetricId

ID metriky Jedná se buď o standardní metriku AI, nebo o vlastní metriku specifickou pro aplikaci.

orderby

string

Agregační funkce a směr řazení segmentů. Tato hodnota je platná pouze v případě, že je zadaný segment.

segment

MetricsSegment[]

Název dimenze, podle které se mají hodnoty metrik rozdělit. Tato dimenze musí být použitelná pro metriku, kterou načítáte. Pokud chcete segmentovat více dimenzí najednou, oddělte je čárkou (,). V tomto případě budou data metriky segmentována v pořadí, v jakém jsou dimenze uvedeny v parametru.

timespan

string

Časový rozsah, pro který se mají načíst hodnoty metrik. Jedná se o ISO8601 hodnotu časového období. Pokud je časový rozsah vynechán, použije se výchozí časový rozsah PT12H ("posledních 12 hodin"). Skutečný časový rozsah, na který se dotazuje, může být upraven serverem. Ve všech případech je do odpovědi zahrnuté skutečné časové rozmezí použité pro dotaz.

top

integer

Počet segmentů, které se mají vrátit. Tato hodnota je platná pouze v případě, že je zadaný segment.