마이그레이션 가용성 테스트

이 문서에서는 클래식 URL ping 테스트에서 최신적이고 효율적인 표준 테스트로 마이그레이션하는 과정을 안내합니다.

원활한 전환을 보장하고 애플리케이션에 최신 모니터링 기능을 제공하기 위해 명확한 단계별 지침을 제공하여 이 프로세스를 간소화합니다.

클래식 URL ping 테스트를 표준 테스트로 마이그레이션

다음 단계에서는 URL ping 테스트의 기능을 복제하는 표준 테스트를 만드는 과정을 안내합니다. 이전에 만든 URL ping 테스트를 사용하면 표준 테스트의 고급 기능을 더 쉽게 사용할 수 있습니다.

Important

2026년 9월 30일에 URL ping 테스트가 사용 중지됩니다. 그 전에 표준 테스트로 전환합니다.

필수 조건

단계

  1. Azure PowerShell(Connect-AzAccount + Set-AzContext)을 사용하여 구독에 연결합니다.

  2. 현재 구독의 모든 URL ping 테스트를 나열합니다.

    Get-AzApplicationInsightsWebTest | `
    Where-Object { $_.WebTestKind -eq "ping" } | `
    Format-Table -Property ResourceGroupName,Name,WebTestKind,Enabled;
    
  3. 마이그레이션하려는 URL Ping 테스트를 찾고 해당 리소스 그룹과 이름을 기록합니다.

  4. 다음 명령은 URL ping 테스트와 동일한 논리를 사용하여 표준 테스트를 만듭니다.

    $resourceGroup = "pingTestResourceGroup";
    $appInsightsComponent = "componentName";
    $pingTestName = "pingTestName";
    $newStandardTestName = "newStandardTestName";
    
    $componentId = (Get-AzApplicationInsights -ResourceGroupName $resourceGroup -Name $appInsightsComponent).Id;
    $pingTest = Get-AzApplicationInsightsWebTest -ResourceGroupName $resourceGroup -Name $pingTestName;
    $pingTestRequest = ([xml]$pingTest.ConfigurationWebTest).WebTest.Items.Request;
    $pingTestValidationRule = ([xml]$pingTest.ConfigurationWebTest).WebTest.ValidationRules.ValidationRule;
    
    $dynamicParameters = @{};
    
    if ($pingTestRequest.IgnoreHttpStatusCode -eq [bool]::FalseString) {
    $dynamicParameters["RuleExpectedHttpStatusCode"] = [convert]::ToInt32($pingTestRequest.ExpectedHttpStatusCode, 10);
    }
    
    if ($pingTestValidationRule -and $pingTestValidationRule.DisplayName -eq "Find Text" `
    -and $pingTestValidationRule.RuleParameters.RuleParameter[0].Name -eq "FindText" `
    -and $pingTestValidationRule.RuleParameters.RuleParameter[0].Value) {
    $dynamicParameters["ContentMatch"] = $pingTestValidationRule.RuleParameters.RuleParameter[0].Value;
    $dynamicParameters["ContentPassIfTextFound"] = $true;
    }
    
    New-AzApplicationInsightsWebTest @dynamicParameters -ResourceGroupName $resourceGroup -Name $newStandardTestName `
    -Location $pingTest.Location -Kind 'standard' -Tag @{ "hidden-link:$componentId" = "Resource" } -TestName $newStandardTestName `
    -RequestUrl $pingTestRequest.Url -RequestHttpVerb "GET" -GeoLocation $pingTest.PropertiesLocations -Frequency $pingTest.Frequency `
    -Timeout $pingTest.Timeout -RetryEnabled:$pingTest.RetryEnabled -Enabled:$pingTest.Enabled `
    -RequestParseDependent:($pingTestRequest.ParseDependentRequests -eq [bool]::TrueString);
    
  5. 새로운 표준 테스트에는 기본적으로 경고 규칙이 없으므로 노이즈가 많은 경고가 만들어지지 않습니다. URL ping 테스트는 변경되지 않으므로 계속해서 경고를 받을 수 있습니다.

  6. 새 표준 테스트의 기능의 유효성을 검사한 후에는 URL ping 테스트를 참조하는 경고 규칙을 업데이트하여 대신 표준 테스트를 참조하세요. 그런 다음 URL ping 테스트를 사용하지 않도록 설정하거나 삭제합니다.

  7. Azure PowerShell을 사용하여 URL ping 테스트를 삭제하려면 다음 명령을 사용할 수 있습니다.

    Remove-AzApplicationInsightsWebTest -ResourceGroupName $resourceGroup -Name $pingTestName;
    

FAQ

언제 이 명령을 사용해야 하나요?

이제 새 기능을 활용하기 위해 URL ping 테스트를 표준 테스트로 마이그레이션합니다.

이 단계는 HTTP 및 HTTPS 엔드포인트 모두에 적용되나요?

예, 이 명령은 URL ping 테스트에 사용되는 HTTP 및 HTTPS 엔드포인트 모두에서 작동합니다.

추가 정보