모니터링 - Cloosphere Guide

관리자 › 설정 › 모니터링

이 페이지는 외부 관측성(observability) 스택 연동 설정입니다. 사용량·로그를 화면에서 바로 보는 모니터링 탭과는 다릅니다.

OpenTelemetry(OTEL)를 활성화하면 Cloosphere의 지표·로그·트레이스를 외부 모니터링 스택으로 내보낼 수 있습니다. Prometheus·Grafana·Loki·OTEL Collector로 구성된 배포 패키지를 제공합니다.

OpenTelemetry 활성화

OpenTelemetry 활성화 토글을 켜면 OTEL 기반 텔레메트리 수집·내보내기가 시작됩니다.

모니터링 서버에 배포할 설정 패키지(Prometheus·Grafana·Loki·OTEL Collector)를 내려받아 설치합니다.

패키지 다운로드

curl -H "Authorization: Bearer <API_KEY>" \
  "https://<your-host>/api/v1/configs/monitoring/download" \
  -o cloosphere-monitor.tar.gz

<API_KEY>는 좌측 하단 프로필 아이콘 → 설정 → 계정 → API 키에서 확인합니다. 화면의 브라우저에서 직접 다운로드 버튼을 써도 됩니다.

압축 해제

tar xzf cloosphere-monitor.tar.gz && cd cloosphere-monitor

환경 변수 확인

cat .env

서버 설정이 자동으로 반영되어 있습니다.

설정 스크립트 실행

./setup.sh