Compartilhar via

az monitor app-insights web-test

  • Referência

Observação

Essa referência faz parte da extensão do application-insights para a CLI do Azure (versão 2.55.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az monitor app-insights web-test . Saiba mais sobre extensões.

Gerencie testes da Web com insights de aplicativos.

Comandos

Nome Description Tipo Status
az monitor app-insights web-test create

Crie uma definição de teste da Web do Application Insights.

 Extensão GA
az monitor app-insights web-test delete

Exclua um teste da Web do Application Insights.

 Extensão GA
az monitor app-insights web-test list

Obtenha todos os testes da Web do Application Insights definidos para o componente especificado. E obtenha todos os testes da Web do Application Insights definidos em um grupo de recursos especificado. E obtenha todas as definições de alertas de teste da Web do Application Insights em uma assinatura.

 Extensão GA
az monitor app-insights web-test show

Obtenha uma definição de teste da Web específica do Application Insights.

 Extensão GA
az monitor app-insights web-test update

Atualize uma definição de teste da Web do Application Insights.

 Extensão GA

az monitor app-insights web-test create

Crie uma definição de teste da Web do 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}]

Exemplos

webTestCriar

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

Parâmetros Exigidos

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

O nome do recurso WebTest do Application Insights.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--content-validation

A coleção de propriedades de validação de conteúdo.

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

content-match: Conteúdo a ser procurado no retorno do WebTest. Não deve ser nulo ou vazio. ignore-case: Quando definido, esse valor torna a validação ContentMatch sem distinção entre maiúsculas e minúsculas. pass-if-text-found: Quando true, a validação será aprovada se houver uma correspondência para a cadeia de caracteres ContentMatch. Se false, a validação falhará se houver uma correspondência.

--defined-web-test-name

Nome definido pelo usuário se este WebTest.

--description

Descrição definida pelo usuário para este WebTest.

--enabled

O teste está sendo monitorado ativamente.

Valores aceitos: false, true
--expected-status-code

Valide se o WebTest retorna o código de status http fornecido.

--follow-redirects

Siga os redirecionamentos para este teste da Web.

Valores aceitos: false, true
--frequency

Intervalo em segundos entre as execuções de teste para este WebTest. O valor padrão é 300.

--headers

Lista de cabeçalhos e seus valores a serem adicionados à chamada WebTest.

Uso: --headers key=XX value=XX

key: O nome do cabeçalho. value: O valor do cabeçalho.

Várias ações podem ser especificadas usando mais de um argumento --headers.

--http-verb

Verbo http para usar para este teste web.

--ignore-status-code

Quando definida, a validação ignorará o código de status.

Valores aceitos: false, true
--kind

O tipo de WebTest que este teste da Web assiste. As opções são ping e multistep.

Valores aceitos: multistep, ping
--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--locations

Uma lista de onde executar fisicamente os testes para dar cobertura global para acessibilidade do seu aplicativo.

Uso: --locations Id=XX

Id: ID de local para o WebTest ser executado.

Várias ações podem ser especificadas usando mais de um argumento --locations.

--parse-requests

Analisar solicitação dependente para este WebTest.

Valores aceitos: false, true
--request-body

Corpo de cadeia de caracteres codificado em Base64 para enviar com este teste da Web.

--request-url

Local da URL a ser testada.

--retry-enabled

Permitir novas tentativas caso este WebTest falhe.

Valores aceitos: false, true
--ssl-check

Verifica se o certificado SSL ainda é válido.

Valores aceitos: false, true
--ssl-lifetime-check

Ainda faltam alguns dias para verificar antes que o certificado SSL existente expire. O valor deve ser positivo e o SSLCheck deve ser definido como true.

--synthetic-monitor-id

ID exclusivo deste WebTest. Normalmente, esse é o mesmo valor que o campo Nome.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--timeout

Segundos até que este WebTest atinja o tempo limite e falhe. O valor padrão é 30.

--web-test

A especificação XML de um WebTest a ser executado em um aplicativo.

--web-test-kind

O tipo de teste web que é, as escolhas válidas são ping, multistep e padrão.

Valores aceitos: multistep, ping, standard
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az monitor app-insights web-test delete

Exclua um teste da Web do Application Insights.

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

Exemplos

webTestDelete

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

Parâmetros Exigidos

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

O nome do recurso WebTest do Application Insights.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az monitor app-insights web-test list

Obtenha todos os testes da Web do Application Insights definidos para o componente especificado. E obtenha todos os testes da Web do Application Insights definidos em um grupo de recursos especificado. E obtenha todas as definições de alertas de teste da Web do Application Insights em uma assinatura.

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

Exemplos

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

Parâmetros Opcionais

--component-name

O nome do recurso do componente Application Insights.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az monitor app-insights web-test show

Obtenha uma definição de teste da Web específica do Application Insights.

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

Exemplos

webTestObter

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

Parâmetros Exigidos

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

O nome do recurso WebTest do Application Insights.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az monitor app-insights web-test update

Atualize uma definição de teste da Web do 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}]

Exemplos

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"

Parâmetros Exigidos

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

O nome do recurso WebTest do Application Insights.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Valor padrão: []
--content-validation

A coleção de propriedades de validação de conteúdo.

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

content-match: Conteúdo a ser procurado no retorno do WebTest. Não deve ser nulo ou vazio. ignore-case: Quando definido, esse valor torna a validação ContentMatch sem distinção entre maiúsculas e minúsculas. pass-if-text-found: Quando true, a validação será aprovada se houver uma correspondência para a cadeia de caracteres ContentMatch. Se false, a validação falhará se houver uma correspondência.

--defined-web-test-name

Nome definido pelo usuário se este WebTest.

--description

Descrição definida pelo usuário para este WebTest.

--enabled

O teste está sendo monitorado ativamente.

Valores aceitos: false, true
--expected-status-code

Valide se o WebTest retorna o código de status http fornecido.

--follow-redirects

Siga os redirecionamentos para este teste da Web.

Valores aceitos: false, true
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter para JSON.

Valor padrão: False
--frequency

Intervalo em segundos entre as execuções de teste para este WebTest. O valor padrão é 300.

--headers

Lista de cabeçalhos e seus valores a serem adicionados à chamada WebTest.

Uso: --headers key=XX value=XX

key: O nome do cabeçalho. value: O valor do cabeçalho.

Várias ações podem ser especificadas usando mais de um argumento --headers.

--http-verb

Verbo http para usar para este teste web.

--ignore-status-code

Quando definida, a validação ignorará o código de status.

Valores aceitos: false, true
--kind

O tipo de WebTest que este teste da Web assiste. As opções são ping e multistep.

Valores aceitos: multistep, ping
--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--locations

Uma lista de onde executar fisicamente os testes para dar cobertura global para acessibilidade do seu aplicativo.

Uso: --locations Id=XX

Id: ID de local para o WebTest ser executado.

Várias ações podem ser especificadas usando mais de um argumento --locations.

--parse-requests

Analisar solicitação dependente para este WebTest.

Valores aceitos: false, true
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Valor padrão: []
--request-body

Corpo de cadeia de caracteres codificado em Base64 para enviar com este teste da Web.

--request-url

Local da URL a ser testada.

--retry-enabled

Permitir novas tentativas caso este WebTest falhe.

Valores aceitos: false, true
--set

Atualize um objeto especificando um caminho de propriedade e um valor a serem definidos. Exemplo: --set property1.property2=<value>.

Valor padrão: []
--ssl-check

Verifica se o certificado SSL ainda é válido.

Valores aceitos: false, true
--ssl-lifetime-check

Ainda faltam alguns dias para verificar antes que o certificado SSL existente expire. O valor deve ser positivo e o SSLCheck deve ser definido como true.

--synthetic-monitor-id

ID exclusivo deste WebTest. Normalmente, esse é o mesmo valor que o campo Nome.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--timeout

Segundos até que este WebTest atinja o tempo limite e falhe. O valor padrão é 30.

--web-test

A especificação XML de um WebTest a ser executado em um aplicativo.

--web-test-kind

O tipo de teste web que é, as escolhas válidas são ping, multistep e padrão.

Valores aceitos: multistep, ping, standard
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.