조직과 프로젝트
통합 프로젝트 화면에서 조직을 필터링하고 프로젝트를 만들고 이동하는 흐름을 안내합니다.
조직은 비용과 멤버십을 관리하는 단위이고, 프로젝트는 이벤트 데이터와 분석 화면이 속하는 단위입니다. 조직과 프로젝트는 처음 시작할 때 만들고, 그 뒤에는 통합 프로젝트 화면에서 원하는 프로젝트를 바로 찾습니다.
진입 경로
/dashboard: 통합 프로젝트 화면- 기존 조직 홈 주소
/dashboard/[orgId]는 통합 화면의 해당 조직 필터(/dashboard?organization=<orgId>)로 자동 이동합니다.
이 화면에서 확인할 것
- 내가 어떤 조직에서 작업 중인지 확인합니다.
- 조직 안에 어떤 프로젝트가 있는지 확인합니다.
- 새 프로젝트를 만들고 발급된 키를 확인합니다.
통합 프로젝트 화면
통합 프로젝트 화면은 사용자가 속한 모든 조직의 프로젝트를 한곳에 보여주는 첫 화면입니다.
- 최근 프로젝트: 이 브라우저에서 최근에 연 프로젝트를 최대 3개까지 보여줍니다. 검색어가 없고 조직 필터가 "모든 조직"일 때만 나타납니다.
- 프로젝트 이름, 조직 이름, 도메인 검색
- 조직 필터와 정렬(최근 사용 순, 이름 순)
- 새 프로젝트: 소속 조직, 프로젝트 이름, 도메인(선택)을 입력합니다. 소속 조직에는 내가
owner나admin인 조직만 나옵니다. 단축키는N입니다. - 조직 필터를 선택하면 목록 위에 그 조직의 사용량 및 요금 버튼이 나타납니다.
- 워크스페이스 메뉴(⋯)에서 새 조직 생성과 로그아웃
자기 조직이 아직 없다면 화면의 + 새 조직이나 워크스페이스 메뉴(⋯)에서 조직을 먼저 만드세요. 새 프로젝트를 눌러도 조직 만들기부터 시작합니다. 조직을 만들면 첫 프로젝트 생성 창이 바로 이어서 열립니다.
공개 데모 워크스페이스는 목록 맨 위에 함께 보입니다.
목록에서는 조직 이름 옆에 데모 표시가 붙습니다.
데모 워크스페이스는 읽기 전용이라 그 안의 설정이나 데이터를 바꿀 수 없습니다. 데모 안의 화면마다 위쪽에 같은 안내가 나옵니다.
새로 만들거나 저장하는 버튼은 꺼져 있고, 버튼에 마우스를 올리면 이유가 나옵니다. 꺼져 있지 않은 버튼을 눌러 무언가를 바꾸려 하면 읽기 전용이라는 안내가 나옵니다.
역할별 권한
조직 멤버의 역할은 owner, admin, member 세 가지입니다.
| 작업 | 필요한 역할 |
|---|---|
| 조직 생성 | 로그인한 사용자 누구나 |
| 프로젝트 조회, 분석 화면 사용 | 조직 멤버 |
| 프로젝트 생성과 설정 변경 | owner 또는 admin |
| 보존 정책 변경과 데이터 정리 실행 | owner 또는 admin |
| Starter 구독, 자동 갱신 해지, 결제 연결 해제 | owner |
조직을 만든 사람이 그 조직의 owner가 됩니다.
프로젝트를 만들면 함께 생성되는 것
- 프로젝트. 시간대는
UTC로 시작합니다. - 브라우저용 client
<프로젝트 이름> (browser): 수집 전용이고, 공개해도 되는writeKey를 씁니다. - 서버용 client
<프로젝트 이름> (server): 수집과 조회를 모두 할 수 있고,serverSecret으로 인증합니다. - 서버용 1회성
serverSecret
브라우저 키와 서버 키는 권한이 달라서 따로 발급합니다.
브라우저 번들에 실리는 writeKey로는 이벤트를 보낼 수만 있고, 프로젝트의 분석 데이터는 읽을 수 없습니다.
콘솔에서 프로젝트를 만들면 생성 직후 창에 Write Key, 서버 Client ID, 서버 Client Secret이 표시되고 값마다 복사 버튼이 있습니다.
창을 닫으면 서버 Client Secret은 다시 볼 수 없으니 닫기 전에 안전한 곳에 옮겨 두세요.
Free 조직이면 같은 창에 매월 수집할 수 있는 양이 함께 나옵니다. 수집이 막힌 조직이면 그 이유가 나옵니다.
프로젝트 홈의 SDK Integration 영역에서는 브라우저용 writeKey가 들어간 초기화 snippet을 언제든 확인할 수 있습니다.
서버 SDK에는 서버 Client Secret과 함께 서버용 client의 ID(clientId)가 필요합니다. 둘 다 프로젝트를 만든 직후의 창에서 복사합니다.
창을 닫은 뒤에는 콘솔에서 서버 Client ID와 Secret을 다시 볼 수 없습니다. CLI로 프로젝트를 만들 수도 있습니다. reopt-data project create는 브라우저 writeKey, 서버 client ID(clients.server.id), clientSecret을 함께 돌려줍니다. 잃어버린 secret은 reopt-data project rotate-secret으로 새로 발급합니다.
두 명령 모두 조직 키(REOPT_DATA_ORG_KEY)가 필요합니다. 자세한 내용은 CLI 사용하기를 확인하세요.
프로젝트 시간대
조회 기간과 화면의 시각은 프로젝트 시간대를 따릅니다. 프로젝트 설정 화면에는 시간대 항목이 없습니다. 바꾸려면 조직 키로 CLI를 사용하세요.
reopt-data project update prj_123 --timezone Asia/Seoul저장소에서 설정을 관리한다면 reopt-data/project.json의 timezone으로 선언해도 됩니다.
시간대를 바꾸면 대시보드 숫자가 달라지므로 프로젝트를 코드로 관리하기에서는 metric-changing 등급으로 다룹니다.
주의할 점
serverSecret은 프로젝트를 만든 직후 한 번만 표시되는 서버 전용 값입니다.- 브라우저 번들, HTML, client component, 공개 저장소에는
serverSecret을 넣지 마세요. - 노출됐다면
reopt-data project rotate-secret <projectId> <serverClientId> --yes로 새 secret을 발급하세요. 이전 secret은 즉시 동작을 멈춥니다.
다음 단계
- 첫 이벤트를 보내려면 빠른 연동
- 이벤트 수집을 붙이려면 추적 설정
- 사용량과 구독은 비용과 보존 정책
- 분석 화면을 고르려면 프로젝트 워크스페이스