Sdílet prostřednictvím


Baselines - List

Obsahuje hodnoty směrného plánu metriky proprostředku .

GET https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/metricBaselines?api-version=2019-03-01
GET https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/metricBaselines?metricnames={metricnames}&metricnamespace={metricnamespace}&timespan={timespan}&interval={interval}&aggregation={aggregation}&sensitivities={sensitivities}&$filter={$filter}&resultType={resultType}&api-version=2019-03-01

Parametry identifikátoru URI

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

string

Identifikátor prostředku.

api-version
query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

$filter
query

string

$filter slouží ke snížení sady vrácených dat metriky. Příklad: Metrika obsahuje metadata A, B a C. - Vrátí všechny časové řady C, kde A = a1 a B = b1 nebo b2 $filter=A eq 'a1' a B eq 'b1' nebo B eq 'b2' a C eq '*' - Neplatná varianta: $filter=A eq 'a1' a B eq 'b1' a C eq '*' nebo B = 'b2' Toto je neplatné, protože logický operátor nemůže oddělit dva různé názvy metadat. - Vrátí všechny časové řady, kde A = a1, B = b1 a C = c1: $filter=A eq 'a1' a B eq 'b1' a C eq 'c1' - Vrátí všechny časové řady, kde A = a1 $filter=A eq 'a1' a B eq '' a C eq ''. Zvláštní případ: Pokud název dimenze nebo hodnota dimenze používá kulaté závorky. Příklad: Pokud je název dimenze dim (test) 1 Místo použití $filter= "dim (test) 1 eq '' " použijte **$filter= "dim %2528test%2529 1 eq '' "** Pokud je název dimenze šedě (test) 3 a hodnota dimenze je dim3 (test) val Místo použití $filter= "dim (test) 3 eq 'dim3 (test) val' použijte $filter= "dim %2528test%2529 3 eq 'dim3 %2528test%2529 val' "

aggregation
query

string

Seznam typů agregace (oddělených čárkami) k načtení.

interval
query

string (duration)

Interval dotazu (tj. timegrain).

metricnames
query

string

Názvy metrik (oddělené čárkami) pro načtení. Zvláštní případ: Pokud má název metriky samotný čárku, použijte k jeho označení %2. Příklad: Metrika, Název1 by měla být metriky%2Name1.

metricnamespace
query

string

Obor názvů metrik, který obsahuje požadované názvy metrik.

resultType
query

ResultType

Umožňuje načíst pouze metadata směrného plánu. Při žádosti o data se načtou všechny informace.

sensitivities
query

string

Seznam citlivostí (oddělených čárkami) k načtení.

timespan
query

string

Časový rozsah dotazu. Jedná se o řetězec s následujícím formátem "startDateTime_ISO/endDateTime_ISO".

Odpovědi

Name Typ Description
200 OK

MetricBaselinesResponse

Úspěšný požadavek na získání seznamu hodnot standardních hodnot metrik

Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

Get metric baselines

Ukázkový požadavek

GET https://management.azure.com/subscriptions/b368ca2f-e298-46b7-b0ab-012281956afa/resourceGroups/vms/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.Insights/metricBaselines?timespan=2019-03-12T11:00:00.000Z/2019-03-12T12:00:00.000Z&interval=PT1H&aggregation=average&sensitivities=Low,Medium&api-version=2019-03-01

Ukázková odpověď

{
  "value": [
    {
      "id": "/subscriptions/11aeb0ed-456b-4ca0-8df5-b9fbdc63d0d3/resourceGroups/SmartAnalytics-DEV-VM/providers/Microsoft.Compute/virtualMachines/DemoVM1/providers/microsoft.insights/metricBaselines/Percentage CPU",
      "type": "microsoft.insights/metricBaselines",
      "name": "Percentage CPU",
      "properties": {
        "interval": "PT1H",
        "timespan": "2019-03-12T11:00:00.000Z/2019-03-12T12:00:00.000Z",
        "namespace": "microsoft.compute/virtualmachines",
        "baselines": [
          {
            "aggregation": "average",
            "dimensions": [],
            "metadataValues": [
              {
                "name": "ErrorType",
                "value": "TooManyAnomalies"
              },
              {
                "name": "SeasonalityFrequency",
                "value": "288"
              }
            ],
            "timestamps": [
              "2019-03-12T11:00:00.000Z",
              "2019-03-12T12:00:00.000Z"
            ],
            "data": [
              {
                "sensitivity": "Low",
                "lowThresholds": [
                  30,
                  31.1
                ],
                "highThresholds": [
                  90.3453,
                  91.3453
                ]
              },
              {
                "sensitivity": "Medium",
                "lowThresholds": [
                  50,
                  51.1
                ],
                "highThresholds": [
                  70.3453,
                  71.3453
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

Definice

Name Description
AdditionalInfo

Pole objektů s vlastnostmi type a info. Schéma "info" je specifické pro službu a závisí na řetězci typu.

BaselineMetadata

Představuje hodnotu základních metadat.

BaselineSensitivity

citlivost směrného plánu.

Error
ErrorDetail

Popisuje podrobnosti odpovědi na chybu.

ErrorResponse

Popisuje formát odpovědi na chybu.

MetricBaselinesResponse

Seznam standardních hodnot metrik

MetricSingleDimension

Název a hodnota dimenze metriky.

ResultType

Umožňuje načíst pouze metadata směrného plánu. Při žádosti o data se načtou všechny informace.

SingleBaseline

Hodnoty směrného plánu pro jednu hodnotu citlivosti.

SingleMetricBaseline

Výsledky směrného plánu jedné metriky.

TimeSeriesBaseline

Hodnoty směrného plánu pro jednu časovou řadu.

AdditionalInfo

Pole objektů s vlastnostmi type a info. Schéma "info" je specifické pro službu a závisí na řetězci typu.

Name Typ Description
info

object

Další informace specifické pro daný typ.

type

string

Typ dalších informací.

BaselineMetadata

Představuje hodnotu základních metadat.

Name Typ Description
name

string

Název standardních metadat.

value

string

Hodnota základních metadat.

BaselineSensitivity

citlivost směrného plánu.

Hodnota Description
Low
Medium
High

Error

Name Typ Description
additionalInfo

AdditionalInfo[]

Pole objektů s vlastnostmi type a info. Schéma "info" je specifické pro službu a závisí na řetězci typu.

code

string

Nelokalizovaný řetězec, který lze použít k programové identifikaci chyby.

details

ErrorDetail[]

Pole dalších vnořených objektů s informacemi o odpovědích na chybu, jak je popsáno v tomto kontraktu.

message

string

Podrobně popisuje chybu a poskytuje informace o ladění. Pokud je v požadavku nastavená Accept-Language, musí být lokalizovaná do daného jazyka.

target

string

Cíl konkrétní chyby (například název vlastnosti v chybě).

ErrorDetail

Popisuje podrobnosti odpovědi na chybu.

Name Typ Description
additionalInfo

AdditionalInfo[]

Pole objektů s vlastnostmi type a info. Schéma "info" je specifické pro službu a závisí na řetězci typu.

code

string

Nelokalizovaný řetězec, který lze použít k programové identifikaci chyby.

message

string

Podrobně popisuje chybu a poskytuje informace o ladění.

target

string

Cíl konkrétní chyby (například název vlastnosti v chybě).

ErrorResponse

Popisuje formát odpovědi na chybu.

Name Typ Description
error

Error

MetricBaselinesResponse

Seznam standardních hodnot metrik

Name Typ Description
value

SingleMetricBaseline[]

Seznam standardních hodnot metrik

MetricSingleDimension

Název a hodnota dimenze metriky.

Name Typ Description
name

string

Název dimenze.

value

string

Hodnota dimenze.

ResultType

Umožňuje načíst pouze metadata směrného plánu. Při žádosti o data se načtou všechny informace.

Hodnota Description
Data
Metadata

SingleBaseline

Hodnoty směrného plánu pro jednu hodnotu citlivosti.

Name Typ Description
highThresholds

number[] (double)

Vysoké prahové hodnoty směrného plánu.

lowThresholds

number[] (double)

Nízké prahové hodnoty směrného plánu.

sensitivity

BaselineSensitivity

citlivost směrného plánu.

SingleMetricBaseline

Výsledky směrného plánu jedné metriky.

Name Typ Description
id

string

ID směrného plánu metriky.

name

string

Název metriky, pro kterou byly načteny směrné plány.

properties.baselines

TimeSeriesBaseline[]

Směrný plán pro každou časnou řadu, která byla dotazována.

properties.interval

string (duration)

Interval (velikost okna), pro který byla vrácena data metriky. To se může v budoucnu upravit a vrátit zpět z původního požadavku. To není k dispozici, pokud byl proveden požadavek na metadata.

properties.namespace

string

Obor názvů metrik byl dotazován.

properties.timespan

string

Časový rozsah, pro který byla data načtena. Jeho hodnota se skládá ze dvou zřetězených datových časů oddělených hodnotou /. To se může v budoucnu upravit a vrátit zpět z původního požadavku.

type

string

Typ prostředku základního prostředku metriky.

TimeSeriesBaseline

Hodnoty směrného plánu pro jednu časovou řadu.

Name Typ Description
aggregation

string

Typ agregace metriky.

data

SingleBaseline[]

Základní hodnoty pro každou citlivost.

dimensions

MetricSingleDimension[]

Rozměry této časové řady.

metadataValues

BaselineMetadata[]

Hodnoty základních metadat.

timestamps

string[] (date-time)

Seznam časových razítek směrných plánů.