대시보드
~
사용자별 사용량
장비 그룹별 시간대별 사용량
서비스 영향도 (상태)
전송/로그인 실패 건수
최근 이상 알림
시각(KST)장비지표심각도값평소내용
-
로그 조회
~
기본 조회 3개월, 이상 조회 시 날짜 지정 후 진행
시간업로드 장비사용자사용자 IP작업 파일 경로크기전송시간상태
검색 조건을 입력하고 조회하세요.
API 가이드
인증

모든 요청에 API 키가 필요합니다. 키는 관리자가 설정 > 고객 계정 > API 키에서 발급합니다.

방법 1 — X-API-Key 헤더 (권장)
방법 2 — Authorization 헤더
  • 조회 전용입니다. GET 외의 요청은 403으로 거부됩니다.
  • 권한 범위는 키를 발급한 계정과 같습니다. 고객 계정 키는 해당 고객사의 장비 데이터만 조회됩니다.
  • 키는 발급 시 한 번만 표시됩니다. 분실하면 재발급해야 합니다.
  • 요청 한도는 분당 60회이며, 초과하면 503이 반환됩니다.
엔드포인트
경로설명
로그 조회 파라미터
이름예시설명
오류 응답
코드의미
사용 예시
설정
통신사 목록
  • 불러오는 중…
비밀번호 변경
접속 허용 IP
현재 접속 IP: -
한 줄에 하나씩. CIDR 대역 가능. 비워두면 모든 IP 허용.
예: 192.168.1.0/24, 10.0.0.5
저장 전 현재 IP 포함 여부를 확인하세요.
시스템 업데이트 (git)
브랜치
-
현재 커밋
-
커밋 일시
-
메시지
-
상태
-
업데이트 시 origin/main을 받아 재배포하며, 서비스가 1~2분간 재시작됩니다.
DB 저장소 현황
데이터베이스 전체
-
ftp_logs (전체 파티션)
-
보존 기간
-
default 파티션
-
행 수는 통계 추정치입니다. default 파티션에 행이 남아 있으면 해당 월 파티션이 만들어지지 않고 보존기간 정리에서도 제외되므로 scripts/rebalance_default_partition.sql 로 재배치하세요.
월별 파티션
파티션행 수(추정)테이블인덱스합계
불러오는 중…
장비 관리
호스트명IP장비상태데몬상태 CPU / MEM / Disk버퍼 마지막 연결그룹
로딩 중...
그룹 관리
로딩 중...
알림 설정
발송 중
웹훅
HMS 메일 게이트웨이
이상 감지 임계값
클수록 둔감해져 알림이 줄어듭니다.
평소 대비 이 비율 이상 떨어지면 알림 (0.5 = 50%↓)
아래 기준 크기 이상 전송이 이 건수 미만이면 속도 판정을 건너뜁니다.
원인이 밝혀진 경로(홈·업로드 경로 설정 오류 등)를 CWD 실패 집계에서만 뺍니다. 로그 조회에는 그대로 남습니다. 최근 2시간 버킷은 다음 판정 주기에 다시 집계됩니다.
전송 속도 판정 기준 크기
-
집계 버킷 / baseline
-
작은 파일은 연결·인증 오버헤드가 전송시간의 대부분이라 실효속도가 낮게 나옵니다. 전송 속도 판정은 기준 크기 이상의 성공한 전송만 사용하므로, 소량 파일을 대량 업로드해도 속도 저하로 오인하지 않습니다. 이 두 값은 .env 에서만 변경합니다(재배포 필요).
고객 계정 추가
고객 계정 목록
아이디고객사허용 IP상태작업
불러오는 중…
API 키 (조회 전용)
키가 발급되었습니다 — 지금 복사하세요. 이 화면을 벗어나면 다시 볼 수 없습니다.
키계정메모마지막 사용만료상태작업
불러오는 중…
키는 조회(GET)만 가능하며 권한 범위는 소유 계정과 같습니다 (고객 계정 키는 해당 고객사 데이터만 보입니다). 사용 예:
curl -H "X-API-Key: slt_..." https://<주소>/api/v1/logs?size=50