Teilen über

az monitor app-insights web-test

  • Referenz

Hinweis

Diese Referenz ist Teil der Application-Insights-Erweiterung für die Azure CLI (Version 2.55.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az Monitor-Web-Insights-Webtestbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Webtest mit Anwendungserkenntnissen.

Befehle

Name Beschreibung Typ Status
az monitor app-insights web-test create

Erstellen Sie eine Application Insights-Webtestdefinition.

 Erweiterung Allgemein verfügbar
az monitor app-insights web-test delete

Löschen sie einen Application Insights-Webtest.

 Erweiterung Allgemein verfügbar
az monitor app-insights web-test list

Rufen Sie alle Application Insights-Webtests ab, die für die angegebene Komponente definiert sind. Und rufen Sie alle Application Insights-Webtests ab, die in einer angegebenen Ressourcengruppe definiert sind. Außerdem erhalten Sie alle Anwendungseinblick-Webtest-Warnungsdefinitionen innerhalb eines Abonnements.

 Erweiterung Allgemein verfügbar
az monitor app-insights web-test show

Rufen Sie eine bestimmte Application Insights-Webtestdefinition ab.

 Erweiterung Allgemein verfügbar
az monitor app-insights web-test update

Aktualisieren einer Application Insights-Webtestdefinition.

 Erweiterung Allgemein verfügbar

az monitor app-insights web-test create

Erstellen Sie eine Application Insights-Webtestdefinition.

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}]

Beispiele

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

Erforderliche Parameter

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

Der Name der Application Insights WebTest-Ressource.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--content-validation

Die Sammlung von Inhaltsüberprüfungseigenschaften.

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

content-match: Inhalt, nach dem gesucht werden soll, in der Rückgabe von WebTest. Darf nicht null oder leer sein. ignore-case: Wenn dieser Wert festgelegt wird, wird die Groß-/Kleinschreibung der ContentMatch-Überprüfung nicht beachtet. pass-if-text-found: Wenn wahr, wird die Überprüfung übergeben, wenn eine Übereinstimmung für die ContentMatch-Zeichenfolge vorhanden ist. Bei "false" schlägt die Überprüfung fehl, wenn eine Übereinstimmung vorhanden ist.

--defined-web-test-name

Benutzerdefinierter Name, wenn dieser WebTest.

--description

Benutzerdefinierte Beschreibung für diesen WebTest.

--enabled

Wird der Test aktiv überwacht.

Zulässige Werte: false, true
--expected-status-code

Überprüfen Sie, ob der WebTest den bereitgestellten HTTP-Statuscode zurückgibt.

--follow-redirects

Folgen Sie Umleitungen für diesen Webtest.

Zulässige Werte: false, true
--frequency

Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300.

--headers

Liste der Kopfzeilen und deren Werte, die dem WebTest-Aufruf hinzugefügt werden sollen.

Verwendung: --headers key=XX value=XX

key: Der Name der Kopfzeile. wert: Der Wert der Kopfzeile.

Mehrere Aktionen können mithilfe von mehr als einem Argument "-headers" angegeben werden.

--http-verb

Http-Verb, das für diesen Webtest verwendet werden soll.

--ignore-status-code

Bei Festlegung ignoriert die Überprüfung den Statuscode.

Zulässige Werte: false, true
--kind

Die Art von WebTest, die von diesem Webtest überwacht wird. Auswahlmöglichkeiten sind "Ping" und "Multisteps".

Zulässige Werte: multistep, ping
--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--locations

Eine Liste, in der die Tests physisch ausgeführt werden sollen, um eine globale Abdeckung für die Barrierefreiheit Ihrer Anwendung zu ermöglichen.

Verwendung: --locations ID=XX

ID: Standort-ID für webTest, von der aus ausgeführt werden soll.

Mehrere Aktionen können mithilfe von mehr als einem --locations-Argument angegeben werden.

--parse-requests

Analysieren der abhängigen Anforderung für diesen WebTest.

Zulässige Werte: false, true
--request-body

Base64-codierter Zeichenfolgentext, der mit diesem Webtest gesendet werden soll.

--request-url

Url-Speicherort, der getestet werden soll.

--retry-enabled

Fehler beim Zulassen von Wiederholungen, wenn dieser WebTest fehlschlägt.

Zulässige Werte: false, true
--ssl-check

Überprüft, ob das SSL-Zertifikat noch gültig ist.

Zulässige Werte: false, true
--ssl-lifetime-check

Eine Anzahl von Tagen, die noch einmal überprüft werden sollen Standard bevor das vorhandene SSL-Zertifikat abläuft. Der Wert muss positiv sein, und der SSLCheck muss auf "true" festgelegt werden.

--synthetic-monitor-id

Eindeutige ID dieses WebTest. Dies ist in der Regel derselbe Wert wie das Feld "Name".

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--timeout

Sekunden, bis dieser WebTest timeout und fehlschlägt. Standardwert: 30.

--web-test

Die XML-Spezifikation eines WebTest-Elements, das für eine Anwendung ausgeführt werden soll.

--web-test-kind

Dies ist die Art des Webtests, die gültige Auswahlmöglichkeiten sind Ping, Multisteps und Standard.

Zulässige Werte: multistep, ping, standard
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor app-insights web-test delete

Löschen sie einen Application Insights-Webtest.

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

Beispiele

webTestDelete

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

Erforderliche Parameter

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

Der Name der Application Insights WebTest-Ressource.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor app-insights web-test list

Rufen Sie alle Application Insights-Webtests ab, die für die angegebene Komponente definiert sind. Und rufen Sie alle Application Insights-Webtests ab, die in einer angegebenen Ressourcengruppe definiert sind. Außerdem erhalten Sie alle Anwendungseinblick-Webtest-Warnungsdefinitionen innerhalb eines Abonnements.

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

Beispiele

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

Optionale Parameter

--component-name

Der Name der Application Insights-Komponentenressource.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor app-insights web-test show

Rufen Sie eine bestimmte Application Insights-Webtestdefinition ab.

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

Beispiele

webTestGet

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

Erforderliche Parameter

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

Der Name der Application Insights WebTest-Ressource.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az monitor app-insights web-test update

Aktualisieren einer Application Insights-Webtestdefinition.

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}]

Beispiele

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"

Erforderliche Parameter

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

Der Name der Application Insights WebTest-Ressource.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

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

Standardwert: []
--content-validation

Die Sammlung von Inhaltsüberprüfungseigenschaften.

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

content-match: Inhalt, nach dem gesucht werden soll, in der Rückgabe von WebTest. Darf nicht null oder leer sein. ignore-case: Wenn dieser Wert festgelegt wird, wird die Groß-/Kleinschreibung der ContentMatch-Überprüfung nicht beachtet. pass-if-text-found: Wenn wahr, wird die Überprüfung übergeben, wenn eine Übereinstimmung für die ContentMatch-Zeichenfolge vorhanden ist. Bei "false" schlägt die Überprüfung fehl, wenn eine Übereinstimmung vorhanden ist.

--defined-web-test-name

Benutzerdefinierter Name, wenn dieser WebTest.

--description

Benutzerdefinierte Beschreibung für diesen WebTest.

--enabled

Wird der Test aktiv überwacht.

Zulässige Werte: false, true
--expected-status-code

Überprüfen Sie, ob der WebTest den bereitgestellten HTTP-Statuscode zurückgibt.

--follow-redirects

Folgen Sie Umleitungen für diesen Webtest.

Zulässige Werte: false, true
--force-string

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

Standardwert: False
--frequency

Intervall in Sekunden zwischen Testläufen für diesen WebTest. Der Standardwert ist 300.

--headers

Liste der Kopfzeilen und deren Werte, die dem WebTest-Aufruf hinzugefügt werden sollen.

Verwendung: --headers key=XX value=XX

key: Der Name der Kopfzeile. wert: Der Wert der Kopfzeile.

Mehrere Aktionen können mithilfe von mehr als einem Argument "-headers" angegeben werden.

--http-verb

Http-Verb, das für diesen Webtest verwendet werden soll.

--ignore-status-code

Bei Festlegung ignoriert die Überprüfung den Statuscode.

Zulässige Werte: false, true
--kind

Die Art von WebTest, die von diesem Webtest überwacht wird. Auswahlmöglichkeiten sind "Ping" und "Multisteps".

Zulässige Werte: multistep, ping
--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--locations

Eine Liste, in der die Tests physisch ausgeführt werden sollen, um eine globale Abdeckung für die Barrierefreiheit Ihrer Anwendung zu ermöglichen.

Verwendung: --locations ID=XX

ID: Standort-ID für webTest, von der aus ausgeführt werden soll.

Mehrere Aktionen können mithilfe von mehr als einem --locations-Argument angegeben werden.

--parse-requests

Analysieren der abhängigen Anforderung für diesen WebTest.

Zulässige Werte: false, true
--remove

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

Standardwert: []
--request-body

Base64-codierter Zeichenfolgentext, der mit diesem Webtest gesendet werden soll.

--request-url

Url-Speicherort, der getestet werden soll.

--retry-enabled

Fehler beim Zulassen von Wiederholungen, wenn dieser WebTest fehlschlägt.

Zulässige Werte: false, true
--set

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

Standardwert: []
--ssl-check

Überprüft, ob das SSL-Zertifikat noch gültig ist.

Zulässige Werte: false, true
--ssl-lifetime-check

Eine Anzahl von Tagen, die noch einmal überprüft werden sollen Standard bevor das vorhandene SSL-Zertifikat abläuft. Der Wert muss positiv sein, und der SSLCheck muss auf "true" festgelegt werden.

--synthetic-monitor-id

Eindeutige ID dieses WebTest. Dies ist in der Regel derselbe Wert wie das Feld "Name".

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--timeout

Sekunden, bis dieser WebTest timeout und fehlschlägt. Standardwert: 30.

--web-test

Die XML-Spezifikation eines WebTest-Elements, das für eine Anwendung ausgeführt werden soll.

--web-test-kind

Dies ist die Art des Webtests, die gültige Auswahlmöglichkeiten sind Ping, Multisteps und Standard.

Zulässige Werte: multistep, ping, standard
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.