Condividi tramite

az monitor app-insights web-test

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione application-insights per l'interfaccia della riga di comando di Azure (versione 2.55.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az monitor app-insights web-test . Altre informazioni sulle estensioni.

Gestire il test Web con Application Insights.

Comandi

Nome Descrizione Tipo Stato
az monitor app-insights web-test create

Creare una definizione di test Web di Application Insights.

 Estensione Disponibilità generale
az monitor app-insights web-test delete

Eliminare un test Web di Application Insights.

 Estensione Disponibilità generale
az monitor app-insights web-test list

Ottenere tutti i test Web di Application Insights definiti per il componente specificato. E Ottenere tutti i test Web di Application Insights definiti all'interno di un gruppo di risorse specificato. E ottenere tutte le definizioni di avvisi di test Web di Application Insights all'interno di una sottoscrizione.

 Estensione Disponibilità generale
az monitor app-insights web-test show

Ottenere una definizione specifica di test Web di Application Insights.

 Estensione Disponibilità generale
az monitor app-insights web-test update

Aggiornare una definizione di test Web di Application Insights.

 Estensione Disponibilità generale

az monitor app-insights web-test create

Creare una definizione di test Web di Application Insights.

az monitor app-insights web-test create --name
                                        --resource-group
                                        [--content-validation]
                                        [--defined-web-test-name]
                                        [--description]
                                        [--enabled {false, true}]
                                        [--expected-status-code]
                                        [--follow-redirects {false, true}]
                                        [--frequency]
                                        [--headers]
                                        [--http-verb]
                                        [--ignore-status-code {false, true}]
                                        [--kind {multistep, ping}]
                                        [--location]
                                        [--locations]
                                        [--parse-requests {false, true}]
                                        [--request-body]
                                        [--request-url]
                                        [--retry-enabled {false, true}]
                                        [--ssl-check {false, true}]
                                        [--ssl-lifetime-check]
                                        [--synthetic-monitor-id]
                                        [--tags]
                                        [--timeout]
                                        [--web-test]
                                        [--web-test-kind {multistep, ping, standard}]

Esempio

webTestCreate

az monitor app-insights web-test create --kind "ping" --location "South Central US" --web-test "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>" --description "Ping web test alert for mytestwebapp" --enabled true --frequency 900 --web-test-kind "ping" --locations Id="us-fl-mia-edge" --defined-web-test-name "my-webtest-my-component" --retry-enabled true --synthetic-monitor-id "my-webtest-my-component" --timeout 120 --resource-group "my-resource-group" --name "my-webtest-my-component" --tags hidden-link:XX=XX

webTestCreateStandard

az monitor app-insights web-test create --location "South Central US" --description "Ping web test alert for mytestwebapp" --enabled true --frequency 900 --web-test-kind "standard" --locations Id="us-fl-mia-edge" --defined-web-test-name "my-webtest-my-component" --http-verb "POST" --request-body "SGVsbG8gd29ybGQ=" --request-url "https://bing.com" --retry-enabled true --synthetic-monitor-id "my-webtest-my-component" --timeout 120 --ssl-lifetime-check 100 --ssl-check true --resource-group "my-resource-group" --name "my-webtest-my-component" --tags hidden-link:XX=XX

Parametri necessari

--name --web-test-name -n

Nome della risorsa WebTest di Application Insights.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--content-validation

Raccolta di proprietà di convalida del contenuto.

Utilizzo: --content-validation content-match=XX ignore-case=XX pass-if-text-found=XX

content-match: contenuto da cercare nella restituzione di WebTest. Non deve essere null o vuoto. ignore-case: se impostato, questo valore rende senza distinzione tra maiuscole e minuscole la convalida ContentMatch. pass-if-text-found: se true, la convalida passerà se esiste una corrispondenza per la stringa ContentMatch. Se false, la convalida avrà esito negativo se esiste una corrispondenza.

--defined-web-test-name

Nome definito dall'utente se il test Web.

--description

Descrizione definita dall'utente per questo test Web.

--enabled

Il test viene monitorato attivamente.

valori accettati: false, true
--expected-status-code

Verificare che WebTest restituisca il codice di stato http fornito.

--follow-redirects

Seguire i reindirizzamenti per questo test Web.

valori accettati: false, true
--frequency

Intervallo in secondi tra le esecuzioni dei test per questo test Web. Il valore predefinito è 300.

--headers

Elenco di intestazioni e relativi valori da aggiungere alla chiamata WebTest.

Utilizzo: --headers key=XX value=XX

key: nome dell'intestazione. value: valore dell'intestazione.

È possibile specificare più azioni usando più di un argomento --headers.

--http-verb

Verbo HTTP da usare per questo test Web.

--ignore-status-code

Se impostata, la convalida ignorerà il codice di stato.

valori accettati: false, true
--kind

Tipo di test Web guardato da questo test Web. Le scelte sono ping e passaggi diversi.

valori accettati: multistep, ping
--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--locations

Elenco di dove eseguire fisicamente i test da per fornire una copertura globale per l'accessibilità dell'applicazione.

Utilizzo: --locations Id=XX

ID: ID percorso da cui eseguire WebTest.

È possibile specificare più azioni usando più di un argomento --locations.

--parse-requests

Analizzare la richiesta dipendente per questo test Web.

valori accettati: false, true
--request-body

Corpo della stringa con codifica Base64 da inviare con questo test Web.

--request-url

Percorso URL da testare.

--retry-enabled

Consentire la ripetizione dei tentativi in caso di esito negativo del test Web.

valori accettati: false, true
--ssl-check

Verifica se il certificato SSL è ancora valido.

valori accettati: false, true
--ssl-lifetime-check

Un numero di giorni per il controllo rimane ancora prima della scadenza del certificato SSL esistente. Il valore deve essere positivo e SSLCheck deve essere impostato su true.

--synthetic-monitor-id

ID univoco di questo test Web. Si tratta in genere dello stesso valore del campo Nome.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--timeout

Secondi fino a quando il test Web non verrà timeout e avrà esito negativo. Il valore predefinito è 30.

--web-test

Specifica XML di un webTest da eseguire su un'applicazione.

--web-test-kind

Il tipo di test Web è, le scelte valide sono ping, multistep e standard.

valori accettati: multistep, ping, standard
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az monitor app-insights web-test delete

Eliminare un test Web di Application Insights.

az monitor app-insights web-test delete --name
                                        --resource-group
                                        [--yes]

Esempio

webTestDelete

az monitor app-insights web-test delete --resource-group "my-resource-group" --name "my-webtest-01-mywebservice"

Parametri necessari

--name --web-test-name -n

Nome della risorsa WebTest di Application Insights.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az monitor app-insights web-test list

Ottenere tutti i test Web di Application Insights definiti per il componente specificato. E Ottenere tutti i test Web di Application Insights definiti all'interno di un gruppo di risorse specificato. E ottenere tutte le definizioni di avvisi di test Web di Application Insights all'interno di una sottoscrizione.

az monitor app-insights web-test list [--component-name]
                                      [--resource-group]

Esempio

webTestListByComponent

az monitor app-insights web-test list --component-name "my-component" --resource-group "my-resource-group"

webTestListByResourceGroup

az monitor app-insights web-test list --resource-group "my-resource-group"

webTestList

az monitor app-insights web-test list

Parametri facoltativi

--component-name

Nome della risorsa componente di Application Insights.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az monitor app-insights web-test show

Ottenere una definizione specifica di test Web di Application Insights.

az monitor app-insights web-test show --name
                                      --resource-group

Esempio

webTestGet

az monitor app-insights web-test show --resource-group "my-resource-group" --name "my-webtest-01-mywebservice"

Parametri necessari

--name --web-test-name -n

Nome della risorsa WebTest di Application Insights.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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

az monitor app-insights web-test update

Aggiornare una definizione di test Web di Application Insights.

az monitor app-insights web-test update --name
                                        --resource-group
                                        [--add]
                                        [--content-validation]
                                        [--defined-web-test-name]
                                        [--description]
                                        [--enabled {false, true}]
                                        [--expected-status-code]
                                        [--follow-redirects {false, true}]
                                        [--force-string]
                                        [--frequency]
                                        [--headers]
                                        [--http-verb]
                                        [--ignore-status-code {false, true}]
                                        [--kind {multistep, ping}]
                                        [--location]
                                        [--locations]
                                        [--parse-requests {false, true}]
                                        [--remove]
                                        [--request-body]
                                        [--request-url]
                                        [--retry-enabled {false, true}]
                                        [--set]
                                        [--ssl-check {false, true}]
                                        [--ssl-lifetime-check]
                                        [--synthetic-monitor-id]
                                        [--tags]
                                        [--timeout]
                                        [--web-test]
                                        [--web-test-kind {multistep, ping, standard}]

Esempio

webTestUpdate

az monitor app-insights web-test update --kind "ping" --location "South Central US" --web-test "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"30\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>" --frequency 600 --web-test-kind "ping" --locations Id="us-fl-mia-edge" --locations Id="apac-hk-hkn-azr" --defined-web-test-name "my-webtest-my-component" --synthetic-monitor-id "my-webtest-my-component" --timeout 30 --resource-group "my-resource-group" --name "my-webtest-my-component"

Parametri necessari

--name --web-test-name -n

Nome della risorsa WebTest di Application Insights.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

valore predefinito: []
--content-validation

Raccolta di proprietà di convalida del contenuto.

Utilizzo: --content-validation content-match=XX ignore-case=XX pass-if-text-found=XX

content-match: contenuto da cercare nella restituzione di WebTest. Non deve essere null o vuoto. ignore-case: se impostato, questo valore rende senza distinzione tra maiuscole e minuscole la convalida ContentMatch. pass-if-text-found: se true, la convalida passerà se esiste una corrispondenza per la stringa ContentMatch. Se false, la convalida avrà esito negativo se esiste una corrispondenza.

--defined-web-test-name

Nome definito dall'utente se il test Web.

--description

Descrizione definita dall'utente per questo test Web.

--enabled

Il test viene monitorato attivamente.

valori accettati: false, true
--expected-status-code

Verificare che WebTest restituisca il codice di stato http fornito.

--follow-redirects

Seguire i reindirizzamenti per questo test Web.

valori accettati: false, true
--force-string

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

valore predefinito: False
--frequency

Intervallo in secondi tra le esecuzioni dei test per questo test Web. Il valore predefinito è 300.

--headers

Elenco di intestazioni e relativi valori da aggiungere alla chiamata WebTest.

Utilizzo: --headers key=XX value=XX

key: nome dell'intestazione. value: valore dell'intestazione.

È possibile specificare più azioni usando più di un argomento --headers.

--http-verb

Verbo HTTP da usare per questo test Web.

--ignore-status-code

Se impostata, la convalida ignorerà il codice di stato.

valori accettati: false, true
--kind

Tipo di test Web guardato da questo test Web. Le scelte sono ping e passaggi diversi.

valori accettati: multistep, ping
--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--locations

Elenco di dove eseguire fisicamente i test da per fornire una copertura globale per l'accessibilità dell'applicazione.

Utilizzo: --locations Id=XX

ID: ID percorso da cui eseguire WebTest.

È possibile specificare più azioni usando più di un argomento --locations.

--parse-requests

Analizzare la richiesta dipendente per questo test Web.

valori accettati: false, true
--remove

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

valore predefinito: []
--request-body

Corpo della stringa con codifica Base64 da inviare con questo test Web.

--request-url

Percorso URL da testare.

--retry-enabled

Consentire la ripetizione dei tentativi in caso di esito negativo del test Web.

valori accettati: false, true
--set

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

valore predefinito: []
--ssl-check

Verifica se il certificato SSL è ancora valido.

valori accettati: false, true
--ssl-lifetime-check

Un numero di giorni per il controllo rimane ancora prima della scadenza del certificato SSL esistente. Il valore deve essere positivo e SSLCheck deve essere impostato su true.

--synthetic-monitor-id

ID univoco di questo test Web. Si tratta in genere dello stesso valore del campo Nome.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--timeout

Secondi fino a quando il test Web non verrà timeout e avrà esito negativo. Il valore predefinito è 30.

--web-test

Specifica XML di un webTest da eseguire su un'applicazione.

--web-test-kind

Il tipo di test Web è, le scelte valide sono ping, multistep e standard.

valori accettati: multistep, ping, standard
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--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

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