다음을 통해 공유

az monitor app-insights web-test

  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.55.0 이상)에 대한 Application-insights 확장의 일부입니다. az monitor app-insights 웹 테스트 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Application Insights를 사용하여 웹 테스트를 관리합니다.

명령

Name Description 형식 상태
az monitor app-insights web-test create

Application Insights 웹 테스트 정의를 만듭니다.

 내선 번호 GA
az monitor app-insights web-test delete

Application Insights 웹 테스트를 삭제합니다.

 내선 번호 GA
az monitor app-insights web-test list

지정된 구성 요소에 대해 정의된 모든 Application Insights 웹 테스트를 가져옵니다. 또한 지정된 리소스 그룹 내에 정의된 모든 Application Insights 웹 테스트를 가져옵니다. 또한 구독 내에서 모든 Application Insights 웹 테스트 경고 정의를 가져옵니다.

 내선 번호 GA
az monitor app-insights web-test show

특정 Application Insights 웹 테스트 정의를 가져옵니다.

 내선 번호 GA
az monitor app-insights web-test update

Application Insights 웹 테스트 정의를 업데이트합니다.

 내선 번호 GA

az monitor app-insights web-test create

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

예제

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

필수 매개 변수

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

Application Insights WebTest 리소스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--content-validation

콘텐츠 유효성 검사 속성의 컬렉션입니다.

사용법: --content-validation content-match=XX ignore-case=XX pass-if-text-found=XX

content-match: WebTest의 반환에서 찾을 콘텐츠입니다. null이거나 비어 있지 않아야 합니다. ignore-case: 이 값을 설정하면 ContentMatch 유효성 검사 대/소문자를 구분하지 않습니다. pass-if-text-found: true이면 ContentMatch 문자열과 일치하는 항목이 있으면 유효성 검사가 전달됩니다. false이면 일치하는 항목이 있으면 유효성 검사가 실패합니다.

--defined-web-test-name

이 WebTest인 경우 사용자 정의 이름입니다.

--description

이 WebTest에 대한 사용자 정의 설명입니다.

--enabled

적극적으로 모니터링되는 테스트입니다.

허용되는 값: false, true
--expected-status-code

WebTest가 제공된 http 상태 코드를 반환했는지 확인합니다.

--follow-redirects

이 웹 테스트에 대한 리디렉션을 따릅니다.

허용되는 값: false, true
--frequency

이 WebTest에 대한 테스트 실행 사이의 간격(초)입니다. 기본값은 300입니다.

--headers

WebTest 호출에 추가할 헤더 및 해당 값의 목록입니다.

사용법: --headers key=XX value=XX

key: 헤더의 이름입니다. value: 헤더의 값입니다.

둘 이상의 --headers 인수를 사용하여 여러 작업을 지정할 수 있습니다.

--http-verb

이 웹 테스트에 사용할 Http 동사입니다.

--ignore-status-code

설정되면 유효성 검사는 상태 코드를 무시합니다.

허용되는 값: false, true
--kind

이 웹 테스트에서 감시하는 WebTest의 종류입니다. 선택 항목은 ping 및 multistep입니다.

허용되는 값: multistep, ping
--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--locations

애플리케이션의 접근성에 대한 전역 범위를 제공하기 위해 테스트를 물리적으로 실행할 위치 목록입니다.

사용량: --locations Id=XX

ID: 실행할 WebTest의 위치 ID입니다.

둘 이상의 --locations 인수를 사용하여 여러 작업을 지정할 수 있습니다.

--parse-requests

이 WebTest에 대한 종속 요청을 구문 분석합니다.

허용되는 값: false, true
--request-body

이 웹 테스트와 함께 보낼 Base64 인코딩된 문자열 본문입니다.

--request-url

테스트할 URL 위치입니다.

--retry-enabled

이 WebTest가 실패할 경우 재시도를 허용합니다.

허용되는 값: false, true
--ssl-check

SSL 인증서가 여전히 유효한지 확인합니다.

허용되는 값: false, true
--ssl-lifetime-check

기존 SSL 인증서가 만료되기 기본 검사 수일입니다. 값은 양수여야 하고 SSLCheck는 true로 설정해야 합니다.

--synthetic-monitor-id

이 WebTest의 고유 ID입니다. 일반적으로 이름 필드와 동일한 값입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--timeout

이 WebTest까지의 시간 제한 및 실패 시간(초)입니다. 기본값은 30입니다.

--web-test

애플리케이션에 대해 실행할 WebTest의 XML 사양입니다.

--web-test-kind

웹 테스트의 종류는 ping, multistep 및 표준입니다.

허용되는 값: multistep, ping, standard
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor app-insights web-test delete

Application Insights 웹 테스트를 삭제합니다.

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

예제

webTestDelete

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

필수 매개 변수

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

Application Insights WebTest 리소스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--yes -y

확인 메시지를 표시하지 않습니다.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor app-insights web-test list

지정된 구성 요소에 대해 정의된 모든 Application Insights 웹 테스트를 가져옵니다. 또한 지정된 리소스 그룹 내에 정의된 모든 Application Insights 웹 테스트를 가져옵니다. 또한 구독 내에서 모든 Application Insights 웹 테스트 경고 정의를 가져옵니다.

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

예제

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

선택적 매개 변수

--component-name

Application Insights 구성 요소 리소스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor app-insights web-test show

특정 Application Insights 웹 테스트 정의를 가져옵니다.

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

예제

webTestGet

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

필수 매개 변수

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

Application Insights WebTest 리소스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor app-insights web-test update

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

예제

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"

필수 매개 변수

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

Application Insights WebTest 리소스의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

Default value: []
--content-validation

콘텐츠 유효성 검사 속성의 컬렉션입니다.

사용법: --content-validation content-match=XX ignore-case=XX pass-if-text-found=XX

content-match: WebTest의 반환에서 찾을 콘텐츠입니다. null이거나 비어 있지 않아야 합니다. ignore-case: 이 값을 설정하면 ContentMatch 유효성 검사 대/소문자를 구분하지 않습니다. pass-if-text-found: true이면 ContentMatch 문자열과 일치하는 항목이 있으면 유효성 검사가 전달됩니다. false이면 일치하는 항목이 있으면 유효성 검사가 실패합니다.

--defined-web-test-name

이 WebTest인 경우 사용자 정의 이름입니다.

--description

이 WebTest에 대한 사용자 정의 설명입니다.

--enabled

적극적으로 모니터링되는 테스트입니다.

허용되는 값: false, true
--expected-status-code

WebTest가 제공된 http 상태 코드를 반환했는지 확인합니다.

--follow-redirects

이 웹 테스트에 대한 리디렉션을 따릅니다.

허용되는 값: false, true
--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

Default value: False
--frequency

이 WebTest에 대한 테스트 실행 사이의 간격(초)입니다. 기본값은 300입니다.

--headers

WebTest 호출에 추가할 헤더 및 해당 값의 목록입니다.

사용법: --headers key=XX value=XX

key: 헤더의 이름입니다. value: 헤더의 값입니다.

둘 이상의 --headers 인수를 사용하여 여러 작업을 지정할 수 있습니다.

--http-verb

이 웹 테스트에 사용할 Http 동사입니다.

--ignore-status-code

설정되면 유효성 검사는 상태 코드를 무시합니다.

허용되는 값: false, true
--kind

이 웹 테스트에서 감시하는 WebTest의 종류입니다. 선택 항목은 ping 및 multistep입니다.

허용되는 값: multistep, ping
--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--locations

애플리케이션의 접근성에 대한 전역 범위를 제공하기 위해 테스트를 물리적으로 실행할 위치 목록입니다.

사용량: --locations Id=XX

ID: 실행할 WebTest의 위치 ID입니다.

둘 이상의 --locations 인수를 사용하여 여러 작업을 지정할 수 있습니다.

--parse-requests

이 WebTest에 대한 종속 요청을 구문 분석합니다.

허용되는 값: false, true
--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--request-body

이 웹 테스트와 함께 보낼 Base64 인코딩된 문자열 본문입니다.

--request-url

테스트할 URL 위치입니다.

--retry-enabled

이 WebTest가 실패할 경우 재시도를 허용합니다.

허용되는 값: false, true
--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

Default value: []
--ssl-check

SSL 인증서가 여전히 유효한지 확인합니다.

허용되는 값: false, true
--ssl-lifetime-check

기존 SSL 인증서가 만료되기 기본 검사 수일입니다. 값은 양수여야 하고 SSLCheck는 true로 설정해야 합니다.

--synthetic-monitor-id

이 WebTest의 고유 ID입니다. 일반적으로 이름 필드와 동일한 값입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--timeout

이 WebTest까지의 시간 제한 및 실패 시간(초)입니다. 기본값은 30입니다.

--web-test

애플리케이션에 대해 실행할 WebTest의 XML 사양입니다.

--web-test-kind

웹 테스트의 종류는 ping, multistep 및 표준입니다.

허용되는 값: multistep, ping, standard
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.