내보내기¶
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와 요청 파라미터를 제공하세요. |