콘텐츠로 이동

내보내기



GET /api/v1/service_manage/performance/export

개요

현재 워크스페이스의 서비스 성능 통계를 CSV로 동기 내보냅니다.

호출 전 및 사용 단계

내보낼 기간을 입력한 후 GET을 호출합니다. 성공 시 응답 본문은 code/content JSON 래퍼 없이 CSV 텍스트로 직접 반환됩니다. 이 API는 해당 기간의 모든 통계 대상 서비스를 내보내며, 목록 filters, order 또는 페이지네이션 파라미터를 받지 않습니다. p99 기준 내림차순으로 정렬됩니다. 열 제목은 워크스페이스 언어에 따라 달라지며, 중국어 워크스페이스에서는 기본적으로 아래 표의 열 순서로 출력됩니다. 소요 시간은 CSV에서 이미 변환되어 표시 단위와 함께 제공되며, 오류 수에는 백분율이 포함됩니다. 먼저 HTTP 상태와 Content-Type을 확인한 후 CSV로 파싱하세요. 실패 응답은 여전히 JSON일 수 있습니다. 예시에서는 --output으로 로컬 파일 이름을 지정합니다.

요청 헤더

파라미터 이름 유형 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예: <DF-API-KEY>
가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

Query 요청 파라미터

파라미터 이름 유형 필수 설명
end integer Y 조회 종료 시간이며 Unix 밀리초 단위입니다. start와 동일한 시간 기준을 사용합니다.
예: 1785430800000
가져오기 또는 입력 방법: 조회 종료 시점의 Unix 밀리초 정수를 사용합니다. 예를 들어 JavaScript Date.getTime()의 결과입니다.
start integer Y 조회 시작 시간이며 Unix 밀리초 단위입니다. end와 함께 실제로 필요한 통계 기간을 구성하는 것이 좋습니다.
예: 1785427200000
가져오기 또는 입력 방법: 콘솔 시간 선택기 또는 업무 기록에 따라 조회 시작 시점을 가져와 Unix 밀리초 정수로 변환합니다. 예시 시간은 자신의 조회 기간으로 바꿔야 합니다.

파라미터 추가 설명

데이터가 없어도 헤더를 반환할 수 있습니다. API에는 고정된 Content-Disposition 다운로드 파일 이름이 없습니다. CSV는 각 값을 큰따옴표로 감싸며, 큰따옴표나 줄바꿈이 포함된 비즈니스 텍스트는 타사 파싱에 영향을 줄 수 있습니다. 엄격한 이스케이프 요구 사항이 있으면 JSON 목록으로 전환해 CSV를 직접 인코딩할 수 있습니다.

요청 예시

curl --get 'https://openapi.guance.com/api/v1/service_manage/performance/export' \
  -H 'DF-API-KEY: <DF-API-KEY>' \
  --data-urlencode start=1785427200000 \
  --data-urlencode end=1785430800000 \
  --output service-performance.csv

응답

HTTP 200, Content-Type: text/csv. 응답 본문은 CSV 텍스트이며, 다음 필드 표는 기본 중국어 열을 설명합니다.

필드 유형 설명
서비스 string 수집된 서비스 이름입니다.
총 요청 수 string 총 요청 횟수입니다.
평균 요청 수 string 평균 요청 빈도이며 req/s 단위가 포함됩니다.
평균 응답 시간 string 형식화된 평균 응답 시간이며 ms 등의 단위가 포함됩니다.
P75 응답 시간 string P75 응답 시간이며 표시 단위가 포함됩니다.
P99 응답 시간 string P99 응답 시간이며 표시 단위가 포함됩니다.
오류 수 string 오류 횟수 및 백분율입니다. 예: 12(1.0)%.
팀 string 서비스 설정의 Team.team이며 비어 있을 수 있습니다.
모니터 수 string 연결된 모니터 수입니다.
서비스 상태 string 서비스의 현재 상태이며 기본값은 ok입니다.
최대 응답 시간 string 가장 긴 응답 시간이며 표시 단위가 포함됩니다.
언어 string 등록된 수집 SDK 언어입니다.
Apdex 만족도 string Apdex 값이며 제공되지 않은 경우 비어 있을 수 있습니다.
응답 헤더 유형 설명
Content-Type string 성공 시 text/csv입니다.
"服务","请求总数","平均请求数","平均响应时间","P75响应时间","P99响应时间","错误数","团队","监控器数量","服务状态","最大响应时间","语言","Apdex满意度"
"checkout-api","1200","0.33 req/s","25.0 ms","25.0 ms","120.0 ms","12(1.0)%","","0","ok","150.0 ms","python",""

오류 응답

인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.

성공 시 text/csv이며, 인증, 파라미터 및 조회 실패 시 공통 JSON 오류 구조를 사용합니다.

HTTP 상태 errorCode 발생 조건 메시지 또는 응답 설명 처리 방법
406 ft.ParameterValidationFailed 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반함 파라미터 파싱 실패 파라미터 위치, 필드 이름, 유형 및 값을 확인하세요.
422 ft.KodoAPMSummaryRowBudgetExceeded 서비스 통계 집계 스캔 예산 초과 APM 서비스 요약 데이터 양이 처리 상한을 초과했습니다. 시간 범위를 줄인 후 다시 시도하세요. 시간 범위를 줄이세요. pageSize를 줄여도 전체 서비스 집계 예산은 감소하지 않습니다.
429 ft.KodoServerOverloaded 조회 서비스 과부하 또는 사용 중 현재 요청이 너무 많습니다. 잠시 후 다시 시도하세요. 백오프 간격으로 재시도하고 동시 조회 수를 줄이세요.
500 ft.InternalServerError 통계 서비스 사용 불가, 연결 시간 초과 또는 기타 전달되지 않은 내부 조회 예외 내부 오류 잠시 후 다시 시도하거나 시간 범위를 줄이세요. 계속 실패하면 traceId와 요청 파라미터를 제공하세요.
406 ft.KodoRequestDeadlineExceeded 조회 실행이 백엔드에서 허용된 시간을 초과함 데이터 조회 시간이 초과되었습니다. 원인은 다음과 같을 수 있습니다: 데이터 양이 너무 많음, 네트워크 지연, 서버 부하 과다. 다음 방법으로 문제를 해결할 수 있습니다:
1. 필터 조건을 추가하거나 시간 범위를 줄인 후 다시 조회하세요.
2. 잠시 기다린 후 다시 조회하세요.
내보내기 시간 범위를 줄인 후 다시 시도하세요. 계속 실패하면 traceId와 요청 파라미터를 제공하세요.
406 ft.KodoTooManyRows 조회 데이터 양이 백엔드 제한을 초과함 조회한 데이터 양이 최대 수량 제한을 초과했습니다. 필터 조건을 추가하거나 시간 범위를 줄인 후 다시 조회하세요. 내보내기 시간 범위를 줄인 후 다시 시도하세요. 계속 실패하면 traceId와 요청 파라미터를 제공하세요.

문서 평가

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