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:
- Blocco di identità ARM (
identity.userAssignedIdentities). - Ogni AMW di destinazione (
properties.destinationAmwAccounts[].identity). - 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 singolaaz monitor sli updatechiamata in modo che PUT sia atomico. Vedereaz monitor sli update --helpper esempi di rotazione di lavoro. Eseguireaz monitor sli showprima di tutto per confermare gli indici effettivi e quale slot di segnale (signalsper basato su finestra,goodSignals+totalSignalsper 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
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
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 |
Nome del gruppo di servizi.
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.
Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
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 |
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 |
Specifica la categoria del SLI, utilizzata per classificare segnali come Disponibilità e Latenza.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Properties Arguments |
| Valori accettati: | Availability, Latency |
ID riferimento di modifica correlato per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
Una descrizione fornita dall'utente del SLI, con una lunghezza massima di 1000 caratteri.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Properties Arguments |
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 |
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 |
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
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az monitor sli delete
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
Nome del gruppo di servizi.
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.
Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
ID riferimento di modifica correlato per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
Non richiedere conferma.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az monitor sli list
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
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.
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 |
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
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az monitor sli show
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
Nome del gruppo di servizi.
Nome dell'SLI assegnato dall'utente.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az monitor sli update
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:
-
identity.userAssignedIdentities(dizionario delle identità ARM di primo livello). -
properties.destinationAmwAccounts[].identity. -
properties.sliProperties.{signals|goodSignals|totalSignals}.signalSources[].sourceAmwAccountManagedIdentity. I contratti di servizio basati su finestra popolano losignalsslot; i contratti di servizio basati su richiesta popolanogoodSignalsetotalSignals. Eseguireaz monitor sli showprima di tutto per confermare gli indici di destinazione/signal-source e quale slot è in uso. Gli esempi seguenti presuppongono lo slot basato susignalsfinestra con un AMW di destinazione e un'origine segnale. Nota: gli ID ARM UAMI contengono.(ad esempioMicrosoft.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 modificareidentity.userAssignedIdentities, sostituire l'intera mappa passando un valore JSON rooted inidentity.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
Nome del gruppo di servizi.
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.
Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
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 |
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 |
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 |
Specifica la categoria del SLI, utilizzata per classificare segnali come Disponibilità e Latenza.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Properties Arguments |
| Valori accettati: | Availability, Latency |
ID riferimento di modifica correlato per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
Una descrizione fornita dall'utente del SLI, con una lunghezza massima di 1000 caratteri.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Properties Arguments |
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 |
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 |
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 |
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 |
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 |
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
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |