콘텐츠로 이동

다단계 API 테스트


다단계 API 테스트는 여러 API 요청을 직렬로 연결하여 복잡한 비즈니스 프로세스 또는 사용자 작업 경로를 시뮬레이션하는 고급 모니터링 도구입니다. 여러 API 연결의 응답 데이터를 사용하여 테스트를 생성할 수 있으며, 주요 비즈니스 트랜잭션을 검증하고, 엔드투엔드 사용자 여정을 시뮬레이션하며, 인증 및 권한 부여를 지원합니다. 이러한 테스트 방식은 서비스의 가용성과 성능을 사전에 모니터링하여 복잡한 프로세스가 정상적으로 작동하는지 확인하고, 문제 발생 시 신속하게 알림을 보냅니다.

생성

작업 > 생성 > 다단계 API 테스트를 클릭합니다.

1. 기본 정보

  1. 신서틱 테스트 이름을 정의합니다.
  2. 필요에 따라 설명을 입력합니다.

2. 테스트 노드 선택

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

3. 테스트 빈도 선택

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

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

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

4. 요청 단계 정의

첫 번째 요청 생성을 클릭합니다.

이름

요청 이름을 정의합니다.

요청 형식 정의

  1. 요청 URL을 정의합니다.
  2. 필요에 따라 고급 설정을 수행합니다.

성공 판단

기본 모드

판단 조건을 추가하여 테스트 결과의 성공 조건을 정의하는 방식입니다.

여러 조건 사이에서 "모두" 또는 "임의"를 선택하여 AND 또는 OR 논리 관계를 구현할 수 있습니다.

유형 연산자
응답 본문 포함, 미포함, 일치, 불일치, 정규식 일치, 정규식 불일치
요청 헤더 포함, 미포함, 일치, 불일치, 정규식 일치, 정규식 불일치
응답 시간 미만
상태 코드 일치, 불일치, 정규식 일치, 정규식 불일치
스크립트 모드

다단계 API 테스트 작업에서 스크립트 모드는 Pipeline 스크립트를 작성하여 다음 기능을 구현할 수 있습니다.

  • 판단 조건 설정: 비즈니스 요구 사항에 따라 단일 조건 또는 다중 조건 조합 판단을 지원하는 복잡한 판단 로직을 사용자 지정할 수 있습니다.
  • 결과 데이터 처리: 데이터 정제, 형식 변환 등을 포함하여 테스트 결과를 사용자 지정 처리할 수 있습니다.
  • 필드 추출 및 변수 정의: 응답에서 특정 필드를 추출하고 변수로 정의하여 후속 단계에서 재사용할 수 있도록 합니다.

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

예시:

body = load_json(response["body"])

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

위 스크립트는 먼저 load_json을 사용하여 응답 내용을 JSON 객체로 파싱한 다음, 응답 상태 코드가 200인지 판단합니다. 200이면 응답 내용에서 token을 추출하여 vars에 저장해 후속 요청에서 사용하며, 그렇지 않으면 result의 is_failed를 true로 설정하고 error_message를 응답 내용의 message로 설정합니다.

자세한 내용은 사용자 지정 신서틱 테스트를 참조하세요.

로컬 변수

현재 다단계 API 테스트 작업에서 정의된 로컬 변수는 후속 요청 단계에서 참조할 수 있습니다.

주의

변수를 정의하려면 먼저 스크립트에서 해당 필드를 추출해야 합니다.

  1. 변수 이름을 입력합니다. 일반적으로 대문자, 숫자, 밑줄을 지원하며 중복된 이름은 사용할 수 없습니다.
  2. 변수 값을 선택합니다. 즉, 스크립트 모드에서 변수로 정의된 필드입니다.
  3. 필요에 따라 변수 값 암호화 여부를 선택할 수 있습니다. 해당 옵션을 선택하면 테스트 결과에서 현재 변수 값이 숨겨집니다.

생성된 변수는 왼쪽 상단의 "변수" 영역에 표시됩니다. 변수 개수는 {x}xx 형식으로 표시되며, {x}는 변수 식별자, xx는 변수 개수입니다. 예를 들어 {x}3은 현재 변수가 3개임을 나타냅니다.

요청 형식 정의 > 고급 설정 > 요청 헤더에서 로컬 변수를 참조할 수 있습니다.

그림과 같이 1단계에서 값이 dashboard_id인 로컬 변수 {{DS_ID}}가 정의되어 있습니다. 요청 2에서는 URL에서 해당 변수를 직접 참조하여 값을 사용할 수 있습니다.

이러한 변수를 관리해야 하는 경우 "로컬 변수 구성" 영역에서 오른쪽의 버튼을 클릭하여 편집하거나 삭제할 수 있습니다.

주의
  • 로컬 변수를 삭제하면 현재 다단계 API 테스트에서 해당 변수를 참조하는 요청은 더 이상 해당 변수를 사용할 수 없습니다.
  • 로컬 변수 이름을 수정하면 원래 이름을 참조하는 단계에서는 해당 변수를 인식할 수 없습니다.

실행 설정

"이 단계가 실패하면 다음 단계를 계속 실행"을 선택하면 현재 단계가 실패할 때 오류를 건너뛰고 후속 단계를 계속 실행할 수 있습니다.

테스트

작업 단계 생성이 완료되면 "테스트" 버튼을 클릭하여 테스트 결과를 빠르게 검증할 수 있습니다. 테스트 작업은 비동기로 실행됩니다. 실행이 완료되면 시스템에 다음 정보가 표시됩니다.

  • 테스트 성능: 테스트 과정의 성능 지표를 표시합니다.
  • 응답 세부 정보: 문제 해결에 도움이 되는 상세한 응답 내용을 제공합니다.
  • 변수: 현재 작업의 요청 및 URL에 구성된 변수를 확인할 수 있습니다.

첫 번째 요청 작업 이후의 단계부터 테스트를 시작하는 경우, 현재 작업을 직접 테스트하거나 첫 번째 작업부터 테스트하도록 선택할 수 있습니다.

테스트가 실패하면 알 수 없는 변수가 존재할 수 있습니다. "첫 번째 단계부터 현재 요청까지 테스트" 버튼을 클릭하여 테스트를 다시 실행해 문제를 확인할 수 있습니다.

요청 단계 계속 생성

첫 번째 테스트 작업 생성 후 "HTTP 요청 생성" 또는 "대기 단계 생성"을 계속할 수 있습니다.

주의

최대 10개의 단계(HTTP 요청 및 대기 포함)를 생성할 수 있습니다.

대기 단계

특정 시간 동안 대기한 후 다음 단계를 계속 실행하는 것을 의미합니다. 대기 시간은 1초, 5초, 15초, 30초, 1분, 2분 또는 3분 중에서 선택할 수 있습니다.

작업 관리

요청 단계 생성이 완료되면 저장을 클릭합니다.

생성된 작업은 다음 방법으로 관리할 수 있습니다.

  • 작업 왼쪽의 드래그 아이콘을 클릭하면 단계 실행 순서를 변경할 수 있습니다.
  • 작업 오른쪽의 을 클릭하면 이 단계를 복제하거나 삭제할 수 있습니다.
  • "일괄"을 클릭하면 작업을 일괄 복제하거나 삭제할 수 있습니다.
주의

요청 단계를 복제할 때 로컬 변수는 함께 복제되지 않습니다.

문서 평가

이 페이지가 도움이 되었나요?