이력 데이터 내보내기

이력 내보내기는 백그라운드에서 파일을 생성하므로 원본 상세 데이터를 저장하거나 다른 도구에서 분석하기에 적합하며, 브라우저에서 조회 완료를 계속 기다릴 필요가 없습니다.

내보내기 절차

1. 데이터 포인트와 시간 범위를 선택합니다. 공유 데이터 포인트에는 원본 장치를 지정해야 합니다.
2. 예상 디스크 사용량을 확인한 후 내보내기 작업을 생성합니다.
3. 작업 목록에서 대기, 실행, 완료 또는 실패 상태를 확인합니다. 더 이상 필요하지 않으면 취소할 수 있습니다.
4. 완료 후 단기 다운로드 자격 증명을 받아 CSV 또는 ZIP 파일을 다운로드합니다.

작업에는 시간 범위, 파일 크기, 동시 실행 수 및 디스크 여유 공간 제한이 적용됩니다. 공간이 부족하면 내보내기를 거부하거나 중지하며, 구체적인 제한은 장치 설정을 기준으로 합니다.

파일 및 데이터

• 수집, 집계 및 공유 이력 값을 지원합니다. 같은 장치의 같은 데이터 포인트를 중복 선택하지 않습니다.
• CSV는 null 표시를 보존하여 “데이터 없음”과 빈 문자열을 구분합니다.
• 다운로드 자격 증명에는 유효 기간이 있으며, 만료되면 다시 받아야 합니다. 공개적으로 공유하지 마세요.
• 지정 범위에서 아직 보존된 데이터를 내보내며, 보존 정책에 따라 이미 삭제된 이력은 복구할 수 없습니다.

통합 인터페이스

작업	인터페이스
용량 예상	GET /ems-data/export/disk-space
작업 생성 / 목록 조회	POST /ems-data/export/tasks / GET /ems-data/export/tasks
개별 작업 조회 / 취소	GET /ems-data/export/tasks/:taskId / DELETE /ems-data/export/tasks/:taskId
다운로드 자격 증명 발급	POST /ems-data/export/tasks/:taskId/download-ticket

작업 생성 시 format(CSV 또는 CSV_ZIP), dataKeys, startTime 및 endTime를 전달합니다. 작업이 성공해야 다운로드할 수 있으며, 요청 수락이 파일 생성을 의미하지는 않습니다.

임시 분석에는 이력 조회, 지속적인 저장에는 주기적 아카이브, 설정 이전에는 백업 및 복원을 사용합니다. Agent 호출 방식은 내보내기 Skill을 참조하세요.