호스트 관리
사용 현황 화면에 나오는 호스트는 여기서 등록합니다. 다른 서버의 사용량은 그 서버에서 띄운 collector에 접속해 가져오고, 메인 서버 자신은 별도 프로세스 없이 수집할 수 있습니다.
이 페이지 목차
위치: 관리자 > 리소스 > 호스트 관리 (/admin/resource-hosts)
화면 구성
Home › 관리자 › 리소스 › 호스트 관리
리소스 호스트
1호스트 추가대상 호스트에서 띄운 resource-collector 의 HTTP 엔드포인트로부터 GPU·CPU·디스크 사용량을 수집합니다. 동일 호스트는 'local' 로 등록하면 collector 프로세스 없이 in-process 로 수집합니다.
| 이름 | 2종류 | 3Collector URL | 주기 | 4마운트 | 5상태 | 6최종 수집 | |
|---|---|---|---|---|---|---|---|
| AI 서버 1 | 원격 (HTTP) | http://10.0.0.12:7234 | 5s | / | 정상 | 2026-10-13 14:32:05 | 7 |
| 메인 서버 | 동일 호스트 | — | 5s | / | 정상 | 2026-10-13 14:32:05 |
- 1호스트 추가 여기서 등록한 호스트가 사용 현황의 호스트 선택 목록이 됩니다.
- 2종류 원격은 다른 서버의 collector에서 수치를 가져오고, 동일 호스트는 collector 없이 메인 서버가 직접 수집합니다.
- 3Collector URL 이 주소로 접속해 수치를 가져옵니다.
- 4마운트 디스크 사용률을 이 경로 기준으로 보여 줍니다.
- 5상태 수집이 잘 되고 있는지 확인합니다.
- 6최종 수집 수집이 멈춘 것 같을 때 이 시각이 최근인지 확인합니다.
- 7수정 · 삭제 수정은 등록한 정보를 바꿀 때, 삭제는 더 이상 모니터링하지 않을 호스트를 뺄 때 씁니다.
호스트 추가 창
호스트 추가를 누르면 창이 열립니다.
호스트 추가
호스트 추가
이름
예: AI 서버 1
1호스트 종류
원격 (다른 호스트의 resource-collector 폴링)
2Collector URL
http://collector-host:7234
3인증 토큰
최소 8자
수집 주기 (초)
5
4디스크 마운트 경로
/
5대상 호스트에서 resource-collector 를 어떻게 띄우나요?
6연결 테스트취소저장
- 1호스트 종류 다른 서버는 그 서버에 띄운 collector로, aisight 서버 자체는 collector 없이 수집합니다.
- 2Collector URL 대상 호스트에 띄운 collector의 주소를 넣습니다.
- 3인증 토큰 collector를 띄울 때 정한
COLLECTOR_TOKEN값과 똑같이 넣습니다. - 4디스크 마운트 경로 디스크 사용률을 어느 경로 기준으로 볼지 정합니다.
- 5resource-collector 안내 collector를 아직 띄우지 않았다면 펼쳐서 방법을 봅니다. 내용은 아래 대상 호스트에 collector 띄우기에 정리했습니다.
- 6연결 테스트 저장하기 전에 collector에 접속되는지 확인합니다.
토큰은 암호화되어 보관됩니다
저장된 토큰은 암호화되어 DB에 보관되며 응답에는 노출되지 않습니다.
대상 호스트에 collector 띄우기
창 안의 접이식 안내 "대상 호스트에서 resource-collector 를 어떻게 띄우나요?"를 따릅니다. 요약하면 다음과 같습니다.
- resource-collector 빌드 결과물을 Node로 실행합니다.
- 시스템 정보(
/proc,nvidia-smi,df)를 읽을 수 있는 권한만 있으면 되고 root 권한은 필요 없습니다. - 실행할 때 토큰(
COLLECTOR_TOKEN), 포트(COLLECTOR_PORT, 안내 예시는 7234), 바인드 주소(COLLECTOR_HOST), 허용할 마운트 경로(COLLECTOR_ALLOW_MOUNTS)를 환경변수로 줍니다. - 동작은 curl 등으로 확인합니다. 화면 안내에 따르면 200과 JSON 응답이면 정상, 401은 토큰 불일치, 400은 마운트 경로가 허용 목록에 없는 경우, 5xx는 호스트 안에서 명령이 실패한 경우입니다.
호스트 등록하기
1. 대상 호스트에서 collector를 실행합니다
위 안내대로 토큰을 만들고 collector를 띄웁니다.
2. 호스트 추가 창을 엽니다
오른쪽 위의 호스트 추가를 누릅니다.
3. 정보를 입력합니다
이름, 호스트 종류, Collector URL, 인증 토큰, 수집 주기, 디스크 마운트 경로를 입력합니다.
4. 연결을 테스트하고 저장합니다
연결 테스트로 접속을 확인한 뒤 저장을 누릅니다.
설정 후 확인
- 목록의 상태가
정상이고 최종 수집 일시가 갱신되는지 확인합니다. - 사용 현황의 호스트 선택에 새 호스트가 나오고 값이 표시되는지 확인합니다.
Collector 주소와 토큰은 인프라 정보입니다
Collector URL에는 내부 서버 주소가 들어갑니다. 화면을 공유하거나 캡처할 때 가리세요.
마지막 수정: