메트릭 관리
시간별 롤업이 어떤 이벤트를 어떤 속성으로 집계하는지 확인하고, 롤업 상태와 결과를 살펴봅니다.
메트릭 관리는 시간별 롤업을 확인하는 화면입니다. 롤업은 원본 이벤트를 조회할 때마다 다시 세지 않도록 시간 단위로 미리 세어 둔 집계입니다. 어떤 이벤트가 어떤 속성으로 나뉘어 집계되는지, 집계가 얼마나 최신인지, 지금 보는 숫자가 롤업에서 왔는지 원본에서 왔는지를 여기서 확인합니다.
진입 경로
/dashboard/[orgId]/[projectId]/metrics: 사이드바의 메트릭 관리, 단축키GM- 상단 탭은 롤업 설정(기본)과 탐색(
?tab=explore) 두 개입니다.
이 화면에서 답할 수 있는 질문
- 이 이벤트는 총계만 집계되나요, 속성별로도 집계되나요?
- 롤업이 어디까지 반영됐고, 재계산이 밀려 있지는 않나요?
- 방금 본 숫자는 롤업에서 왔나요, 원본 이벤트를 직접 읽었나요?
- 조회가 느린 이유가 무엇이고, 빠르게 만들 수 있나요?
시간별 롤업이 세어 두는 것
| 집계 | 내용 |
|---|---|
| 이벤트 총계 | 이벤트 이름별 시간당 건수 |
| 속성별 건수 | 이벤트에 롤업 속성으로 등록한 키의 값별 시간당 건수 |
| 트래픽 | 세션, 페이지뷰, 신규 방문, 이탈을 채널·UTM·리퍼러별로 |
롤업은 약 5분마다 갱신됩니다. 조회는 직전 시간대보다 앞선 구간만 롤업에서 읽고, 현재 시간대와 직전 시간대는 원본 이벤트에서 읽어 합칩니다.
그래서 오늘을 포함한 기간을 보면 출처가 롤업+실시간으로 표시됩니다.
롤업 속성과 제외
롤업 속성은 시간별 집계가 이벤트를 나눠 세는 속성 키입니다.
purchase에 plan을 등록하면 요금제별 구매 수가 시간 단위로 미리 집계되고, plan으로 나눈 조회가 롤업에서 응답합니다.
- 이벤트당 최대 20개까지 등록할 수 있습니다.
- 등록한 키가 없는 이벤트는 표에
총계만으로 표시됩니다. 그 이벤트를 속성으로 나눠 보면 원본 이벤트를 읽습니다. - 키마다 하루(UTC)에 건수가 많은 값 1,000개까지만 따로 세고, 값은 256자에서 잘립니다. 사용자 ID처럼 값이 아주 다양한 속성은 롤업 속성으로 맞지 않습니다.
- SDK가 자동으로 보내는 이벤트는 등록하지 않아도 정해진 키로 집계됩니다.
$pageview는path·origin·referrer·utm_source·utm_medium·utm_campaign입니다. 표의 롤업 속성 열에는 직접 등록한 키만 보입니다. 자동 이벤트에 키를 직접 등록하면 기본 키 대신 등록한 목록이 쓰입니다.
제외는 이벤트 상태를 내부로 두는 것입니다. 표에 내부 (집계 제외)로 표시되고, 이벤트 수를 세는 조회에서 빠집니다.
설정을 바꾸는 곳
롤업 설정 탭은 현재 설정을 보여 주기만 합니다. 바꾸는 곳은 아래와 같습니다.
| 바꾸려는 것 | 바꾸는 곳 |
|---|---|
| 제외(내부), 전환 여부 | 이벤트를 고르고 카탈로그에서 설정 편집 → 데이터 카탈로그 인스펙터의 설정 탭 |
| 롤업 속성 추가 | 탐색 탭에서 롤업에 없는 키를 썼을 때 나타나는 <키> 롤업에 추가 버튼 |
| 롤업 속성 전체 관리 | 카탈로그 파일의 rollupProperties. CLI의 reopt-data event push나 데이터 카탈로그의 가져오기·내보내기로 반영합니다 |
카탈로그 인스펙터의 설정 탭에는 전환 여부와 상태만 있습니다. 롤업 속성은 표의 나머지 두 경로로 바꿉니다.
롤업 설정 탭
롤업 상태
화면 위쪽 네 칸이 롤업의 현재 상태입니다. 1분마다 다시 읽습니다.
| 항목 | 뜻 |
|---|---|
events_hourly 행 | 이벤트 롤업에 쌓인 행 수와 가장 최근 집계 시각(UTC). 비어 있음이면 아직 집계가 없습니다 |
traffic_hourly 행 | 트래픽 롤업의 행 수와 가장 최근 집계 시각(UTC) |
재계산 대기 시간대 | 새 이벤트가 들어와 다시 계산해야 하는 시간대 수. 다음 갱신 때 처리됩니다 |
전체 재계산 | 정상, 대기열(재계산이 예약됨), 재계산 중 가운데 하나 |
헤더의 전체 재계산은 프로젝트의 전체 이력을 다시 집계하도록 예약합니다. 이미 예약됐거나 진행 중이면 누를 수 없습니다. 재계산은 5분 주기 갱신이 한 번에 한 프로젝트씩 나눠 처리하므로, 이력이 길면 여러 주기에 걸쳐 끝납니다.
이벤트 표
최근 30일 안에 수집됐거나 카탈로그에 등록된 이벤트가 모두 나옵니다.
- 열:
이벤트,30일 이벤트,상태,전환,롤업 속성 - 검색창은 이벤트 이름과 롤업 속성 키를 함께 찾습니다. 정렬은
이벤트 수와이름두 가지입니다. 30일 이벤트는 기간 선택과 상관없이 항상 최근 30일 건수입니다.
행을 누르면 오른쪽에 그 이벤트의 롤업 속성·상태·전환 여부와 기간 내 이벤트 건수가 나옵니다. 롤업 속성이 있으면 첫 번째 키의 상위 값 5개도 함께 보여 줍니다.
원본 보기미리보기
선택한 기간(기본 최근 30일)의 트래픽 합계와 채널·리퍼러 상위 8개를 보여 줍니다. 날짜는 프로젝트 시간대 기준입니다. 숫자마다 붙은 배지는 데이터 출처입니다.
| 배지 | 뜻 |
|---|---|
롤업 | 기간 전체를 롤업에서 읽었습니다 |
롤업+실시간 | 앞 구간은 롤업, 최근 구간은 원본에서 읽어 합쳤습니다. 정상입니다 |
원본 스캔 | 롤업을 쓰지 못하고 원본 이벤트를 직접 읽었습니다. 느릴 수 있습니다 |
탐색 탭
탐색 탭은 트래픽 지표와 이벤트 수를 겹쳐 그려 보는 보드입니다. 패널마다 쿼리를 여러 개 넣고 한 차트에서 비교합니다.
- 쿼리 소스:
트래픽은 세션·페이지뷰·신규 방문·재방문·이탈률 가운데 하나,이벤트는 이벤트 하나 또는전체 이벤트입니다. - 이벤트 쿼리:
breakdown 속성과 상위 N(1–10, 기본 5)으로 나누고, 속성 필터를 5개까지 붙입니다. 연산자는=·≠·포함·미포함가운데 속성 타입에 맞는 것이 나옵니다. - 보드 전체 설정: 기간(기본 최근 30일), 버킷 단위(
시간·일·주·월),이전 기간과 비교(기본 켜짐), 시리즈 색상. - 패널 설정: 차트 유형(
라인·영역·막대·누적 막대·표·스탯·스파크라인),normalize (최대값 대비 %),반폭, 임계선(패널당 5개). - 차트 위를 드래그하면 그 날짜 구간으로 좁혀집니다. 브라우저 뒤로 가기로 되돌립니다.
보드는 패널 12개, 패널당 쿼리 10개까지입니다. 한 패널의 시리즈가 40개를 넘으면 작은 값부터 빠지고 시리즈 일부 생략이 표시됩니다.
롤업을 쓰지 못했을 때
패널이 원본 이벤트를 읽으면 원본 스캔 배지와 함께 롤업을 쓰지 못했습니다 안내에 이유가 나옵니다.
| 이유 | 할 수 있는 일 |
|---|---|
| 롤업에 등록되지 않은 breakdown 키 | <키> 롤업에 추가를 누르고 재계산이 끝나길 기다립니다 |
= 이외의 연산자를 쓴 필터 | = 필터로 바꾸거나 느린 조회를 감수합니다 |
| 롤업이 담고 있지 않은 속성 필터 | 속성 필터가 걸린 이벤트 조회는 원본을 읽습니다(아래 참고) |
| 프로젝트 시간대가 UTC 정시가 아님 | UTC와 30분·45분 어긋나는 시간대(예: Asia/Kolkata)는 롤업을 쓸 수 없습니다 |
| 롤업을 다시 만드는 중 | 재계산이 끝나면 풀립니다 |
| 아직 집계되지 않은 최근 구간 | 안내에 표시된 시각부터 자동으로 빨라집니다 |
| 롤업을 처음 검증하는 중, 갱신 지연 | 기다리면 풀립니다 |
롤업에 추가는 그 키로 나누는 조회를 빠르게 합니다. 버튼은 필터에 쓴 키에도 나타나지만, 속성 필터가 걸린 이벤트 조회는 키를 등록해도 원본을 읽습니다.
$pageview를 surface·route_kind·page_id·publication_id의 = 조건으로 거르는 경우만 롤업에서 응답합니다.
이벤트당 20개 한도를 넘게 되면 버튼이 비활성화되니, 쓰지 않는 키를 먼저 정리하세요.
보드 공유와 저장
보드 구성은 전부 주소에 담깁니다. 링크 복사로 그대로 공유하세요. 기간이 최근 30일 같은 상대 표현이면 링크를 여는 날 기준으로 다시 계산됩니다.
보드가 커서 주소에 담기지 않으면 URL 미포함 배지가 붙고, 그 보드는 지금 브라우저 세션에서만 복원됩니다.
보드 저장은 이 브라우저에 프로젝트별로 12개까지 저장합니다. 다른 사람과 공유할 때는 링크를 쓰세요.
설정을 바꾸면 달라지는 것
- 롤업 속성을 바꾸면 전체 이력 재계산이 예약됩니다. 상태가
대기열→재계산 중→정상으로 바뀝니다. 재계산 중에는 이 프로젝트의 속성별 조회가 원본 이벤트를 읽어 느려질 수 있고, 재계산이 끝나야 새 키가 롤업에서 응답합니다. 상태가정상으로 돌아오기 전에는 새 키로 나눈 결과를 확정된 숫자로 보지 마세요. - 이벤트를 내부로 바꾸면 그 이벤트가 이벤트 수 집계에서 빠집니다. 이 화면의
전체 이벤트건수, 탐색 탭의 이벤트 쿼리, 대시보드의 이벤트 추이 타일이 해당됩니다. 세션·페이지뷰 같은 트래픽 지표는 그대로입니다. - 대시보드 타일은 결과를 5분 동안 캐시하므로 변경이 그만큼 늦게 보일 수 있습니다.
주의할 점
- 롤업은 조회 속도를 높이기 위한 것입니다. 롤업을 쓰지 못한 조회는 같은 기간의 원본 이벤트를 직접 셉니다. 느려질 뿐 결과가 비지는 않습니다.
- 쿼리 줄의
원본 조회배지는 실행 전 예상이고, 패널 제목 옆 배지가 실제 출처입니다. - 기간 선택 옆의
MotherDuck · 예약 집계같은 표시는 이 조직의 분석 저장소와 롤업을 만드는 방식입니다.