워크스페이스 생성 및 관리

Advanced Managed Prometheus의 워크스페이스는 데이터 관리와 모니터링의 기본 단위로, 각 워크스페이스에서 데이터를 독립적으로 관리할 수 있습니다. 워크스페이스를 생성하고 사용하는 방법은 다음과 같습니다.

워크스페이스 생성

신규 워크스페이스를 생성합니다. 환경에 따라 워크스페이스 생성 시 약 1분 정도 소요될 수 있습니다.

1. 카카오클라우드 콘솔 > Management > Advanced Managed Prometheus 메뉴로 이동합니다.

2. 워크스페이스 메뉴에서 우측 상단에 위치한 [워크스페이스 생성] 버튼을 클릭합니다.

3. 워크스페이스 이름을 입력하고 [생성] 버튼을 클릭합니다.

   구분	설명
   워크스페이스 이름	생성할 워크스페이스의 이름 - 같은 프로젝트 내에서 중복된 워크스페이스 이름 사용 불가 (영어 대문자, 소문자, 숫자, 하이픈(-)만 입력 가능) - 예시: workspace-1

워크스페이스 관리

워크스페이스 목록 조회

프로젝트 내에 생성한 워크스페이스 목록을 조회할 수 있습니다.

1. 카카오클라우드 콘솔 > Management > Advanced Managed Prometheus 메뉴로 이동합니다.
2. 워크스페이스 메뉴에서 현재 생성된 워크스페이스 목록을 확인합니다.

   항목	설명	비고
   이름	워크스페이스 생성 시 사용자가 지정한 이름	워크스페이스 이름을 클릭해 상세 정보 확인 가능
   ID	워크스페이스 고유 ID	워크스페이스 생성 시 자동 부여
   생성자	워크스페이스 생성을 요청한 사용자
   생성일시	워크스페이스 생성 일시

워크스페이스 정보 조회

프로젝트 내 생성한 워크스페이스 정보를 확인할 수 있습니다.

1. 카카오클라우드 콘솔 > Management > Advanced Managed Prometheus 메뉴로 이동합니다.

2. 워크스페이스 메뉴에서 상세 정보를 확인할 클러스터 이름을 클릭합니다.

3. 탭에서 상세 정보를 확인합니다.

   상단 정보

   항목	설명
   생성자	워크스페이스 생성을 요청한 사용자
   생성일시	워크스페이스 생성 일시

   세부 정보 탭

   항목	설명
   워크스페이스 이름	워크스페이스 생성 시 사용자가 지정한 이름
   워크스페이스 ID	워크스페이스 생성 시 자동으로 부여되는 고유 ID
   Write 엔드포인트	Prometheus 에이전트 또는 서버가 수집한 메트릭 데이터를 클라우드 스토리지에 기록하기 위한 API
   Read 엔드포인트	저장된 메트릭 데이터를 조회하고 분석 도구(Grafana 등)에서 사용할 수 있도록 제공되는 API

   알림 정책 탭

   워크스페이스에 설정된 알림 정책을 확인할 수 있습니다. 알림 정책은 Alert Center를 통해서만 설정 가능하며, 알림 정책 설정 방법에 대한 자세한 설명은 Alert Center > 알림 정책 생성 및 관리를 참고하시기 바랍니다.

   항목	설명
   알림 정책 이름	알림 정책 생성 시 사용자가 지정한 이름
   룰 파일 이름	알림 정책 생성 시 사용자가 업로드한 룰 파일 이름
   마지막 알림 발생 일시	해당 알림 정책에 의해 마지막 알림이 발송된 시간 정보

   모니터링 탭

   구분	설명
   데이터 기간	모니터링 그래프에 표시할 데이터 기간 - 1시간 전(기본값) / 3시간 전 / 12시간 전 / 1일 전 / 7일 전
   조회 항목	모니터링 조회 항목 선택 - Write / Read / Rule - 전체 선택(기본값) - 항목 복수 선택 가능
   보기 모드	모니터링 그래프 보기 모드 설정 - 1단 보기, 2단 보기, 3단 보기 제공
   자동 새로고침 주기	자동 새로고침 주기 설정 - 자동 새로고침 안 함(기본값) / 10초 / 30초 / 1분 / 5분
   수동 새로고침	새로고침 버튼 클릭 시 모니터링 결과 새로고침

   모니터링 데이터

   항목	모니터링 데이터	설명
   Write	Ingestion Rate (Count/s)	초당 수집하는 샘플 수
   Write	Active Series (Count)	현재 활성화된 시계열 데이터 수
   Write	Discarded Samples (Count/s)	처리되지 않고 버려진 샘플 수
   Read	Query Per Second (Count/s)	초당 실행되는 쿼리 수
   Read	Query Latency (Sec)	쿼리가 처리되는 평균 시간
   Read	Query Samples Scanned (Count/s)	쿼리 실행 중 처리된 샘플 수
   Rule	Rule Evaluations (Count)	분당 룰이 평가된 수
   Rule	Rule Evaluation Failures (Count)	분당 룰이 실패한 수

   Discarded Samples 범례 종류

   Discarded Samples의 범례에는 실패 사유에 따른 경고 메시지가 노출됩니다.

   항목	설명
   greater_than_max_sample_age	너무 오래된 샘플이 수집되어 폐기됨
   new-value-for-timestamp	샘플이 동일한 타임스탬프를 가지지만 서로 다른 값을 포함하고 있음
   per_metric_series_limit	메트릭당 활성 시리즈 수 제한을 초과함 (Max:200,000)
   per_user_series_limit	사용자당 활성 시리즈 수 제한을 초과함 (Max:10,000,000)
   rate_limited	샘플 처리량 한계에 도달함 (Max: 초당 170,000)
   sample-out-of-order	샘플이 시간 순서대로 전송되지 않아 처리 불가함
   label_value_too_long	레이블 값이 허용된 최대 길이를 초과함 (Max: 2048자)
   max_label_names_per_series	시리즈당 레이블 수 제한을 초과 (Max:70)
   missing_metric_name	메트릭 이름이 제공되지 않음
   metric_name_invalid	잘못된 메트릭 이름이 제공됨
   label_invalid	잘못된 레이블이 제공됨
   duplicate_label_names	중복된 레이블 이름이 제공됨

워크스페이스 수정

안내

워크스페이스는 생성 시 부여된 고유 ID와 엔드포인트는 수정 불가하며, 워크스페이스 이름만 수정 가능합니다.

1. 카카오클라우드 콘솔 > Management > Advanced Managed Prometheus 메뉴로 이동합니다.

2. 워크스페이스 메뉴에서 우측 상단에 위치한 [수정] 버튼을 클릭합니다.

3. 워크스페이스 이름을 수정하고 [저장] 버튼을 클릭합니다.

   구분	설명
   워크스페이스 이름	생성할 워크스페이스의 이름 - 같은 프로젝트 내에서 중복된 워크스페이스 이름 사용 불가 (영어 대문자, 소문자, 숫자, 하이픈(-)만 입력 가능) - 예시: workspace-1

워크스페이스 삭제

더 이상 사용하지 않는 워크스페이스를 삭제할 수 있습니다.

caution

삭제한 워크스페이스에 저장된 메트릭은 복구할 수 없으니 주의하시기 바랍니다.

1. 카카오클라우드 콘솔 > Management > Advanced Managed Prometheus 메뉴로 이동합니다.

2. 워크스페이스 메뉴에서 우측 상단에 위치한 [삭제] 버튼을 클릭합니다.

3. 워크스페이스 삭제 팝업창에서 삭제할 워크스페이스의 이름을 입력하고 [삭제] 버튼을 클릭합니다.