집계 테이블 설계

테이블 (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)