az monitor sli

Vorschau

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Manage Service Level Indicators (SLIs) in Azure Monitor.

Identitätsmodell: SLIs unterstützen nur vom Benutzer zugewiesene verwaltete Identitäten (UAMIs). Die vom System zugewiesene Identität wird vom Dienst nicht unterstützt. Auf ein UAMI muss an drei Stellen verwiesen werden, auf die der Dienst synchronisiert wird:

Der ARM-Identitätsblock (identity.userAssignedIdentities).
Jedes Ziel AMW (properties.destinationAmwAccounts[].identity).
Jede Signalquelle (properties.sliProperties.{signals|goodSignals| totalSignals}.signalSources[].sourceAmwAccountManagedIdentity). Der Dienst lehnt PUTs ab, wenn diese drei Gruppen nicht zustimmen. Um ein UAMI zu drehen, aktualisieren Sie alle drei Oberflächen in einem einzigen az monitor sli update Aufruf so, dass der PUT atomisch ist. Siehe az monitor sli update --help Beispiele für arbeitstätige Drehungen. Führen Sie az monitor sli show zuerst aus, um die tatsächlichen Indizes zu bestätigen und welcher Signalplatz (signals für fensterbasiert, goodSignals + totalSignals für anforderungsbasiert) aufgefüllt wird.

Befehle

Name	Beschreibung	Typ	Status
az monitor sli create	Erstellen Sie eine SLI-Ressource.	Core	Preview
az monitor sli delete	Löschen sie eine SLI-Ressource.	Core	Preview
az monitor sli list	Alle SLI-Ressourcen unter einer übergeordneten Ressource auflisten.	Core	Preview
az monitor sli show	Rufen Sie eine SLI-Ressource ab.	Core	Preview
az monitor sli update	Aktualisieren einer SLI-Ressource.	Core	Preview

az monitor sli create

Bearbeiten

Vorschau

Die Befehlsgruppe "az monitor sli" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie eine SLI-Ressource.

Eine vom Benutzer zugewiesene verwaltete Identität ist erforderlich und muss mit der Identität übereinstimmen, auf die von jedem AMW-Zielkonto und jeder Signalquelle verwiesen wird. Komplexe Objektargumente (--baseline-properties, --destination-amw-accounts, --sli-properties) sind am einfachsten über JSON-Dateien mithilfe der @filename.json Syntax zu übergeben.

az monitor sli create --mi-user-assigned --user-assigned
                      --service-group-name
                      --sli-name
                      [--acquire-policy-token]
                      [--amw-accounts --destination-amw-accounts]
                      [--baseline-properties]
                      [--category {Availability, Latency}]
                      [--change-reference]
                      [--description]
                      [--enable-alert {0, 1, f, false, n, no, t, true, y, yes}]
                      [--evaluation-type {RequestBased, WindowBased}]
                      [--sli-properties]

Beispiele

Erstellen Sie eine fensterbasierte VerfügbarkeitS-SLI aus JSON-Nutzlastdateien.

az monitor sli create --service-group-name MyServiceGroup --sli-name MySli --user-assigned <uami-arm-id> --category Availability --evaluation-type WindowBased --description "API availability SLI" --baseline-properties @baseline.json --destination-amw-accounts @destinations.json --sli-properties @sli-properties.json

Erforderliche Parameter

--mi-user-assigned --user-assigned

Legen Sie die vom Benutzer verwalteten Identitäten fest. Mindestens eine vom Benutzer zugewiesene verwaltete Identität ist erforderlich; Die vom System zugewiesene Identität wird von diesem Dienst nicht unterstützt. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Eigenschaft	Wert
Parametergruppe:	Identity Arguments

--service-group-name

Der Name der Dienstgruppe.

--sli-name

Der Name des SLI, der vom Benutzer angegeben wird.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--amw-accounts --destination-amw-accounts

Ziel-AMW-Konten. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

--baseline-properties

Definiert die SLO-Basislinie, die mit der SLI assoziiert ist. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

--category

Spezifiziert die Kategorie der SLI, die zur Klassifizierung von Signalen wie Verfügbarkeit und Latenz verwendet wird.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments
Zulässige Werte:	Availability, Latency

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--description

Eine vom Nutzer bereitgestellte Beschreibung des SLI mit einer maximalen Länge von 1000 Zeichen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

--enable-alert

Ein Flag, um zu bestimmen, ob Alarm aktiviert ist.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments
Zulässige Werte:	0, 1, f, false, n, no, t, true, y, yes

--evaluation-type

Bestimmt, wie die SLI ausgewertet wird – entweder basierend auf Anfragen oder Zeitfenstern.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments
Zulässige Werte:	RequestBased, WindowBased

--sli-properties

Definiert die SLI-Eigenschaften, die mit der SLI verbunden sind. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az monitor sli delete

Bearbeiten

Vorschau

Die Befehlsgruppe "az monitor sli" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen sie eine SLI-Ressource.

az monitor sli delete --service-group-name
                      --sli-name
                      [--acquire-policy-token]
                      [--change-reference]
                      [--yes]

Beispiele

Löschen Sie eine SLI ohne Bestätigungsaufforderung.

az monitor sli delete --service-group-name MyServiceGroup --sli-name MySli --yes

Erforderliche Parameter

--service-group-name

Der Name der Dienstgruppe.

--sli-name

Der Name des SLI, der vom Benutzer angegeben wird.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--yes -y

Nicht um Bestätigung bitten.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az monitor sli list

Bearbeiten

Vorschau

Die Befehlsgruppe 'az monitor sli' befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Alle SLI-Ressourcen unter einer übergeordneten Ressource auflisten.

az monitor sli list --service-group-name
                    [--max-items]
                    [--next-token]

Beispiele

Alle SLIs in einer Dienstgruppe auflisten.

az monitor sli list --service-group-name MyServiceGroup

Erforderliche Parameter

--service-group-name

Der Name der Dienstgruppe.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--max-items

Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert in --next-token Argument eines nachfolgenden Befehls an.

Eigenschaft	Wert
Parametergruppe:	Pagination Arguments

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

Eigenschaft	Wert
Parametergruppe:	Pagination Arguments

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az monitor sli show

Bearbeiten

Vorschau

Die Befehlsgruppe 'az monitor sli' befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Rufen Sie eine SLI-Ressource ab.

az monitor sli show --service-group-name
                    --sli-name

Beispiele

Zeigen Sie eine SLI anhand des Namens an.

az monitor sli show --service-group-name MyServiceGroup --sli-name MySli

Erforderliche Parameter

--service-group-name

Der Name der Dienstgruppe.

--sli-name

Der Name des SLI, der vom Benutzer angegeben wird.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az monitor sli update

Bearbeiten

Vorschau

Die Befehlsgruppe 'az monitor sli' befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren einer SLI-Ressource.

Änderungen der verwalteten Identität müssen auf alle drei Oberflächen in einem einzelnen PUT angewendet werden, da der Dienst die Set-Gleichheit für sie überprüft:

identity.userAssignedIdentities (ARM-Identitätswörterbuch der obersten Ebene).
properties.destinationAmwAccounts[].identity.
properties.sliProperties.{signals|goodSignals|totalSignals}.signalSources[].sourceAmwAccountManagedIdentity. Fensterbasierte SLIs füllen den signals Steckplatz auf; anforderungsbasierte SLIs füllen goodSignals und totalSignals. Führen Sie az monitor sli show zuerst die Ziel-/Signalquellenindizes und den verwendeten Steckplatz aus. In den folgenden Beispielen wird der fensterbasierte signals Steckplatz mit einer Ziel-AMW und einer Signalquelle vorausgesetzt. Hinweis: UAMI ARM-IDs enthalten . (z. B Microsoft.ManagedIdentity. ), sodass sie nicht als Pfadsegmente --set/--remove adressiert werden können (azure-cli teilt den Pfad auf .). Ersetzen Sie zum Ändern identity.userAssignedIdentitiesdie gesamte Zuordnung, indem Sie einen JSON-Wert übergeben, der in identity.userAssignedIdentities.

az monitor sli update --service-group-name
                      --sli-name
                      [--acquire-policy-token]
                      [--add]
                      [--amw-accounts --destination-amw-accounts]
                      [--baseline-properties]
                      [--category {Availability, Latency}]
                      [--change-reference]
                      [--description]
                      [--enable-alert {0, 1, f, false, n, no, t, true, y, yes}]
                      [--evaluation-type {RequestBased, WindowBased}]
                      [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                      [--remove]
                      [--set]
                      [--sli-properties]

Beispiele

Aktualisieren Sie die Beschreibung.

az monitor sli update --service-group-name MyServiceGroup --sli-name MySli --set properties.description="Updated API availability SLI"

Drehen Sie die verwaltete Quell-AMW-Identität (Signalquelle 0) in ein neues UAMI.

az monitor sli update --service-group-name MyServiceGroup --sli-name MySli --set 'identity.userAssignedIdentities={"<new-source-uami-arm-id>":{}}' --set 'properties.sliProperties.signals.signalSources[0].sourceAmwAccountManagedIdentity=<new-source-uami-arm-id>'

Drehen Sie die verwaltete Ziel-AMW-Identität (Ziel 0) in ein neues UAMI.

az monitor sli update --service-group-name MyServiceGroup --sli-name MySli --set 'identity.userAssignedIdentities={"<new-destination-uami-arm-id>":{}}' --set 'properties.destinationAmwAccounts[0].identity=<new-destination-uami-arm-id>'

Drehen Sie die verwalteten Quell-AMW- und Ziel-AMW-Identitäten in einem einzigen Update (einzelnes UAMI, das für beide verwendet wird).

az monitor sli update --service-group-name MyServiceGroup --sli-name MySli --set 'identity.userAssignedIdentities={"<new-uami-arm-id>":{}}' --set 'properties.destinationAmwAccounts[0].identity=<new-uami-arm-id>' --set 'properties.sliProperties.signals.signalSources[0].sourceAmwAccountManagedIdentity=<new-uami-arm-id>'

Erforderliche Parameter

--service-group-name

Der Name der Dienstgruppe.

--sli-name

Der Name des SLI, der vom Benutzer angegeben wird.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Eigenschaft	Wert
Parametergruppe:	Generic Update Arguments

--amw-accounts --destination-amw-accounts

Ziel-AMW-Konten. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

--baseline-properties

Definiert die SLO-Basislinie, die mit der SLI assoziiert ist. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

--category

Spezifiziert die Kategorie der SLI, die zur Klassifizierung von Signalen wie Verfügbarkeit und Latenz verwendet wird.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments
Zulässige Werte:	Availability, Latency

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--description

Eine vom Nutzer bereitgestellte Beschreibung des SLI mit einer maximalen Länge von 1000 Zeichen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

--enable-alert

Ein Flag, um zu bestimmen, ob Alarm aktiviert ist.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments
Zulässige Werte:	0, 1, f, false, n, no, t, true, y, yes

--evaluation-type

Bestimmt, wie die SLI ausgewertet wird – entweder basierend auf Anfragen oder Zeitfenstern.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments
Zulässige Werte:	RequestBased, WindowBased

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Eigenschaft	Wert
Parametergruppe:	Generic Update Arguments
Zulässige Werte:	0, 1, f, false, n, no, t, true, y, yes

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Eigenschaft	Wert
Parametergruppe:	Generic Update Arguments

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Eigenschaft	Wert
Parametergruppe:	Generic Update Arguments

--sli-properties

Definiert die SLI-Eigenschaften, die mit der SLI verbunden sind. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

Eigenschaft	Wert
Parametergruppe:	Properties Arguments

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?