본문으로 건너뛰기

워크스페이스 생성 및 관리

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

    항목설명
    알림 규칙 이름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분
    수동 새로고침새로고침 버튼 클릭 시 모니터링 결과 새로고침
    모니터링 데이터
    항목모니터링 데이터설명
    WriteIngestion Rate (Count/s)초당 수집하는 샘플 수
    WriteActive Series (Count)현재 활성화된 시계열 데이터 수
    WriteDiscarded Samples (Count/s)처리되지 않고 버려진 샘플 수
    ReadQuery Per Second (Count/s)초당 실행되는 쿼리 수
    ReadQuery Latency (Sec)쿼리가 처리되는 평균 시간
    ReadQuery Samples Scanned (Count/s)쿼리 실행 중 처리된 샘플 수
    RuleRule Evaluations (Count)분당 룰이 평가된 수
    RuleRule Evaluation Failures (Count)분당 룰이 실패한 수
    AlertActive Alerts (Counts)알림 관리에서 현재 활성 상태로 로드되고 관리 중인 모든 알림의 수
    AlertSuppressed Alerts (Counts)현재 활성화된 알림 중에서 사일런스(Silence)에 의해 억제된 알림의 수
    AlertUnprocessed 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. 워크스페이스 삭제 팝업창에서 삭제할 워크스페이스의 이름을 입력하고 [삭제] 버튼을 클릭합니다.