az monitor app-insights web-test

  • Référence

Remarque

Cette référence fait partie de l’extension Application-Insights pour Azure CLI (version 2.55.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az monitor app-insights web-test . En savoir plus sur les extensions.

Gérer le test web avec Application Insights.

Commandes

Nom Description Type Statut
az monitor app-insights web-test create

Créez une définition de test web Recommandations application.

 Extension GA
az monitor app-insights web-test delete

Supprimez un test web Recommandations application.

 Extension GA
az monitor app-insights web-test list

Obtenez tous les tests web d’application Recommandations définis pour le composant spécifié. Obtenez tous les tests web d’application Recommandations définis dans un groupe de ressources spécifié. Et obtenez toutes les définitions d’alertes de test web Recommandations application au sein d’un abonnement.

 Extension GA
az monitor app-insights web-test show

Obtenez une définition de test web Recommandations application spécifique.

 Extension GA
az monitor app-insights web-test update

Mettez à jour une définition de test web Recommandations application.

 Extension GA

az monitor app-insights web-test create

Créez une définition de test web Recommandations application.

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

Exemples

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

Paramètres obligatoires

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

Nom de la ressource Application Recommandations WebTest.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--content-validation

Collection de propriétés de validation de contenu.

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

content-match : contenu à rechercher dans le retour du WebTest. Ne doit pas être null ou vide. ignore-case : quand elle est définie, cette valeur rend la casse de validation ContentMatch insensible. pass-if-text-found : Lorsque la valeur est true, la validation passe s’il existe une correspondance pour la chaîne ContentMatch. Si la valeur est false, la validation échoue en cas de correspondance.

--defined-web-test-name

Nom défini par l’utilisateur si ce WebTest.

--description

Description définie par l’utilisateur pour ce WebTest.

--enabled

Le test est-il activement surveillé.

valeurs acceptées: false, true
--expected-status-code

Vérifiez que WebTest retourne le code d’état http fourni.

--follow-redirects

Suivez les redirections pour ce test web.

valeurs acceptées: false, true
--frequency

Intervalle en secondes entre les exécutions de test pour ce WebTest. La valeur par défaut est 300.

--headers

Liste des en-têtes et de leurs valeurs à ajouter à l’appel WebTest.

Utilisation : --headers key=XX value=XX

clé : nom de l’en-tête. valeur : valeur de l’en-tête.

Plusieurs actions peuvent être spécifiées à l’aide de plusieurs arguments --headers.

--http-verb

Verbe Http à utiliser pour ce test web.

--ignore-status-code

Quand elle est définie, la validation ignore le code d’état.

valeurs acceptées: false, true
--kind

Type de WebTest que ce test web surveille. Les choix sont ping et multistep.

valeurs acceptées: multistep, ping
--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--locations

Liste des emplacements où exécuter physiquement les tests afin de fournir une couverture globale pour l’accessibilité de votre application.

Utilisation : --locations Id=XX

ID : ID d’emplacement du WebTest à exécuter.

Plusieurs actions peuvent être spécifiées à l’aide de plusieurs arguments --locations.

--parse-requests

Analyser la demande dépendante pour ce WebTest.

valeurs acceptées: false, true
--request-body

Corps de chaîne encodé en base64 à envoyer avec ce test web.

--request-url

Emplacement de l’URL à tester.

--retry-enabled

Autoriser les nouvelles tentatives si ce WebTest échoue.

valeurs acceptées: false, true
--ssl-check

Vérifie si le certificat SSL est toujours valide.

valeurs acceptées: false, true
--ssl-lifetime-check

Un certain nombre de jours pour case activée restent encore avant l’expiration du certificat SSL existant. La valeur doit être positive et sslCheck doit être définie sur true.

--synthetic-monitor-id

ID unique de ce WebTest. Il s’agit généralement de la même valeur que le champ Nom.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--timeout

Secondes jusqu’à ce que ce WebTest arrive à expiration et échoue. La valeur par défaut est 30.

--web-test

Spécification XML d’un WebTest à exécuter sur une application.

--web-test-kind

Le type de test web, c’est-à-dire, les choix valides sont ping, multistep et standard.

valeurs acceptées: multistep, ping, standard
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor app-insights web-test delete

Supprimez un test web Recommandations application.

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

Exemples

webTestDelete

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

Paramètres obligatoires

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

Nom de la ressource Application Recommandations WebTest.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor app-insights web-test list

Obtenez tous les tests web d’application Recommandations définis pour le composant spécifié. Obtenez tous les tests web d’application Recommandations définis dans un groupe de ressources spécifié. Et obtenez toutes les définitions d’alertes de test web Recommandations application au sein d’un abonnement.

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

Exemples

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

Paramètres facultatifs

--component-name

Nom de la ressource de composant Application Recommandations.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor app-insights web-test show

Obtenez une définition de test web Recommandations application spécifique.

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

Exemples

webTestGet

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

Paramètres obligatoires

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

Nom de la ressource Application Recommandations WebTest.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az monitor app-insights web-test update

Mettez à jour une définition de test web Recommandations application.

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

Exemples

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"

Paramètres obligatoires

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

Nom de la ressource Application Recommandations WebTest.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

valeur par défaut: []
--content-validation

Collection de propriétés de validation de contenu.

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

content-match : contenu à rechercher dans le retour du WebTest. Ne doit pas être null ou vide. ignore-case : quand elle est définie, cette valeur rend la casse de validation ContentMatch insensible. pass-if-text-found : Lorsque la valeur est true, la validation passe s’il existe une correspondance pour la chaîne ContentMatch. Si la valeur est false, la validation échoue en cas de correspondance.

--defined-web-test-name

Nom défini par l’utilisateur si ce WebTest.

--description

Description définie par l’utilisateur pour ce WebTest.

--enabled

Le test est-il activement surveillé.

valeurs acceptées: false, true
--expected-status-code

Vérifiez que WebTest retourne le code d’état http fourni.

--follow-redirects

Suivez les redirections pour ce test web.

valeurs acceptées: false, true
--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False
--frequency

Intervalle en secondes entre les exécutions de test pour ce WebTest. La valeur par défaut est 300.

--headers

Liste des en-têtes et de leurs valeurs à ajouter à l’appel WebTest.

Utilisation : --headers key=XX value=XX

clé : nom de l’en-tête. valeur : valeur de l’en-tête.

Plusieurs actions peuvent être spécifiées à l’aide de plusieurs arguments --headers.

--http-verb

Verbe Http à utiliser pour ce test web.

--ignore-status-code

Quand elle est définie, la validation ignore le code d’état.

valeurs acceptées: false, true
--kind

Type de WebTest que ce test web surveille. Les choix sont ping et multistep.

valeurs acceptées: multistep, ping
--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--locations

Liste des emplacements où exécuter physiquement les tests afin de fournir une couverture globale pour l’accessibilité de votre application.

Utilisation : --locations Id=XX

ID : ID d’emplacement du WebTest à exécuter.

Plusieurs actions peuvent être spécifiées à l’aide de plusieurs arguments --locations.

--parse-requests

Analyser la demande dépendante pour ce WebTest.

valeurs acceptées: false, true
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

valeur par défaut: []
--request-body

Corps de chaîne encodé en base64 à envoyer avec ce test web.

--request-url

Emplacement de l’URL à tester.

--retry-enabled

Autoriser les nouvelles tentatives si ce WebTest échoue.

valeurs acceptées: false, true
--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

valeur par défaut: []
--ssl-check

Vérifie si le certificat SSL est toujours valide.

valeurs acceptées: false, true
--ssl-lifetime-check

Un certain nombre de jours pour case activée restent encore avant l’expiration du certificat SSL existant. La valeur doit être positive et sslCheck doit être définie sur true.

--synthetic-monitor-id

ID unique de ce WebTest. Il s’agit généralement de la même valeur que le champ Nom.

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--timeout

Secondes jusqu’à ce que ce WebTest arrive à expiration et échoue. La valeur par défaut est 30.

--web-test

Spécification XML d’un WebTest à exécuter sur une application.

--web-test-kind

Le type de test web, c’est-à-dire, les choix valides sont ping, multistep et standard.

valeurs acceptées: multistep, ping, standard
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.