az monitor app-insights web-test

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de Application Insights-extensie voor de Azure CLI (versie 2.55.0 of hoger). De extensie installeert automatisch de eerste keer dat u een opdracht az monitor app-insights web-test uitvoert. Meer informatie over extensies.

Webtest beheren met Application Insights.

Opdracht

Name Description Type Status
az monitor app-insights web-test create

Maak een Application Insights-webtestdefinitie.

 Toestel GA
az monitor app-insights web-test delete

Een Application Insights-webtest verwijderen.

 Toestel GA
az monitor app-insights web-test list

Haal alle Application Insights-webtests op die zijn gedefinieerd voor het opgegeven onderdeel. En haal alle Application Insights-webtests op die zijn gedefinieerd binnen een opgegeven resourcegroep. En haal alle Application Insights-webtestwaarschuwingen op binnen een abonnement.

 Toestel GA
az monitor app-insights web-test show

Een specifieke Application Insights-webtestdefinitie ophalen.

 Toestel GA
az monitor app-insights web-test update

Een Application Insights-webtestdefinitie bijwerken.

 Toestel GA

az monitor app-insights web-test create

Maak een Application Insights-webtestdefinitie.

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

Voorbeelden

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

Vereiste parameters

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

De naam van de Application Insights WebTest-resource.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--content-validation

De verzameling eigenschappen van inhoudsvalidatie.

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

inhoudsovereenkomst: Inhoud die moet worden gezocht in de return van de WebTest. Mag niet null of leeg zijn. ignore-case: wanneer deze waarde is ingesteld, is de validatiecase contentmatch niet hoofdlettergevoelig. pass-if-text-found: wanneer waar, wordt de validatie doorgegeven als er een overeenkomst is voor de ContentMatch-tekenreeks. Als dit onwaar is, mislukt de validatie als er een overeenkomst is.

--defined-web-test-name

Door de gebruiker gedefinieerde naam als deze WebTest.

--description

Door de gebruiker gedefinieerde beschrijving voor deze WebTest.

--enabled

Wordt de test actief bewaakt.

geaccepteerde waarden: false, true
--expected-status-code

Controleer of de WebTest de opgegeven HTTP-statuscode retourneert.

--follow-redirects

Volg omleidingen voor deze webtest.

geaccepteerde waarden: false, true
--frequency

Interval in seconden tussen testuitvoeringen voor deze WebTest. De standaardwaarde is 300.

--headers

Lijst met headers en de bijbehorende waarden om toe te voegen aan de webtest-aanroep.

Gebruik: --headers key=XX value=XX

sleutel: de naam van de koptekst. waarde: De waarde van de koptekst.

Meerdere acties kunnen worden opgegeven met behulp van meer dan één argument --headers.

--http-verb

Http-werkwoord dat moet worden gebruikt voor deze webtest.

--ignore-status-code

Wanneer deze is ingesteld, negeert de validatie de statuscode.

geaccepteerde waarden: false, true
--kind

Het type WebTest dat door deze webtest wordt bewaakt. Keuzes zijn ping en multistep.

geaccepteerde waarden: multistep, ping
--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--locations

Een lijst met waar u de tests fysiek kunt uitvoeren om globale dekking te bieden voor toegankelijkheid van uw toepassing.

Gebruik: --locations Id=XX

Id: Locatie-id voor de WebTest waaruit moet worden uitgevoerd.

Meerdere acties kunnen worden opgegeven met behulp van meer dan één argument --locations.

--parse-requests

ParseEr afhankelijke aanvraag voor deze WebTest.

geaccepteerde waarden: false, true
--request-body

Met Base64 gecodeerde tekenreekstekst die met deze webtest moet worden verzonden.

--request-url

Url-locatie die moet worden getest.

--retry-enabled

Toestaan voor nieuwe pogingen als deze webtest mislukt.

geaccepteerde waarden: false, true
--ssl-check

Controleert of het SSL-certificaat nog steeds geldig is.

geaccepteerde waarden: false, true
--ssl-lifetime-check

Een aantal dagen om te controleren blijft bestaan voordat het bestaande SSL-certificaat verloopt. De waarde moet positief zijn en de SSLCheck moet zijn ingesteld op true.

--synthetic-monitor-id

Unieke id van deze webtest. Dit is doorgaans dezelfde waarde als het veld Naam.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--timeout

Seconden totdat deze WebTest een time-out krijgt en mislukt. De standaardwaarde is 30.

--web-test

De XML-specificatie van een WebTest die moet worden uitgevoerd voor een toepassing.

--web-test-kind

Het soort webtest is dat geldige keuzes zijn ping, multistep en standaard.

geaccepteerde waarden: multistep, ping, standard
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor app-insights web-test delete

Een Application Insights-webtest verwijderen.

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

Voorbeelden

webTestDelete

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

Vereiste parameters

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

De naam van de Application Insights WebTest-resource.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor app-insights web-test list

Haal alle Application Insights-webtests op die zijn gedefinieerd voor het opgegeven onderdeel. En haal alle Application Insights-webtests op die zijn gedefinieerd binnen een opgegeven resourcegroep. En haal alle Application Insights-webtestwaarschuwingen op binnen een abonnement.

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

Voorbeelden

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

Optionele parameters

--component-name

De naam van de Application Insights-onderdeelresource.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor app-insights web-test show

Een specifieke Application Insights-webtestdefinitie ophalen.

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

Voorbeelden

webTestGet

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

Vereiste parameters

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

De naam van de Application Insights WebTest-resource.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az monitor app-insights web-test update

Een Application Insights-webtestdefinitie bijwerken.

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

Voorbeelden

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"

Vereiste parameters

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

De naam van de Application Insights WebTest-resource.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

standaardwaarde: []
--content-validation

De verzameling eigenschappen van inhoudsvalidatie.

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

inhoudsovereenkomst: Inhoud die moet worden gezocht in de return van de WebTest. Mag niet null of leeg zijn. ignore-case: wanneer deze waarde is ingesteld, is de validatiecase contentmatch niet hoofdlettergevoelig. pass-if-text-found: wanneer waar, wordt de validatie doorgegeven als er een overeenkomst is voor de ContentMatch-tekenreeks. Als dit onwaar is, mislukt de validatie als er een overeenkomst is.

--defined-web-test-name

Door de gebruiker gedefinieerde naam als deze WebTest.

--description

Door de gebruiker gedefinieerde beschrijving voor deze WebTest.

--enabled

Wordt de test actief bewaakt.

geaccepteerde waarden: false, true
--expected-status-code

Controleer of de WebTest de opgegeven HTTP-statuscode retourneert.

--follow-redirects

Volg omleidingen voor deze webtest.

geaccepteerde waarden: false, true
--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

standaardwaarde: False
--frequency

Interval in seconden tussen testuitvoeringen voor deze WebTest. De standaardwaarde is 300.

--headers

Lijst met headers en de bijbehorende waarden om toe te voegen aan de webtest-aanroep.

Gebruik: --headers key=XX value=XX

sleutel: de naam van de koptekst. waarde: De waarde van de koptekst.

Meerdere acties kunnen worden opgegeven met behulp van meer dan één argument --headers.

--http-verb

Http-werkwoord dat moet worden gebruikt voor deze webtest.

--ignore-status-code

Wanneer deze is ingesteld, negeert de validatie de statuscode.

geaccepteerde waarden: false, true
--kind

Het type WebTest dat door deze webtest wordt bewaakt. Keuzes zijn ping en multistep.

geaccepteerde waarden: multistep, ping
--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--locations

Een lijst met waar u de tests fysiek kunt uitvoeren om globale dekking te bieden voor toegankelijkheid van uw toepassing.

Gebruik: --locations Id=XX

Id: Locatie-id voor de WebTest waaruit moet worden uitgevoerd.

Meerdere acties kunnen worden opgegeven met behulp van meer dan één argument --locations.

--parse-requests

ParseEr afhankelijke aanvraag voor deze WebTest.

geaccepteerde waarden: false, true
--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

standaardwaarde: []
--request-body

Met Base64 gecodeerde tekenreekstekst die met deze webtest moet worden verzonden.

--request-url

Url-locatie die moet worden getest.

--retry-enabled

Toestaan voor nieuwe pogingen als deze webtest mislukt.

geaccepteerde waarden: false, true
--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

standaardwaarde: []
--ssl-check

Controleert of het SSL-certificaat nog steeds geldig is.

geaccepteerde waarden: false, true
--ssl-lifetime-check

Een aantal dagen om te controleren blijft bestaan voordat het bestaande SSL-certificaat verloopt. De waarde moet positief zijn en de SSLCheck moet zijn ingesteld op true.

--synthetic-monitor-id

Unieke id van deze webtest. Dit is doorgaans dezelfde waarde als het veld Naam.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--timeout

Seconden totdat deze WebTest een time-out krijgt en mislukt. De standaardwaarde is 30.

--web-test

De XML-specificatie van een WebTest die moet worden uitgevoerd voor een toepassing.

--web-test-kind

Het soort webtest is dat geldige keuzes zijn ping, multistep en standaard.

geaccepteerde waarden: multistep, ping, standard
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.