az monitor app-insights web-test

Note

This reference is part of the application-insights extension for the Azure CLI (version 2.71.0 or higher). L’extension installe automatiquement la première fois que vous exécutez une az monitor app-insights web-test commande. Learn more about extensions.

Gérer le test web avec Application Insights.

Commandes

Nom	Description	Type	État
az monitor app-insights web-test create	Créez une définition de test web Application Insights.	Extension	GA
az monitor app-insights web-test delete	Supprimez un test web Application Insights.	Extension	GA
az monitor app-insights web-test list	Obtenez tous les tests web Application Insights définis pour le composant spécifié. Et obtenez tous les tests web Application Insights définis dans un groupe de ressources spécifié. Et obtenir toutes les définitions d’alertes de test web Application Insights au sein d’un abonnement.	Extension	GA
az monitor app-insights web-test show	Obtenir une définition de test web Application Insights spécifique.	Extension	GA
az monitor app-insights web-test update	Mettez à jour une définition de test web Application Insights.	Extension	GA

az monitor app-insights web-test create

Créez une définition de test web Application Insights.

az monitor app-insights web-test create --name --web-test-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 WebTest Application Insights.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriété	Valeur
Parameter group:	Validation Rules Arguments

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

Propriété	Valeur
Valeurs acceptées:	false, true

--expected-status-code

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

Propriété	Valeur
Parameter group:	Validation Rules Arguments

--follow-redirects

Suivez les redirections pour ce test web.

Propriété	Valeur
Parameter group:	Request Arguments
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.

Propriété	Valeur
Parameter group:	Request Arguments

--http-verb

Verbe Http à utiliser pour ce test web.

Propriété	Valeur
Parameter group:	Request Arguments

--ignore-status-code

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

Propriété	Valeur
Parameter group:	Validation Rules Arguments
Valeurs acceptées:	false, true

--kind

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

Propriété	Valeur
Valeurs acceptées:	multistep, ping

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de 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.

Propriété	Valeur
Parameter group:	Request Arguments
Valeurs acceptées:	false, true

--request-body

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

Propriété	Valeur
Parameter group:	Request Arguments

--request-url

Emplacement de l’URL à tester.

Propriété	Valeur
Parameter group:	Request Arguments

--retry-enabled

Autoriser les nouvelles tentatives si ce WebTest échoue.

Propriété	Valeur
Valeurs acceptées:	false, true

--ssl-check

Vérifie si le certificat SSL est toujours valide.

Propriété	Valeur
Parameter group:	Validation Rules Arguments
Valeurs acceptées:	false, true

--ssl-lifetime-check

Un certain nombre de jours à vérifier restent avant l’expiration du certificat SSL existant. La valeur doit être positive et sslCheck doit être définie sur true.

Propriété	Valeur
Parameter group:	Validation Rules Arguments

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

Propriété	Valeur
Parameter group:	Configuration Arguments

--web-test-kind

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

Propriété	Valeur
Valeurs acceptées:	multistep, ping, standard

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az monitor app-insights web-test delete

Supprimez un test web Application Insights.

az monitor app-insights web-test delete --name --web-test-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 WebTest Application Insights.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--yes -y

N’invitez pas à confirmer.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az monitor app-insights web-test list

Obtenez tous les tests web Application Insights définis pour le composant spécifié. Et obtenez tous les tests web Application Insights définis dans un groupe de ressources spécifié. Et obtenir toutes les définitions d’alertes de test web Application Insights 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--component-name

Nom de la ressource du composant Application Insights.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az monitor app-insights web-test show

Obtenir une définition de test web Application Insights spécifique.

az monitor app-insights web-test show --name --web-test-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 WebTest Application Insights.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az monitor app-insights web-test update

Mettez à jour une définition de test web Application Insights.

az monitor app-insights web-test update --name --web-test-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 WebTest Application Insights.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriété	Valeur
Parameter group:	Generic Update Arguments
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

Propriété	Valeur
Parameter group:	Validation Rules Arguments

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

Propriété	Valeur
Valeurs acceptées:	false, true

--expected-status-code

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

Propriété	Valeur
Parameter group:	Validation Rules Arguments

--follow-redirects

Suivez les redirections pour ce test web.

Propriété	Valeur
Parameter group:	Request Arguments
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.

Propriété	Valeur
Parameter group:	Generic Update Arguments
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.

Propriété	Valeur
Parameter group:	Request Arguments

--http-verb

Verbe Http à utiliser pour ce test web.

Propriété	Valeur
Parameter group:	Request Arguments

--ignore-status-code

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

Propriété	Valeur
Parameter group:	Validation Rules Arguments
Valeurs acceptées:	false, true

--kind

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

Propriété	Valeur
Valeurs acceptées:	multistep, ping

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de 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.

Propriété	Valeur
Parameter group:	Request Arguments
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.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

--request-body

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

Propriété	Valeur
Parameter group:	Request Arguments

--request-url

Emplacement de l’URL à tester.

Propriété	Valeur
Parameter group:	Request Arguments

--retry-enabled

Autoriser les nouvelles tentatives si ce WebTest échoue.

Propriété	Valeur
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>.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

--ssl-check

Vérifie si le certificat SSL est toujours valide.

Propriété	Valeur
Parameter group:	Validation Rules Arguments
Valeurs acceptées:	false, true

--ssl-lifetime-check

Un certain nombre de jours à vérifier restent avant l’expiration du certificat SSL existant. La valeur doit être positive et sslCheck doit être définie sur true.

Propriété	Valeur
Parameter group:	Validation Rules Arguments

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

Propriété	Valeur
Parameter group:	Configuration Arguments

--web-test-kind

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

Propriété	Valeur
Valeurs acceptées:	multistep, ping, standard

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

Partager via

az monitor app-insights web-test

Commandes

az monitor app-insights web-test create

Exemples

Paramètres obligatoires

Paramètres facultatifs

az monitor app-insights web-test delete

Exemples

Paramètres obligatoires

Paramètres facultatifs

az monitor app-insights web-test list

Exemples

Paramètres facultatifs

az monitor app-insights web-test show

Exemples

Paramètres obligatoires

az monitor app-insights web-test update

Exemples

Paramètres obligatoires

Paramètres facultatifs

Commentaires