통계 & 자동 수집

통계는 Opseer의 핵심 기능입니다. 연결된 데이터베이스에서 추적할 지표를 정의하면, Opseer가 매일 자동으로 수집합니다. 차트로 트렌드를 확인하고, 설정한 알림 채널을 통해 일일 리포트를 받을 수 있습니다.

위젯 그룹

통계 위젯은 역할에 따라 두 그룹으로 나뉩니다:

• 요약형 (숫자, 게이지) — 오늘/어제 수치를 한눈에 확인. 사이즈 선택 없이 균등 크기.
• 추세형 (라인, 바, 에리어) — 기간별 변화 추이 분석. 크기 3단계: Small(1열 4개) / Medium(1열 2개) / Full(1열 1개).

통계 페이지에서 요약형이 상단에, 추세형이 하단에 표시됩니다. 순서 조정은 각 그룹 내에서 가능하며, 위젯의 ⚙ 메뉴에서 차트 타입을 바꾸면 요약형↔추세형 그룹을 자동으로 이동합니다.

통계 컬럼 추가

각 통계 컬럼은 시간에 따라 추적할 하나의 지표를 나타냅니다. 생성/수정 페이지는 단일 설정 카드와 우측 터미널(고정 블록 + 로그 스트림)로 구성되어, 설정 즉시 위젯 미리보기와 변경 이력을 확인할 수 있습니다.

좌측 설정 카드 순서: 차트 유형 → 표시 이름 → 플랫폼(다중 DB 시) → 테이블 → 집계/집계 컬럼 → 날짜 컬럼 → 조건(WHERE) → 목표값 → 기본 기간 → 위젯 크기 → 저장.

차트 타입 선택 시 요약형과 추세형 그룹이 시각적으로 구분됩니다. 요약형을 선택하면 사이즈 옵션이 숨겨지고, 추세형을 선택하면 Small/Medium/Full 3단계 중 선택할 수 있습니다.

Visual 모드로 컬럼 생성

기본 작성 방식입니다. 테이블을 선택하고, 집계 함수를 선택하고, 필요에 따라 날짜 컬럼으로 필터링합니다. 다중 DB 프로젝트는 상단 플랫폼 셀렉터로 어느 DB에서 쿼리할지 선택합니다.

기본 기간 (Period)

각 통계 위젯은 기본 표시 기간을 설정할 수 있습니다. 요약형은 "오늘", 추세형은 "7일"이 기본입니다. "글로벌 따라가기"를 선택하면 대시보드 상단의 기간 필터를 따릅니다.

글로벌 기간 필터에서 오늘/어제/7d/30d/90d를 선택할 수 있으며, 범위를 벗어나는 기간을 선택하면 자동으로 서버에서 데이터를 조회합니다.

자동 수집

통계 컬럼이 설정되면, Opseer는 프로젝트에 설정된 수집 시간에 매일 자동으로 값을 수집합니다. 자동 수집은 모든 플랜(Free 포함)에서 사용 가능합니다.

1. 예약된 시간에 Opseer Edge Function이 각 통계 컬럼의 쿼리를 데이터베이스에 실행
2. 결과가 Opseer DB의 project_stats_data 테이블에 저장
3. 자동 통계(Auth 기반)도 같은 시점에 수집
4. 알림 채널이 활성화된 경우, 일일 리포트가 설정된 채널로 발송

수집 시간과 알림 발송

자동 수집 시간과 알림 발송 시간은 같은 설정을 공유합니다. 이 시간은 다음 3곳에서 확인하고 변경할 수 있습니다:

• 통계 페이지 — 상단 좌측의 수집 시간 버튼 (클릭하여 수정 가능)
• 프로젝트 설정 — 자동 수집 항목 (읽기 전용, 클릭 시 알림 설정으로 이동)
• 알림 설정 — 발송 시간 설정 (채널 설정과 함께)

자동 갱신

통계 페이지 또는 프로젝트 대시보드에 접근했을 때, 마지막 수집 시각이 3시간 이상 경과했으면 자동으로 갱신이 실행됩니다. 갱신은 페이지 로딩 중 서버에서 처리되어 최신 값으로 바로 표시되며, 수동 새로고침 시에는 데이터 영역에 깜빡이는 애니메이션이 표시됩니다.

갱신 시각은 프로젝트 단위로 관리되므로, 팀 프로젝트에서 한 멤버가 갱신하면 다른 멤버도 최신 데이터를 볼 수 있습니다.

자동 통계 (Supabase Auth)

Supabase OAuth를 연결하면 Auth 기반 자동 통계를 사용할 수 있습니다:

• Total Users — 전체 사용자 수
• New Signups — 오늘 신규 가입 수

자동 통계는 연동 페이지에서 활성화/비활성화할 수 있습니다. 연결된 Supabase 프로젝트의 Auth 사용자 데이터를 기반으로 수집하며, 별도 쿼리 설정이 필요 없습니다.

통계 페이지에서도 비활성화할 수 있으며, 비활성화 시 수집된 데이터는 보존됩니다. 다시 활성화하려면 연동 페이지에서 가능합니다.

일일 리포트

알림 채널(Slack, Discord, Telegram, Webhook)이 설정되어 있으면, 자동 수집 완료 후 일일 리포트가 발송됩니다. 리포트 순서:

1. 요약형 통계 (숫자, 게이지) — sort_order 기준
2. 추세형 통계 (라인, 바, 에리어) — sort_order 기준
3. 자동 통계 (Total Users, New Signups) — 구분선 이후 표시

각 통계 항목은 어제 값, 전날 값, 변화율(%)이 함께 표시됩니다.

차트

각 통계 컬럼은 통계 대시보드에서 차트 위젯으로 표시됩니다. 차트 유형을 설정할 수 있습니다.

차트 유형

• 요약형: 숫자 — 단일 지표 + 전일 대비 변화율. 게이지 — 목표 대비 현재 값.
• 추세형: 라인 — 시간에 따른 트렌드 추적. 바 — 날짜별 값 비교. 에리어 — 채워진 영역이 있는 라인 차트.

위젯 설정 메뉴

각 위젯 우측 상단의 ⚙ 버튼을 통해 편집 페이지로 이동하지 않고도 빠르게 설정을 변경할 수 있습니다:

• 차트 유형 — 숫자/게이지/라인/바/에리어 사이 전환. 요약형↔추세형 전환 시 그룹 소속도 자동 이동.
• 위젯 크기 (추세형만) — Small/Medium/Full 3단계.
• 헤더 값 — 현재값/합계/평균/최고. 기간 내 값을 어떻게 대표할지 결정.

설정 변경 중에는 해당 위젯이 잠시 깜빡이는 애니메이션으로 반영 진행 상황을 표시합니다.

헤더 값 표시 방식

위젯 헤더의 수치는 기간 내 값을 집계해 표시합니다. 지표 성격에 맞는 모드를 자동으로 선택하며, 메뉴에서 수동 변경도 가능합니다:

• 현재값 — 가장 최근 수집 데이터. 누적 스냅샷(총 사용자, 유료 구독자 등)에 적합.
• 합계 — 기간 내 모든 값 합산. 일일 이벤트(신규 가입, 오늘 매출 등)에 적합.
• 평균 — 기간 내 평균값. 응답 시간 같은 비율 지표에 적합.
• 최고 — 기간 내 최댓값. 최고 기록 추적에 적합.

쿼리에 날짜 컬럼 필터가 있으면 합계, 없으면 현재값이 자동 선택됩니다. 위젯 헤더의 작은 배지로 현재 모드를 확인할 수 있습니다.

Backfill

Backfill은 통계 컬럼의 과거 데이터를 채워 넣는 기능입니다. 새 컬럼을 추가할 때 과거 날짜를 backfill하면 일일 수집이 쌓이기를 기다리지 않고 바로 트렌드를 확인할 수 있습니다.

Backfill 기간은 플랜에 따라 다릅니다:

• Free — 최대 7일
• Starter ($9/월) — 최대 90일
• Plus ($24/월) — 최대 90일
• Max ($49/월) — 최대 90일

플랜 제한

생성할 수 있는 통계 컬럼 수는 플랜에 따라 제한됩니다. 이 제한은 프로젝트별이 아닌 전체 공유입니다:

• Free — 통계 컬럼 총 5개
• Starter ($9/월) — 통계 컬럼 총 10개
• Plus ($24/월) — 통계 컬럼 총 30개
• Max ($49/월) — 통계 컬럼 총 100개