az monitor sli

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire gli indicatori del livello di servizio in Monitoraggio di Azure.

Modello di identità: i contratti di servizio supportano solo le identità gestite assegnate dall'utente (UAMIs). L'identità assegnata dal sistema non è supportata dal servizio. È necessario fare riferimento a un oggetto UAMI in tre posizioni che il servizio mantiene sincronizzato:

  1. Blocco di identità ARM (identity.userAssignedIdentities).
  2. Ogni AMW di destinazione (properties.destinationAmwAccounts[].identity).
  3. Ogni origine segnale (properties.sliProperties.{signals|goodSignals| totalSignals}.signalSources[].sourceAmwAccountManagedIdentity). Il servizio rifiuta le put in cui questi tre set non sono d'accordo. Per ruotare un UAMI, aggiornare tutte e tre le superfici in una singola az monitor sli update chiamata in modo che PUT sia atomico. Vedere az monitor sli update --help per esempi di rotazione di lavoro. Eseguire az monitor sli show prima di tutto per confermare gli indici effettivi e quale slot di segnale (signals per basato su finestra, goodSignals + totalSignals per basato su richiesta) viene popolato.

Comandi

Nome Descrizione Tipo Status
az monitor sli create

Creare una risorsa SLI.

Core Anteprima
az monitor sli delete

Eliminare una risorsa SLI.

Core Anteprima
az monitor sli list

Elencare tutte le risorse SLI in una risorsa padre.

Core Anteprima
az monitor sli show

Ottenere una risorsa SLI.

Core Anteprima
az monitor sli update

Aggiornare una risorsa SLI.

Core Anteprima

az monitor sli create

Anteprima

Il gruppo di comandi 'az monitor sli' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare una risorsa SLI.

È necessaria un'identità gestita assegnata dall'utente e deve corrispondere all'identità a cui fa riferimento ogni account AMW di destinazione e a ogni origine segnale. Gli argomenti degli oggetti complessi (--baseline-properties, --destination-amw-accounts, --sli-properties) sono più semplici da passare tramite file JSON usando la @filename.json sintassi .

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]

Esempio

Creare un SLI di disponibilità basato su finestra dai file di payload JSON.

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

Parametri necessari

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

Impostare le identità gestite dall'utente. È necessaria almeno un'identità gestita assegnata dall'utente; l'identità assegnata dal sistema non è supportata da questo servizio. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Identity Arguments
--service-group-name

Nome del gruppo di servizi.

--sli-name

Nome dell'SLI assegnato dall'utente.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--amw-accounts --destination-amw-accounts

Account AMW di destinazione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--baseline-properties

Definisce la linea di base SLO associata al SLI. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--category

Specifica la categoria del SLI, utilizzata per classificare segnali come Disponibilità e Latenza.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: Availability, Latency
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--description

Una descrizione fornita dall'utente del SLI, con una lunghezza massima di 1000 caratteri.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--enable-alert

Un flag per determinare se l'allerta è attivata.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-type

Determina come viene valutato il SLI—sia in base al numero di richieste sia a finestre temporali.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: RequestBased, WindowBased
--sli-properties

Definisce le proprietà SLI associate al SLI. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az monitor sli delete

Anteprima

Il gruppo di comandi 'az monitor sli' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare una risorsa SLI.

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

Esempio

Eliminare un SLI senza una richiesta di conferma.

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

Parametri necessari

--service-group-name

Nome del gruppo di servizi.

--sli-name

Nome dell'SLI assegnato dall'utente.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az monitor sli list

Anteprima

Il gruppo di comandi 'az monitor sli' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare tutte le risorse SLI in una risorsa padre.

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

Esempio

Elencare tutti i contratti di servizio in un gruppo di servizi.

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

Parametri necessari

--service-group-name

Nome del gruppo di servizi.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token in --next-token argomento di un comando successivo.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az monitor sli show

Anteprima

Il gruppo di comandi 'az monitor sli' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere una risorsa SLI.

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

Esempio

Visualizzare un SLI in base al nome.

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

Parametri necessari

--service-group-name

Nome del gruppo di servizi.

--sli-name

Nome dell'SLI assegnato dall'utente.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az monitor sli update

Anteprima

Il gruppo di comandi 'az monitor sli' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare una risorsa SLI.

Le modifiche dell'identità gestita devono essere applicate a tutte e tre le superfici in un unico PUT, perché il servizio convalida l'uguaglianza dei set tra di esse:

  1. identity.userAssignedIdentities (dizionario delle identità ARM di primo livello).
  2. properties.destinationAmwAccounts[].identity.
  3. properties.sliProperties.{signals|goodSignals|totalSignals}.signalSources[].sourceAmwAccountManagedIdentity. I contratti di servizio basati su finestra popolano lo signals slot; i contratti di servizio basati su richiesta popolano goodSignals e totalSignals. Eseguire az monitor sli show prima di tutto per confermare gli indici di destinazione/signal-source e quale slot è in uso. Gli esempi seguenti presuppongono lo slot basato su signals finestra con un AMW di destinazione e un'origine segnale. Nota: gli ID ARM UAMI contengono . (ad esempio Microsoft.ManagedIdentity), quindi non possono essere indirizzati come segmenti di percorso da --set/--remove (l'interfaccia della riga di comando di Azure divide il percorso in .). Per modificare identity.userAssignedIdentities, sostituire l'intera mappa passando un valore JSON rooted 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]

Esempio

Aggiornare la descrizione.

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

Ruotare l'identità gestita di origine-AMW (origine segnale 0) in un nuovo 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>'

Ruotare l'identità gestita di destinazione-AMW (destinazione 0) in un nuovo 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>'

Ruotare le identità gestite source-AMW e destination-AMW in un singolo aggiornamento (singolo UAMI usato per entrambi).

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>'

Parametri necessari

--service-group-name

Nome del gruppo di servizi.

--sli-name

Nome dell'SLI assegnato dall'utente.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
--amw-accounts --destination-amw-accounts

Account AMW di destinazione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--baseline-properties

Definisce la linea di base SLO associata al SLI. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--category

Specifica la categoria del SLI, utilizzata per classificare segnali come Disponibilità e Latenza.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: Availability, Latency
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--description

Una descrizione fornita dall'utente del SLI, con una lunghezza massima di 1000 caratteri.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--enable-alert

Un flag per determinare se l'allerta è attivata.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--evaluation-type

Determina come viene valutato il SLI—sia in base al numero di richieste sia a finestre temporali.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: RequestBased, WindowBased
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
--sli-properties

Definisce le proprietà SLI associate al SLI. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False