플랫폼과 개발
플랫폼과 개발
수집 파이프라인, 서비스 경계, 엔드포인트, 아키텍처, 로컬 개발 흐름을 운영 관점에서 안내합니다.
이 섹션은 리옵트 데이터를 붙이거나 운영하는 개발자를 위한 기술 문서입니다. 수집 요청이 어디로 들어오고, 어떤 저장소를 거쳐 분석 화면에 나타나는지 확인할 수 있어요.
먼저 볼 문서
- 데이터 수집과 거버넌스에서 ingest 흐름을 확인하세요.
- 서비스 Plane과 엔드포인트에서 API 경계를 확인하세요.
- 아키텍처에서 앱과 패키지 구조를 확인하세요.
- 분석 백엔드 선택에서 ClickHouse와 MotherDuck 중 하나를 고르세요.
- 환경변수와 배포에서 로컬/운영 값을 정리하세요.
- 로컬 개발에서 실행 명령을 확인하세요.
운영할 때 중요한 기준
- 수집 성공과 분석 반영은 같은 일이 아닙니다.
- raw event가 남아 있으면 materialization 실패를 다시 처리할 수 있습니다.
- 서버리스 환경에서는 SDK flush를 요청 생명주기 안에서 끝내야 합니다.
- 분석 백엔드를 바꾸면 저장된 SQL과 운영 한도를 함께 점검해야 합니다.
- production 비밀값과 service plane URL은 배포 형태에 맞게 분리해야 합니다.