Sdílet prostřednictvím


Baselines - List

Seznamy hodnoty standardních hodnot metrik pro prostředek.

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

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

$filter
query

string

$filter se používá ke snížení sady vrácených dat metrik. 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' To je neplatné, protože logický operátor nebo 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: Když 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 dim (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), které se mají načíst.

interval
query

string

duration

Interval (tj. časový interval) dotazu.

metricnames
query

string

Názvy metrik (oddělených čárkami), které se mají načíst. Zvláštní případ: Pokud je v názvu metriky samotná čárka, označte ji pomocí %2. Příklad: Metrika, Název1 by měl být Metric%2Name1.

metricnamespace
query

string

Obor názvů metrik, pro který se má dotazovat definice metrik.

resultType
query

ResultType

Umožňuje načíst pouze metadata standardních hodnot. Při žádosti o data se načtou všechny informace.

sensitivities
query

string

Seznam citlivostí (oddělených čárkami), které se mají načíst.

timespan
query

string

Časový rozsah dotazu Jedná se o řetězec v následujícím formátu "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

Tok Azure Active Directory OAuth2

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
BaselineMetadata

Představuje hodnotu základních metadat.

BaselineSensitivity

citlivost výchozí hodnoty.

ErrorResponse

Popisuje formát chybové odpovědi.

MetricBaselinesResponse

Seznam standardních hodnot metrik.

MetricSingleDimension

Název a hodnota dimenze metriky.

ResultType

Umožňuje načíst pouze metadata standardních hodnot. Při žádosti o data se načtou všechny informace.

SingleBaseline

Základní hodnoty pro jednu hodnotu citlivosti.

SingleMetricBaseline

Standardní výsledky jedné metriky.

TimeSeriesBaseline

Standardní hodnoty pro jednu časovou řadu.

BaselineMetadata

Představuje hodnotu základních metadat.

Name Typ Description
name

string

Název standardních metadat.

value

string

Hodnota metadat směrného plánu.

BaselineSensitivity

citlivost výchozí hodnoty.

Name Typ Description
High

string

Low

string

Medium

string

ErrorResponse

Popisuje formát chybové odpovědi.

Name Typ Description
code

string

Kód chyby

message

string

Chybová zpráva s informacemi o tom, proč operace selhala.

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 standardních hodnot. Při žádosti o data se načtou všechny informace.

Name Typ Description
Data

string

Metadata

string

SingleBaseline

Základní hodnoty pro jednu hodnotu citlivosti.

Name Typ Description
highThresholds

number[]

Vysoké prahové hodnoty standardních hodnot.

lowThresholds

number[]

Nízké prahové hodnoty standardních hodnot.

sensitivity

BaselineSensitivity

citlivost výchozí hodnoty.

SingleMetricBaseline

Standardní výsledky jedné metriky.

Name Typ Description
id

string

ID standardních hodnot 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 časová řada, která byla dotazována.

properties.interval

string

Interval (velikost okna), pro který se data metrik vrátila. To může být v budoucnu upraveno a vráceno zpět z původního požadavku. Pokud byl proveden požadavek na metadata, není k dispozici.

properties.namespace

string

Obor názvů metrik, které byly dotazovány.

properties.timespan

string

Časový rozsah, pro který byla data načtena. Jeho hodnota se skládá ze dvou zřetězených hodnot datetime oddělených parametrem '/'. To může být v budoucnu upraveno a vráceno zpět z původního požadavku.

type

string

Typ prostředku standardního prostředku metriky.

TimeSeriesBaseline

Standardní hodnoty 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 metadat standardních hodnot.

timestamps

string[]

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