집계 테이블 설계
테이블 (8)
단계별 실행 이력 (cb_batch_step)
- step_id — bigint — 기본 키 — NOT NULL — 작업 단계 이력 고유 식별자 / AUTO_INCREMENT
- job_id — varchar(100) — 외래 키 → 집계 실행 Job.job_id — NOT NULL — 이 단계를 실행한 상위 집계 작업 식별자 / 논리 참조만 표시 / 실제 FK 없음
- step_name — varchar(80) — NOT NULL — 실행 단계 이름(지표 코드 또는 처리 단계)
- status — varchar(30) — NOT NULL — 해당 단계의 실행 상태
- started_at — datetime(6) — 실행 시작 시각
- ended_at — datetime(6) — 실행 종료 시각
- input_count — bigint — NOT NULL — 해당 실행에서 처리한 입력 건수
- output_count — bigint — NOT NULL — 해당 실행에서 저장한 결과 건수
- error_message — text — 실행 오류 또는 경고 상세 내용
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
시간 통계 · 원천 집계 (cb_metric_stat_hourly)
- stat_id — bigint — 기본 키 — NOT NULL — 기간별 통계 행 고유 식별자 / AUTO_INCREMENT
- period_start_at — datetime(6) — NOT NULL — 통계 기간 시작 시각(UTC, 포함)
- period_end_at — datetime(6) — NOT NULL — 통계 기간 종료 시각(UTC, 미포함)
- event_resource_id — bigint — 집계 대상 이벤트 자원 식별자
- provider_id — bigint — NOT NULL — 집계 대상 공급자 식별자
- nova_id — varchar(255) — NOT NULL — 공급자의 OpenStack 환경 식별자
- resource_type_id — bigint — 집계 대상 자원 유형 식별자
- resource_type — varchar(40) — NOT NULL — 자원 종류(호스트·가상머신 등)
- resource_id — varchar(100) — NOT NULL — 집계 대상 자원 식별자
- resource_uuid — varchar(255) — 집계 대상 자원의 UUID
- metric_code — varchar(100) — 외래 키 → 지표 정의.metric_code — NOT NULL — 집계 지표 고유 코드 / 논리 참조만 표시 / 실제 FK 없음
- dimension_type — varchar(32) — NOT NULL — 세부 집계 차원 종류(디스크·인터페이스 등)
- dimension_value — varchar(100) — NOT NULL — 세부 집계 차원 값(디스크명·인터페이스명 등)
- metric_unit — varchar(30) — NOT NULL — 저장된 통계 값의 단위
- minimum_value — double — 유효 표본의 최솟값
- maximum_value — double — 유효 표본의 최댓값
- average_value — double — 유효 표본의 평균값
- median_value — double — 유효 표본의 중앙값
- sum_value — double — 유효 표본 값의 합계
- sample_count — bigint — NOT NULL — 수치 집계에 반영한 유효 표본 수
- expected_sample_count — bigint — 대상 기간에 기대하는 표본 수
- sample_ratio — decimal(10,9) — 유효 표본 수를 기대 표본 수로 나눈 비율
- quality_status — varchar(50) — NOT NULL — 통계 품질 상태(정상·부분 표본·무데이터·유효하지 않음)
- fallback_reason — varchar(255) — 대체값 보정 사유(시계열 없음·QGA 사용 불가 등)
- source_job_id — varchar(100) — 외래 키 → 집계 실행 Job.job_id — 이 통계 결과를 생성한 집계 작업 식별자 / 논리 참조만 표시 / 실제 FK 없음
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
- updated_at — datetime(6) — NOT NULL — 행 최종 수정 시각 / ON UPDATE CURRENT_TIMESTAMP(6)
월 통계 · Hourly 롤업 (cb_metric_stat_monthly)
- stat_id — bigint — 기본 키 — NOT NULL — 기간별 통계 행 고유 식별자 / AUTO_INCREMENT
- period_start_at — datetime(6) — NOT NULL — 통계 기간 시작 시각(UTC, 포함)
- period_end_at — datetime(6) — NOT NULL — 통계 기간 종료 시각(UTC, 미포함)
- event_resource_id — bigint — 집계 대상 이벤트 자원 식별자
- provider_id — bigint — NOT NULL — 집계 대상 공급자 식별자
- nova_id — varchar(255) — NOT NULL — 공급자의 OpenStack 환경 식별자
- resource_type_id — bigint — 집계 대상 자원 유형 식별자
- resource_type — varchar(40) — NOT NULL — 자원 종류(호스트·가상머신 등)
- resource_id — varchar(100) — NOT NULL — 집계 대상 자원 식별자
- resource_uuid — varchar(255) — 집계 대상 자원의 UUID
- metric_code — varchar(100) — 외래 키 → 지표 정의.metric_code — NOT NULL — 집계 지표 고유 코드 / 논리 참조만 표시 / 실제 FK 없음
- dimension_type — varchar(32) — NOT NULL — 세부 집계 차원 종류(디스크·인터페이스 등)
- dimension_value — varchar(100) — NOT NULL — 세부 집계 차원 값(디스크명·인터페이스명 등)
- metric_unit — varchar(30) — NOT NULL — 저장된 통계 값의 단위
- minimum_value — double — 유효 표본의 최솟값
- maximum_value — double — 유효 표본의 최댓값
- average_value — double — 유효 표본의 평균값
- median_value — double — 시간 통계 중앙값들의 중앙값(전체 원시 표본 중앙값과 다를 수 있음)
- sum_value — double — 유효 표본 값의 합계
- sample_count — bigint — NOT NULL — 수치 집계에 반영한 유효 표본 수
- expected_sample_count — bigint — 대상 기간에 기대하는 표본 수
- sample_ratio — decimal(10,9) — 유효 표본 수를 기대 표본 수로 나눈 비율
- quality_status — varchar(50) — NOT NULL — 통계 품질 상태(정상·부분 표본·무데이터·유효하지 않음)
- fallback_reason — varchar(255) — 대체값 보정 사유(시계열 없음·QGA 사용 불가 등)
- source_job_id — varchar(100) — 외래 키 → 집계 실행 Job.job_id — 이 통계 결과를 생성한 집계 작업 식별자 / 논리 참조만 표시 / 실제 FK 없음
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
- updated_at — datetime(6) — NOT NULL — 행 최종 수정 시각 / ON UPDATE CURRENT_TIMESTAMP(6)
일 통계 · Hourly 롤업 (cb_metric_stat_daily)
- stat_id — bigint — 기본 키 — NOT NULL — 기간별 통계 행 고유 식별자 / AUTO_INCREMENT
- period_start_at — datetime(6) — NOT NULL — 통계 기간 시작 시각(UTC, 포함)
- period_end_at — datetime(6) — NOT NULL — 통계 기간 종료 시각(UTC, 미포함)
- event_resource_id — bigint — 집계 대상 이벤트 자원 식별자
- provider_id — bigint — NOT NULL — 집계 대상 공급자 식별자
- nova_id — varchar(255) — NOT NULL — 공급자의 OpenStack 환경 식별자
- resource_type_id — bigint — 집계 대상 자원 유형 식별자
- resource_type — varchar(40) — NOT NULL — 자원 종류(호스트·가상머신 등)
- resource_id — varchar(100) — NOT NULL — 집계 대상 자원 식별자
- resource_uuid — varchar(255) — 집계 대상 자원의 UUID
- metric_code — varchar(100) — 외래 키 → 지표 정의.metric_code — NOT NULL — 집계 지표 고유 코드 / 논리 참조만 표시 / 실제 FK 없음
- dimension_type — varchar(32) — NOT NULL — 세부 집계 차원 종류(디스크·인터페이스 등)
- dimension_value — varchar(100) — NOT NULL — 세부 집계 차원 값(디스크명·인터페이스명 등)
- metric_unit — varchar(30) — NOT NULL — 저장된 통계 값의 단위
- minimum_value — double — 유효 표본의 최솟값
- maximum_value — double — 유효 표본의 최댓값
- average_value — double — 유효 표본의 평균값
- median_value — double — 시간 통계 중앙값들의 중앙값(전체 원시 표본 중앙값과 다를 수 있음)
- sum_value — double — 유효 표본 값의 합계
- sample_count — bigint — NOT NULL — 수치 집계에 반영한 유효 표본 수
- expected_sample_count — bigint — 대상 기간에 기대하는 표본 수
- sample_ratio — decimal(10,9) — 유효 표본 수를 기대 표본 수로 나눈 비율
- quality_status — varchar(50) — NOT NULL — 통계 품질 상태(정상·부분 표본·무데이터·유효하지 않음)
- fallback_reason — varchar(255) — 대체값 보정 사유(시계열 없음·QGA 사용 불가 등)
- source_job_id — varchar(100) — 외래 키 → 집계 실행 Job.job_id — 이 통계 결과를 생성한 집계 작업 식별자 / 논리 참조만 표시 / 실제 FK 없음
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
- updated_at — datetime(6) — NOT NULL — 행 최종 수정 시각 / ON UPDATE CURRENT_TIMESTAMP(6)
주 통계 · Hourly 롤업 (cb_metric_stat_weekly)
- stat_id — bigint — 기본 키 — NOT NULL — 기간별 통계 행 고유 식별자 / AUTO_INCREMENT
- period_start_at — datetime(6) — NOT NULL — 통계 기간 시작 시각(UTC, 포함)
- period_end_at — datetime(6) — NOT NULL — 통계 기간 종료 시각(UTC, 미포함)
- event_resource_id — bigint — 집계 대상 이벤트 자원 식별자
- provider_id — bigint — NOT NULL — 집계 대상 공급자 식별자
- nova_id — varchar(255) — NOT NULL — 공급자의 OpenStack 환경 식별자
- resource_type_id — bigint — 집계 대상 자원 유형 식별자
- resource_type — varchar(40) — NOT NULL — 자원 종류(호스트·가상머신 등)
- resource_id — varchar(100) — NOT NULL — 집계 대상 자원 식별자
- resource_uuid — varchar(255) — 집계 대상 자원의 UUID
- metric_code — varchar(100) — 외래 키 → 지표 정의.metric_code — NOT NULL — 집계 지표 고유 코드 / 논리 참조만 표시 / 실제 FK 없음
- dimension_type — varchar(32) — NOT NULL — 세부 집계 차원 종류(디스크·인터페이스 등)
- dimension_value — varchar(100) — NOT NULL — 세부 집계 차원 값(디스크명·인터페이스명 등)
- metric_unit — varchar(30) — NOT NULL — 저장된 통계 값의 단위
- minimum_value — double — 유효 표본의 최솟값
- maximum_value — double — 유효 표본의 최댓값
- average_value — double — 유효 표본의 평균값
- median_value — double — 시간 통계 중앙값들의 중앙값(전체 원시 표본 중앙값과 다를 수 있음)
- sum_value — double — 유효 표본 값의 합계
- sample_count — bigint — NOT NULL — 수치 집계에 반영한 유효 표본 수
- expected_sample_count — bigint — 대상 기간에 기대하는 표본 수
- sample_ratio — decimal(10,9) — 유효 표본 수를 기대 표본 수로 나눈 비율
- quality_status — varchar(50) — NOT NULL — 통계 품질 상태(정상·부분 표본·무데이터·유효하지 않음)
- fallback_reason — varchar(255) — 대체값 보정 사유(시계열 없음·QGA 사용 불가 등)
- source_job_id — varchar(100) — 외래 키 → 집계 실행 Job.job_id — 이 통계 결과를 생성한 집계 작업 식별자 / 논리 참조만 표시 / 실제 FK 없음
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
- updated_at — datetime(6) — NOT NULL — 행 최종 수정 시각 / ON UPDATE CURRENT_TIMESTAMP(6)
지표 정의 (cb_metric_definition)
- metric_code — varchar(100) — 기본 키 — NOT NULL — 집계 지표 고유 코드
- metric_domain — varchar(30) — NOT NULL — 지표 대상 영역(호스트·가상머신 등)
- metric_group — varchar(50) — NOT NULL — 지표 기능 그룹(프로세서·메모리·디스크 등)
- metric_name — varchar(200) — NOT NULL — 지표 표시 이름
- unit — varchar(30) — NOT NULL — 지표 값의 단위
- source_type — varchar(30) — NOT NULL — 집계 원천 종류
- source_value_type — varchar(20) — NOT NULL — 원천 값의 자료형
- source_metric_type — varchar(20) — 원천 메트릭 유형(누적값·현재값 등)
- aggregation_method — varchar(30) — 지표에 적용할 집계 방식
- promql — text — 원천 시계열 조회용 PromQL
- ui_visible_yn — char(1) — NOT NULL — 화면 노출 여부(Y/N)
- min_supported_yn — char(1) — NOT NULL — 최솟값 지원 여부(Y/N)
- max_supported_yn — char(1) — NOT NULL — 최댓값 지원 여부(Y/N)
- avg_supported_yn — char(1) — NOT NULL — 평균값 지원 여부(Y/N)
- median_supported_yn — char(1) — NOT NULL — 중앙값 지원 여부(Y/N)
- enabled_yn — char(1) — NOT NULL — 지표 활성화 여부(Y/N)
- description — text — 지표 의미 및 용도 설명
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
- updated_at — datetime(6) — NOT NULL — 행 최종 수정 시각 / ON UPDATE CURRENT_TIMESTAMP(6)
집계 실행 Job (cb_batch_job)
- job_id — varchar(100) — 기본 키 — NOT NULL — 집계 작업 고유 식별자
- job_type — varchar(40) — NOT NULL — 집계 작업 종류
- period_type — varchar(20) — NOT NULL — 집계 주기 구분(시간·일·주·월)
- window_start_at — datetime(6) — NOT NULL — 작업 대상 기간 시작 시각(UTC, 포함)
- window_end_at — datetime(6) — NOT NULL — 작업 대상 기간 종료 시각(UTC, 미포함)
- provider_id — bigint — NOT NULL — 집계 대상 공급자 식별자
- nova_id — varchar(255) — NOT NULL — 공급자의 OpenStack 환경 식별자
- source_type — varchar(30) — NOT NULL — 집계 원천 종류
- status — varchar(30) — NOT NULL — 집계 작업의 실행 상태
- triggered_by — varchar(80) — NOT NULL — 작업 실행을 요청한 주체
- trigger_payload — json — 작업 요청 정보 및 재시도 메타데이터(JSON)
- started_at — datetime(6) — 실행 시작 시각
- ended_at — datetime(6) — 실행 종료 시각
- input_count — bigint — NOT NULL — 해당 실행에서 처리한 입력 건수
- output_count — bigint — NOT NULL — 해당 실행에서 저장한 결과 건수
- error_count — bigint — NOT NULL — 작업 실행 중 집계된 오류 건수
- error_message — text — 실행 오류 또는 경고 상세 내용
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
- updated_at — datetime(6) — NOT NULL — 행 최종 수정 시각 / ON UPDATE CURRENT_TIMESTAMP(6)
프로젝트 마트 · 기간별 (cb_metric_mart_project)
- mart_id — bigint — 기본 키 — NOT NULL — 프로젝트 집계 마트 행 고유 식별자 / AUTO_INCREMENT
- period_type — varchar(20) — NOT NULL — 집계 주기 구분(시간·일·주·월)
- period_start_at — datetime(6) — NOT NULL — 통계 기간 시작 시각(UTC, 포함)
- period_end_at — datetime(6) — NOT NULL — 통계 기간 종료 시각(UTC, 미포함)
- target_type — varchar(40) — NOT NULL — 마트 집계 대상 종류(현재 PROJECT)
- target_id — varchar(100) — NOT NULL — 마트 집계 대상 프로젝트 식별자
- target_event_resource_id — bigint — 마트 대상 이벤트 자원 식별자(현재 생성 경로는 미설정)
- target_uuid — varchar(255) — 마트 대상 UUID(현재 생성 경로는 미설정)
- provider_id — bigint — NOT NULL — 집계 대상 공급자 식별자
- nova_id — varchar(255) — NOT NULL — 공급자의 OpenStack 환경 식별자
- metric_code — varchar(100) — 외래 키 → 지표 정의.metric_code — NOT NULL — 집계 지표 고유 코드 / 논리 참조만 표시 / 실제 FK 없음
- metric_unit — varchar(30) — NOT NULL — 저장된 통계 값의 단위
- minimum_value — double — 유효 표본의 최솟값
- maximum_value — double — 유효 표본의 최댓값
- average_value — double — 유효 표본의 평균값
- median_value — double — 하위 통계 중앙값들의 중앙값(전체 원시 표본 중앙값과 다를 수 있음)
- sum_value — double — 유효 표본 값의 합계
- sample_count — bigint — NOT NULL — 수치 집계에 반영한 유효 표본 수
- quality_status — varchar(50) — NOT NULL — 통계 품질 상태(정상·부분 표본·무데이터·유효하지 않음)
- source_job_id — varchar(100) — 외래 키 → 집계 실행 Job.job_id — 이 통계 결과를 생성한 집계 작업 식별자 / 논리 참조만 표시 / 실제 FK 없음
- created_at — datetime(6) — NOT NULL — 행 최초 생성 시각
- updated_at — datetime(6) — NOT NULL — 행 최종 수정 시각 / ON UPDATE CURRENT_TIMESTAMP(6)