프로젝트 설정
프로젝트 설정 양식, 분석 기준값, 보존 정책, 에러·AI 수집 정책을 관리합니다.
프로젝트 설정에서는 프로젝트 하나의 운영 정책을 관리합니다. 분석 기준값, 데이터 보존, 에러와 AI 수집 정책을 여기서 정합니다.
진입 경로
/dashboard/[orgId]/[projectId]/settings: 사이드바의 프로젝트 설정, 단축키GT
설정 화면
설정 조회와 삭제 미리보기는 조직 멤버가 사용할 수 있습니다.
프로젝트 설정 저장, 보존 정책 변경, 수동 정리 실행, AI 관측 설정 변경은 조직 owner 또는 admin 권한이 필요합니다.
에러 규칙과 심볼셋은 프로젝트에 접근할 수 있는 멤버가 관리할 수 있습니다.
화면은 위에서부터 다음 순서입니다.
- 프로젝트 설정 양식
- 데이터 보존 정책
- 삭제 미리보기와 수동 정리
- 저장소 사용량
- 에러 트래킹: 스튜디오 연결, 에러 규칙, 규칙 테스트, 급증 감지, 릴리즈, 심볼셋
- AI 관측
- 화면 모드
원본 보기프로젝트 설정 양식
저장을 눌러야 반영됩니다. 아래에서 고른 데이터 보존 정책도 이 버튼으로 함께 저장됩니다.
| 항목 | 설명 |
|---|---|
| 프로젝트 이름 | 비울 수 없습니다 |
| 도메인 | example.com 형식. 프로토콜과 경로는 넣지 않습니다. 프로젝트를 찾을 때 검색됩니다 |
| 파워 유저 기준 · 이벤트 수 | 비우면 기본값 25건 |
| 파워 유저 기준 · 세션 수 | 비우면 기본값 5회 |
| 활성 기준 · 최근 활동 며칠 이내 | 비우면 기본값 7일 |
| 휴면 기준 · 이 일수를 넘기면 휴면 | 비우면 기본값 30일. 활성 기준을 함께 채웠다면 그보다 커야 합니다 |
| 소스 저장소 | http(s):// 또는 git@로 시작하는 주소. 에러 스택에서 소스 코드로 가는 링크에 씁니다 |
| 기본 브랜치 | 비우면 main |
| 호스트 앱 | 여러 프로젝트의 화면을 한 앱이 함께 서빙할 때만 채웁니다 |
도메인은 프로젝트를 구분하는 정보입니다. 값을 넣어도 다른 도메인에서 온 이벤트 수집을 막지 않습니다. 기준값을 비워 두면 제품 기본값을 따릅니다. 파워 유저·활성·휴면 기준이 쓰이는 화면은 사용자와 세그먼트를 보세요.
이 화면에 없는 항목:
프로젝트 타임존은 화면의 시각 표시와 "오늘"·"최근 N일" 같은 조회 기간의 날짜 경계를 정합니다. 시각 옆에는 KST·UTC처럼 시간대가 함께 표시됩니다. 세션 상세와 사용자 프로필의 타임라인, 실시간 피드, 리플레이 타임라인은 예외로, 보고 있는 브라우저의 시간대로 표시합니다. 타임존을 정하지 않은 프로젝트는 UTC를 씁니다.
데이터 보존 정책과 수동 정리
보존 기간은 무제한 (삭제 안 함), 30일, 60일, 90일, 180일, 365일 중에서 고릅니다.
기간을 정해도 데이터가 자동으로 지워지지는 않습니다. 기간보다 오래된 데이터는 수동 정리 실행을 눌렀을 때 삭제됩니다.
- 삭제 미리보기는 기간을 고르면 나타나고, 그 기간으로 정리했을 때 테이블별로 지워질 행 수를 보여줍니다.
- 미리보기는 화면에서 고른 기간으로 계산하지만, 실제 정리는 저장된 보존 기간으로 실행합니다. 기간을 바꿨다면 먼저 저장하세요.
- 정리는 원본 이벤트와 분석 테이블에서 기준일 이전 행을 지웁니다. 원본 이벤트가 지워진 기간은 다시 반영할 수 없습니다.
- 실행 전에 확인 창을 거치고, 실행한 뒤에는 되돌릴 수 없습니다.
- 저장소 사용량은 테이블별 행 수와 비율을 보여줍니다.
AI 호출 기록은 예외입니다. 프로젝트 보존 기간과 AI 관측의 스팬 보존 기간 중 짧은 쪽으로 매일 자동 정리됩니다.
에러 트래킹
에러 이슈를 어떻게 묶고 분류할지 정하는 항목입니다. 동작은 에러 트래킹에서 설명합니다.
- 스튜디오 연결: 에러 이슈를 스튜디오 업무로 보내는 연결의 상태를 보여줍니다. 읽기 전용입니다.
- 에러 규칙: 위에서부터 평가하고, 종류별로 처음 맞는 규칙을 적용합니다. 추가, 수정, 켜고 끄기, 순서 변경, 삭제를 할 수 있습니다.
- 규칙 테스트: 이벤트 properties를 붙여 넣어 저장된 규칙이 어떻게 적용되는지 확인합니다. 아무것도 저장하지 않습니다.
- 급증 감지: 배수 ×3, 최소 발생 10건 / 5분. 지금은 읽기 전용입니다.
- 릴리즈: 이벤트의
$release_id로 관측된 빌드 목록입니다. - 심볼셋: 업로드한 소스맵 목록입니다. 삭제할 수 있고, 이미 해석된 스택은 그대로 남습니다.
AI 관측
모델 호출 기록의 수집 정책입니다. 조직 owner 또는 admin이 아니면 읽기 전용으로 보입니다.
- 프롬프트·응답 본문 수집: 기본은 꺼짐입니다. 켜면 이후 호출의 프롬프트, 응답, 도구 인자와 결과가 저장되고 프로젝트 멤버 모두가 볼 수 있습니다. SDK에서도
captureContent를 켠 호출만 본문이 들어옵니다. - 스팬 보존 기간: 1~365일, 기본 90일.
바꾼 뒤 이 영역의 저장을 눌러야 반영됩니다. 화면은 AI 관측을 보세요.
화면 모드
콘솔의 밝기를 라이트, 다크, 시스템 중에서 고릅니다.
코드로 관리하는 프로젝트
타임존, 보존 기간, 임계값 같은 설정은 저장소의 reopt-data/project.json으로도 관리할 수 있습니다.
CI에서 verify로 어긋남을 잡고 배포와 함께 push하는 흐름은 프로젝트를 코드로 관리하기를 보세요.
저장소에서 설정을 적용한 적이 있는 프로젝트는 화면 위에 마지막 코드 적용 시각과 적용한 주체가 표시됩니다.
저장소가 관리하는 에러 규칙에는 코드 관리 배지가 붙습니다. 콘솔에서 고칠 수는 있지만 저장소와 차이가 생기므로, 다음 적용 전에 저장소에도 반영하세요.
주의할 점
- 삭제 미리보기를 먼저 확인한 뒤 수동 정리를 실행하세요. 미리보기와 실제 정리가 같은 기간을 쓰는지도 확인하세요.
- 본문 수집을 켜기 전에 개인정보나 비밀값이 섞이지 않는지 확인하세요.
다음 단계
- 비용과 보존 정책은 비용과 보존 정책
- 수집 요청과 보존의 관계는 데이터 수집과 거버넌스
- 설정을 파일로 관리하려면 프로젝트를 코드로 관리하기