워크스페이스 생성 및 관리

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

워크스페이스 생성

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

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

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

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

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

튜토리얼 안내

워크스페이스 생성 후 메트릭 수집과 시각화 구성을 실습하는 흐름은 다음 튜토리얼에서 확인할 수 있습니다.

• OpenSearch Dashboards와 Advanced Managed Prometheus 연동: OpenSearch Dashboards 연동
• Prometheus를 활용한 Kafka 컨슈머 Lag 모니터링: Kafka Consumer Lag 수집
• 카카오클라우드의 그라파나 대시보드 템플릿 활용: Grafana 대시보드 구성

워크스페이스 관리

워크스페이스 목록 조회

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

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 > 알림 정책 생성 및 관리를 참고하시기 바랍니다.

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

   알림 관리

   알림 관리는 워크스페이스에서 발생한 알림을 수신해 동일 알림의 재발송 간격 등을 관리하며, 중요한 알림만 최종 알림 채널로 전달하는 역할을 합니다.
   현재는 repeat_interval 기능만 지원되며, 그룹화(group_by)를 포함한 다양한 처리 기능들은 추후 제공될 예정입니다.

   알림 관리는 워크스페이스 생성 시 기본적으로 설정되어 있으며, 사용자는 설정을 통해 수정 또는 필요에 따라 미설정으로 변경할 수 있습니다.
   (단, 미설정으로 변경 시 프로메테우스에서 발생하는 알림을 수신할 수 없습니다.)

   1. [설정] 버튼을 클릭하여 > 알림 관리 설정 페이지로 이동합니다.

   2. [파일 업로드] 또는 [직접 수정]을 통해 설정 값을 변경합니다.

      알림 관리 기본 설정 값

      route:
          receiver: "default"
          group_by: ["..."]
          repeat_interval: "30m"

      항목	설명
      route	수신된 알림을 어떤 규칙과 처리에 따라 보낼지 정의하는 영역
      receiver	알림을 수신할 대상을 정의하는 영역 (Alert Center와 연동) - 수정 불가 영역
      group_by	관련 알림들을 그룹으로 묶을 레이블 설정 - 수정 불가 영역
      repeat_interval	동일 알림이 반복 발생하는 경우, 지정한 간격에 따라 알림 재발송 - 수정 가능 영역

   3. [저장] 버튼을 클릭합니다.

   모니터링 탭

   구분	설명
   데이터 기간	모니터링 그래프에 표시할 데이터 기간 - 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)	분당 룰이 실패한 수
   Alert	Active Alerts (Counts)	알림 관리에서 현재 활성 상태로 로드되고 관리 중인 모든 알림의 수
   Alert	Suppressed Alerts (Counts)	현재 활성화된 알림 중에서 사일런스(Silence)에 의해 억제된 알림의 수
   Alert	Unprocessed Alerts (Counts)	알림 관리에서 아직 처리되지 않고 그룹 평가(group evaluation)를 기다리고 있는 알림의 수

   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

워크스페이스 삭제

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

주의

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

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

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

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