Compartir vía

az monitor app-insights web-test

  • Referencia

Nota:

Esta referencia forma parte de la extensión application-insights para la CLI de Azure (versión 2.55.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az monitor app-insights web-test . Obtenga más información sobre las extensiones.

Administración de pruebas web con Application Insights.

Comandos

Nombre Description Tipo Estado
az monitor app-insights web-test create

Cree una definición de prueba web de Application Ideas.

 Extensión GA
az monitor app-insights web-test delete

Elimine una prueba web de Application Ideas.

 Extensión GA
az monitor app-insights web-test list

Obtenga todas las pruebas web de Application Ideas definidas para el componente especificado. Y obtenga todas las pruebas web de Application Ideas definidas en un grupo de recursos especificado. Y obtenga todas las definiciones de alertas de prueba web de Application Ideas dentro de una suscripción.

 Extensión GA
az monitor app-insights web-test show

Obtenga una definición de prueba web de Application Ideas específica.

 Extensión GA
az monitor app-insights web-test update

Actualice una definición de prueba web de Application Ideas.

 Extensión GA

az monitor app-insights web-test create

Cree una definición de prueba web de Application Ideas.

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

Ejemplos

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

Parámetros requeridos

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

Nombre del recurso Application Ideas WebTest.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--content-validation

Colección de propiedades de validación de contenido.

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

content-match: contenido que se va a buscar en la devolución de WebTest. No debe ser null ni estar vacío. ignore-case: cuando se establece, este valor hace que el caso de validación contentMatch no distingue mayúsculas de minúsculas. pass-if-text-found: cuando es true, la validación pasará si hay una coincidencia para la cadena ContentMatch. Si es false, se producirá un error en la validación si hay una coincidencia.

--defined-web-test-name

Nombre definido por el usuario si este WebTest.

--description

Descripción definida por el usuario para este WebTest.

--enabled

Es la prueba que se está supervisando activamente.

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

Compruebe que WebTest devuelve el código de estado HTTP proporcionado.

--follow-redirects

Siga las redirecciones para esta prueba web.

Valores aceptados: false, true
--frequency

Intervalo en segundos entre ejecuciones de pruebas para este WebTest. El valor predeterminado es 300.

--headers

Lista de encabezados y sus valores que se van a agregar a la llamada a WebTest.

Uso: --headers key=XX value=XX

key: el nombre del encabezado. value: valor del encabezado.

Se pueden especificar varias acciones mediante más de un argumento --headers.

--http-verb

Verbo HTTP que se va a usar para esta prueba web.

--ignore-status-code

Cuando se establece, la validación omitirá el código de estado.

Valores aceptados: false, true
--kind

Tipo de WebTest que esta prueba web supervisa. Las opciones son ping y multistep.

Valores aceptados: multistep, ping
--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--locations

Lista de dónde ejecutar físicamente las pruebas para proporcionar cobertura global para la accesibilidad de la aplicación.

Uso: --locations Id=XX

Identificador: id. de ubicación desde el que se va a ejecutar WebTest.

Se pueden especificar varias acciones mediante más de un argumento --locations.

--parse-requests

Analizar la solicitud dependiente de este WebTest.

Valores aceptados: false, true
--request-body

Cuerpo de cadena codificado en Base64 para enviar con esta prueba web.

--request-url

Ubicación de la dirección URL que se va a probar.

--retry-enabled

Permitir reintentos debe producir un error en WebTest.

Valores aceptados: false, true
--ssl-check

Comprueba si el certificado SSL sigue siendo válido.

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

Un número de días para comprobar aún permanece antes de que expire el certificado SSL existente. El valor debe ser positivo y SSLCheck debe establecerse en true.

--synthetic-monitor-id

Identificador único de este WebTest. Normalmente es el mismo valor que el campo Nombre.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--timeout

Segundos hasta que se produzca un tiempo de espera de WebTest y se produzca un error. El valor predeterminado es 30.

--web-test

Especificación XML de un WebTest que se va a ejecutar en una aplicación.

--web-test-kind

El tipo de prueba web es, las opciones válidas son ping, multistep y estándar.

Valores aceptados: multistep, ping, standard
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor app-insights web-test delete

Elimine una prueba web de Application Ideas.

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

Ejemplos

webTestDelete

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

Parámetros requeridos

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

Nombre del recurso Application Ideas WebTest.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor app-insights web-test list

Obtenga todas las pruebas web de Application Ideas definidas para el componente especificado. Y obtenga todas las pruebas web de Application Ideas definidas en un grupo de recursos especificado. Y obtenga todas las definiciones de alertas de prueba web de Application Ideas dentro de una suscripción.

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

Ejemplos

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 opcionales

--component-name

Nombre del recurso del componente Application Ideas.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor app-insights web-test show

Obtenga una definición de prueba web de Application Ideas específica.

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

Ejemplos

webTestGet

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

Parámetros requeridos

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

Nombre del recurso Application Ideas WebTest.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az monitor app-insights web-test update

Actualice una definición de prueba web de Application Ideas.

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

Ejemplos

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 requeridos

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

Nombre del recurso Application Ideas WebTest.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Valor predeterminado: []
--content-validation

Colección de propiedades de validación de contenido.

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

content-match: contenido que se va a buscar en la devolución de WebTest. No debe ser null ni estar vacío. ignore-case: cuando se establece, este valor hace que el caso de validación contentMatch no distingue mayúsculas de minúsculas. pass-if-text-found: cuando es true, la validación pasará si hay una coincidencia para la cadena ContentMatch. Si es false, se producirá un error en la validación si hay una coincidencia.

--defined-web-test-name

Nombre definido por el usuario si este WebTest.

--description

Descripción definida por el usuario para este WebTest.

--enabled

Es la prueba que se está supervisando activamente.

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

Compruebe que WebTest devuelve el código de estado HTTP proporcionado.

--follow-redirects

Siga las redirecciones para esta prueba web.

Valores aceptados: false, true
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False
--frequency

Intervalo en segundos entre ejecuciones de pruebas para este WebTest. El valor predeterminado es 300.

--headers

Lista de encabezados y sus valores que se van a agregar a la llamada a WebTest.

Uso: --headers key=XX value=XX

key: el nombre del encabezado. value: valor del encabezado.

Se pueden especificar varias acciones mediante más de un argumento --headers.

--http-verb

Verbo HTTP que se va a usar para esta prueba web.

--ignore-status-code

Cuando se establece, la validación omitirá el código de estado.

Valores aceptados: false, true
--kind

Tipo de WebTest que esta prueba web supervisa. Las opciones son ping y multistep.

Valores aceptados: multistep, ping
--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--locations

Lista de dónde ejecutar físicamente las pruebas para proporcionar cobertura global para la accesibilidad de la aplicación.

Uso: --locations Id=XX

Identificador: id. de ubicación desde el que se va a ejecutar WebTest.

Se pueden especificar varias acciones mediante más de un argumento --locations.

--parse-requests

Analizar la solicitud dependiente de este WebTest.

Valores aceptados: false, true
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Valor predeterminado: []
--request-body

Cuerpo de cadena codificado en Base64 para enviar con esta prueba web.

--request-url

Ubicación de la dirección URL que se va a probar.

--retry-enabled

Permitir reintentos debe producir un error en WebTest.

Valores aceptados: false, true
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []
--ssl-check

Comprueba si el certificado SSL sigue siendo válido.

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

Un número de días para comprobar aún permanece antes de que expire el certificado SSL existente. El valor debe ser positivo y SSLCheck debe establecerse en true.

--synthetic-monitor-id

Identificador único de este WebTest. Normalmente es el mismo valor que el campo Nombre.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--timeout

Segundos hasta que se produzca un tiempo de espera de WebTest y se produzca un error. El valor predeterminado es 30.

--web-test

Especificación XML de un WebTest que se va a ejecutar en una aplicación.

--web-test-kind

El tipo de prueba web es, las opciones válidas son ping, multistep y estándar.

Valores aceptados: multistep, ping, standard
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.