Baselines - List

Service:

Monitor

API-versie:

2019-03-01

geeft een lijst weer van de metrische basislijnwaarden voor een resource.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/metricBaselines?api-version=2019-03-01

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
resourceUri	path	True	string	De volledig gekwalificeerde Azure Resource manager-identificatie van de resource.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
$filter	query		string	De $filter wordt gebruikt om de set metrische gegevens te verminderen die worden geretourneerd. Voorbeeld: Metrische gegevens bevatten metagegevens A, B en C. - Alle tijdreeksen van C retourneren waarbij A = a1 en B = b1 of b2 $filter=A eq 'a1' en B eq 'b1' of B eq 'b2' en C eq '*' - Ongeldige variant: $filter=A eq 'a1' en B eq 'b1' en C eq '*' of B = 'b2' Dit is ongeldig omdat de logische of operator twee verschillende metagegevensnamen niet kan scheiden. - Alle tijdreeksen retourneren waarbij A = a1, B = b1 en C = c1: $filter=A eq 'a1' en B eq 'b1' en C eq 'c1' - Alle tijdreeksen retourneren waarbij A = a1 $filter=A eq 'a1' en B eq '' en C eq ''. Speciaal geval: Wanneer de dimensienaam of dimensiewaarde ronde vierkante haken gebruikt. Bijvoorbeeld: Wanneer de dimensienaam is dim (test) 1 Gebruik in plaats van $filter= "dim (test) 1 eq "" gebruik **$filter= "dim %2528test%2529 1 eq "" "** Wanneer de dimensienaam is dim (test) 3 en dimensiewaarde is dim3 (test) val Gebruik in plaats van $filter= "dim (test) 3 eq "dim3 (test) val" gebruik $filter= "dim %2528test%2529 3 eq "dim3 %2528test%2529 val"
aggregation	query		string	De lijst met aggregatietypen (door komma's gescheiden) die moeten worden opgehaald.
interval	query		string (duration)	Het interval (bijvoorbeeld timegrain) van de query.
metricnames	query		string	De namen van de metrische gegevens (door komma's gescheiden) die moeten worden opgehaald. Speciaal geval: Als een metrische naam zelf een komma bevat, gebruikt u %2 om deze aan te geven. Bijvoorbeeld: 'Metriek,Naam1' moet worden 'Metrische%2Name1'
metricnamespace	query		string	Metrische naamruimte die de aangevraagde metrische namen bevat.
resultType	query		ResultType	Hiermee kunnen alleen metagegevens van de basislijn worden opgehaald. Op gegevensaanvraag worden alle gegevens opgehaald.
sensitivities	query		string	De lijst met vertrouwelijkheden (door komma's gescheiden) die moeten worden opgehaald.
timespan	query		string	De tijdsduur van de query. Het is een tekenreeks met de volgende notatie 'startDateTime_ISO/endDateTime_ISO'.

Antwoorden

Name	Type	Description
200 OK	MetricBaselinesResponse	De aanvraag is voltooid.
Other Status Codes	MetricBaselinesErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Get metric baselines

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
BaselineMetadata	Vertegenwoordigt een basislijnmetagegevenswaarde.
BaselineSensitivity	de gevoeligheid van de basislijn.
MetricBaselinesErrorResponse	Beschrijft de indeling van foutreactie.
MetricBaselinesResponse	Een lijst met metrische basislijnen.
MetricSingleDimension	De naam en waarde van de metrische dimensie.
Microsoft.Common.ErrorDetail	Beschrijft details van een foutreactie.
Microsoft.Common.ErrorDetailAdditionalInfoItem
Microsoft.Common.ErrorResponseError
Microsoft.Common.ErrorResponseErrorAdditionalInfoItem
ResultType	Hiermee kunnen alleen metagegevens van de basislijn worden opgehaald. Op gegevensaanvraag worden alle gegevens opgehaald.
SingleBaseline	De basislijnwaarden voor één gevoeligheidswaarde.
SingleMetricBaseline	De basislijnresultaten van één metrische waarde.
TimeSeriesBaseline	De basislijnwaarden voor één tijdreeks.

BaselineMetadata

Object

Vertegenwoordigt een basislijnmetagegevenswaarde.

Name	Type	Description
name	string	Naam van de metagegevens van de basislijn.
value	string	Waarde van de metagegevens van de basislijn.

BaselineSensitivity

Opsomming

de gevoeligheid van de basislijn.

Waarde	Description
Low	Low
Medium	Medium
High	Hoog

MetricBaselinesErrorResponse

Object

Beschrijft de indeling van foutreactie.

Name	Type	Description
error	Microsoft.Common.ErrorResponseError

MetricBaselinesResponse

Object

Een lijst met metrische basislijnen.

Name	Type	Description
nextLink	string	De URL om de volgende reeks resultaten te krijgen.
value	SingleMetricBaseline[]	De lijst met metrische basislijnen.

MetricSingleDimension

Object

De naam en waarde van de metrische dimensie.

Name	Type	Description
name	string	Naam van de dimensie.
value	string	Waarde van de dimensie.

Microsoft.Common.ErrorDetail

Object

Beschrijft details van een foutreactie.

Name	Type	Description
additionalInfo	Microsoft.Common.ErrorDetailAdditionalInfoItem[]	Een matrix met objecten met de eigenschappen 'type' en 'info'. Het schema van 'info' is servicespecifiek en is afhankelijk van de tekenreeks 'type'.
code	string	Niet-gelokaliseerde tekenreeks die kan worden gebruikt om de fout programmatisch te identificeren.
message	string	Hierin wordt de fout gedetailleerd beschreven en vindt u informatie over foutopsporing.
target	string	Het doel van de specifieke fout (bijvoorbeeld de naam van de eigenschap in fout).

Microsoft.Common.ErrorDetailAdditionalInfoItem

Object

Name	Type	Description
info		De aanvullende informatie die specifiek is voor het type.
type	string	Het type aanvullende informatie.

Microsoft.Common.ErrorResponseError

Object

Name	Type	Description
additionalInfo	Microsoft.Common.ErrorResponseErrorAdditionalInfoItem[]	Een matrix met objecten met de eigenschappen 'type' en 'info'. Het schema van 'info' is servicespecifiek en is afhankelijk van de tekenreeks 'type'.
code	string	Niet-gelokaliseerde tekenreeks die kan worden gebruikt om de fout programmatisch te identificeren.
details	Microsoft.Common.ErrorDetail[]	Een matrix met aanvullende geneste informatieobjecten voor foutreacties, zoals beschreven in dit contract.
message	string	Hierin wordt de fout gedetailleerd beschreven en vindt u informatie over foutopsporing. Als Accept-Language is ingesteld in de aanvraag, moet deze worden gelokaliseerd naar die taal.
target	string	Het doel van de specifieke fout (bijvoorbeeld de naam van de eigenschap in fout).

Microsoft.Common.ErrorResponseErrorAdditionalInfoItem

Object

Name	Type	Description
info		De aanvullende informatie die specifiek is voor het type.
type	string	Het type aanvullende informatie.

ResultType

Opsomming

Hiermee kunnen alleen metagegevens van de basislijn worden opgehaald. Op gegevensaanvraag worden alle gegevens opgehaald.

Waarde	Description
Data	Data
Metadata	Metadata

SingleBaseline

Object

De basislijnwaarden voor één gevoeligheidswaarde.

Name	Type	Description
highThresholds	number[] (double)	De hoge drempelwaarden van de basislijn.
lowThresholds	number[] (double)	De lage drempelwaarden van de basislijn.
sensitivity	BaselineSensitivity	de gevoeligheid van de basislijn.

SingleMetricBaseline

Object

De basislijnresultaten van één metrische waarde.

Name	Type	Description
id	string	De basislijn-id voor metrische gegevens.
name	string	De naam van de metrische waarde waarvoor de basislijnen zijn opgehaald.
properties.baselines	TimeSeriesBaseline[]	De basislijn voor elke tijdreeks waarop een query is uitgevoerd.
properties.interval	string (duration)	Het interval (venstergrootte) waarin de metrische gegevens zijn geretourneerd. Dit kan in de toekomst worden aangepast en geretourneerd van wat oorspronkelijk is aangevraagd. Dit is niet aanwezig als er een metagegevensaanvraag is ingediend.
properties.namespace	string	Er is een query uitgevoerd op de naamruimte van de metrische gegevens.
properties.timespan	string	De periode waarvoor de gegevens zijn opgehaald. De waarde bestaat uit twee datum/tijd-samenvoeging, gescheiden door '/'. Dit kan in de toekomst worden aangepast en geretourneerd van wat oorspronkelijk is aangevraagd.
type	string	Het resourcetype van de metrische basislijnresource.

TimeSeriesBaseline

Object

De basislijnwaarden voor één tijdreeks.

Name	Type	Description
aggregation	string	Het aggregatietype van de metrische waarde.
data	SingleBaseline[]	De basislijnwaarden voor elke gevoeligheid.
dimensions	MetricSingleDimension[]	De dimensies van deze tijdreeks.
metadataValues	BaselineMetadata[]	De metagegevenswaarden van de basislijn.
timestamps	string[] (date-time)	De lijst met tijdstempels van de basislijnen.