MCP 도구 사양 - AWS의 분산 로드 테스트
list_scenariosget_scenario_detailslist_test_runsget_test_runget_latest_test_runget_baseline_test_runget_test_run_artifacts

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

MCP 도구 사양

분산 로드 테스트 솔루션은 AI 에이전트가 테스트 시나리오 및 결과와 상호 작용할 수 있는 일련의 MCP 도구를 제공합니다. 이러한 도구는 AI 에이전트가 정보를 처리하는 방식에 맞는 상위 수준의 추상화된 기능을 제공하므로 세부 API 계약이 아닌 분석 및 인사이트에 집중할 수 있습니다.

참고

모든 MCP 도구는 솔루션 데이터에 대한 읽기 전용 액세스를 제공합니다. MCP 인터페이스를 통해 테스트 시나리오 또는 구성을 수정할 수 없습니다.

list_scenarios

설명

이 list_scenarios 도구는 기본 메타데이터를 사용하여 사용 가능한 모든 테스트 시나리오 목록을 검색합니다.

엔드포인트

GET /scenarios

Parameters

없음

응답

명칭 설명

testId

테스트 시나리오의 고유 식별자

testName

테스트 시나리오의 이름

status

테스트 시나리오의 현재 상태

startTime

테스트가 생성되거나 마지막으로 실행된 시간

testDescription

테스트 시나리오에 대한 설명

get_scenario_details

설명

get_scenario_details 도구는 단일 테스트 시나리오에 대한 테스트 구성과 최신 테스트 실행을 검색합니다.

엔드포인트

GET /scenarios/<test_id>?history=false&results=false

요청 파라미터

test_id

  • 테스트 시나리오의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

응답

명칭 설명

testTaskConfigs

각 리전에 대한 작업 구성

testScenario

테스트 정의 및 파라미터

status

현재 테스트 상태

startTime

테스트 시작 타임스탬프

endTime

테스트 종료 타임스탬프(완료된 경우)

list_test_runs

설명

list_test_runs 도구는 특정 테스트 시나리오에 대한 테스트 실행 목록을 검색하여 최신에서 최신으로 정렬합니다. 최대 30개의 결과를 반환합니다.

엔드포인트

GET /scenarios/<testid>/testruns/?limit=<limit>

or

GET /scenarios/<testid>/testruns/?limit=30&start_date=<start_date>&end_date=<end_date>

요청 파라미터

test_id

  • 테스트 시나리오의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

limit

  • 반환할 최대 테스트 실행 수

    유형: 정수

    기본값: 20

    최대: 30

    필수 여부: 아니요

start_date

  • 특정 날짜부터 실행을 필터링하는 ISO 8601 타임스탬프

    유형: 문자열(날짜-시간 형식)

    필수 여부: 아니요

end_date

  • 특정 날짜까지 실행을 필터링하는 ISO 8601 타임스탬프

    유형: 문자열(날짜-시간 형식)

    필수 여부: 아니요

응답

명칭 설명

testRuns

각 실행에 대한 성능 지표 및 백분위수가 포함된 테스트 실행 요약 배열

get_test_run

설명

이 get_test_run 도구는 리전 및 엔드포인트 분석을 통해 단일 테스트 실행에 대한 자세한 결과를 검색합니다.

엔드포인트

GET /scenarios/<testid>/testruns/<testrunid>

요청 파라미터

test_id

  • 테스트 시나리오의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

test_run_id

  • 특정 테스트 실행의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

응답

명칭 설명

results

리전별 결과 분석, 엔드포인트별 지표, 성능 백분위수(p50, p90, p95, p99), 성공 및 실패 수, 응답 시간 및 지연 시간, 실행에 사용되는 테스트 구성을 포함한 전체 테스트 실행 데이터

get_latest_test_run

설명

get_latest_test_run 도구는 특정 테스트 시나리오에 대한 최신 테스트 실행을 검색합니다.

엔드포인트

GET /scenarios/<testid>/testruns/?limit=1

참고

결과는 글로벌 보조 인덱스(GSI)를 사용하여 시간별로 정렬되므로 가장 최근의 테스트 실행이 반환됩니다.

요청 파라미터

test_id

  • 테스트 시나리오의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

응답

명칭 설명

results

와 동일한 형식의 최신 테스트 실행 데이터 get_test_run

get_baseline_test_run

설명

get_baseline_test_run 도구는 특정 테스트 시나리오에 대한 기준 테스트 실행을 검색합니다. 기준은 성능 비교 목적으로 사용됩니다.

엔드포인트

GET /scenarios/<test_id>/baseline

요청 파라미터

test_id

  • 테스트 시나리오의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

응답

명칭 설명

baselineData

지정된 기준 실행의 모든 지표 및 구성을 포함하여 비교를 위한 기준 테스트 실행 데이터

get_test_run_artifacts

설명

이 get_test_run_artifacts 도구는 로그, 오류 파일 및 결과를 포함한 테스트 아티팩트에 액세스하기 위한 Amazon S3 버킷 정보를 검색합니다.

엔드포인트

GET /scenarios/<testid>/testruns/<testrunid>

요청 파라미터

test_id

  • 테스트 시나리오의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

test_run_id

  • 특정 테스트 실행의 고유 식별자

    유형: 문자열

    필수 항목 여부: 예

응답

명칭 설명

bucketName

아티팩트가 저장되는 S3 버킷 이름

testRunPath

현재 아티팩트 스토리지의 경로 접두사(버전 4.0 이상)

testScenarioPath

레거시 아티팩트 스토리지의 경로 접두사(버전 4.0 이전)
참고

모든 MCP 도구는 기존 API 엔드포인트를 활용합니다. MCP 기능을 지원하기 위해 기본 APIs를 수정할 필요가 없습니다.