HTTP API 테스트 생성¶

HTTP API 테스트는 HTTP 프로토콜 기반의 웹사이트, 도메인, 백엔드 API 등에 대해 주기적인 가용성 모니터링을 수행합니다. 사이트를 실시간으로 모니터링하여 가용 현황을 집계하고, 테스트 로그와 실시간 알림을 제공함으로써 네트워크 문제를 신속하게 발견하고 네트워크 액세스 품질을 향상시키는 데 도움을 줍니다.

HTTP API 테스트를 사용하면 애플리케이션의 API 엔드포인트에 HTTP 요청을 전송하여 요청 헤더, 상태 코드, 응답 시간 등 정의된 요청 및 판단 조건을 검증할 수 있습니다.

생성¶

생성 > API 테스트를 클릭하고 HTTP 프로토콜을 선택합니다.

1단계: 요청 형식 정의¶

1. URL: HTTP 또는 HTTPS URL을 입력할 수 있으며, GET, POST, PUT, HEAD 네 가지 요청 방식을 지원합니다.
2. 고급 설정: 상황에 따라 고급 설정을 수행합니다. 요청 설정, 요청 본문, 인증서, 프록시, 개인정보 보호 설정이 포함됩니다.
3. 이름: HTTP API 테스트 작업 이름을 사용자 지정합니다. 현재 워크스페이스 내에서 중복 이름을 지원하지 않습니다.

고급 설정¶

2단계: 가용성 판단¶

기본 모드¶

판단 조건을 추가하여 데이터를 일치시키는 방식입니다. 여러 조건 간에 "모든" 또는 "임의"를 선택하여 AND 또는 OR 논리 관계를 구현할 수 있습니다.

요청 형식을 정의하고 판단 조건을 추가한 후 URL 오른쪽의 "테스트" 버튼을 클릭하여 테스트 연결 설정이 성공했는지 확인합니다.

스크립트 모드¶

스크립트 모드는 Pipeline 스크립트를 작성하여 다음 기능을 구현할 수 있습니다.

• 판단 조건 설정: 비즈니스 요구 사항에 따라 단일 조건 또는 다중 조건 조합 판단을 지원하는 사용자 정의 복잡한 판단 로직
• 결과 데이터 처리: 데이터 정리, 형식 변환 등 테스트 결과에 대한 사용자 정의 처리

스크립트 모드는 응답에서 특정 필드를 추출하거나 복잡한 조건 판단을 수행해야 하는 요구 사항을 유연하게 충족할 수 있습니다.

예시:

body = load_json(response["body"])

if body["code"] == 200 {
  result["is_failed"] = false
} else {
  result["is_failed"] = true
  result["error_message"] = body["message"]
}

스크립트에서는 먼저 load_json을 사용하여 응답 내용을 JSON 객체로 파싱한 다음, 응답 상태 코드가 200인지 확인합니다. code가 200이면 결과를 성공으로 표시하고, 그렇지 않으면 result의 is_failed를 true로 설정하고 error_message를 응답 내용의 message로 설정합니다.

자세한 내용은 사용자 정의 테스트 작업을 참조하세요.

3단계: 테스트 노드 선택¶

현재 Guance는 전 세계 14개의 테스트 노드를 제공합니다. 중국 지역 또는 해외 지역(상용 플랜 이상 사용자 전용)의 하나 이상의 노드를 선택하여 사이트 서비스 품질 모니터링을 신속하게 시작할 수 있습니다.

4단계: 테스트 빈도 선택¶

테스트 작업의 실행 빈도를 선택합니다. 다음 옵션을 지원합니다.

• 1분 (상용 플랜 이상 사용자 전용)
• 5분 (상용 플랜 이상 사용자 전용)
• 15분 (상용 플랜 이상 사용자 전용)
• 30분
• 1시간
• 6시간
• 12시간
• 24시간

시스템에서 제공하는 위의 특정 옵션 외에도 사용자 정의 crontab 작업을 입력하여 분, 시간, 일, 월, 주 등의 주기로 정기 작업 실행을 구성할 수 있습니다.