프로젝트 소개

This is a CDK 서버리스 웹사이트 분석 구성 요소로, AWS에서 풀스택 솔루션을 배포합니다. 프론트엔드 대시보드, 백엔드 API, 그리고 웹사이트 트래픽과 사용자 상호작용을 추적하는 수집 파이프라인을 생성합니다. 낮은부터 중간 수준의 트래픽 사이트(최대 1,000만 페이지 뷰)를 대상으로 설계되었으며, 최소 비용, 개인정보 보호(PII 저장 없음), 그리고 배포 용이성을 강조합니다. 기능에는 페이지 뷰 추적(페이지 내 체류 시간 포함), 이벤트 추적, 알림이 있는 이상 탐지, 커스텀 도메인 지원, 그리고 세 가지 인증 옵션(없음, 기본 인증, AWS Cognito)이 포함됩니다. 참조자, 국가/도시별 지리 위치, 기기 유형, UTM 파라미터, 쿼리 파라미터를 추적합니다. 봇 탐지는 내장되어 있습니다. 통합은 독립형 JavaScript 스니펫 또는任何前端框架에서 사용할 수 있는 SDK를 통해 제공됩니다. 아키텍처는 S3/CloudFront에 호스팅된 Vue 3 프론트엔드, Lambda Function URLs와 tRPC를 사용하는 TypeScript 백엔드, 그리고 Kinesis Firehose를 통해 이벤트를 버퍼링하여 S3에 파티션된 Parquet 파일로 저장하는 수집 API로 구성됩니다. 데이터는 Athena를 통해 쿼리됩니다. 위치 데이터는 IP를 저장하지 않고 MaxMind GeoLite2에서 유도됩니다. 배포에는 `aws-cdk` 및 `aws-cdk-lib` > 2.79.1이 필요합니다. npm 패키지를 설치한 후, 사용자는 사이트, 오리진, 인증, 도메인, 관측 가능성, 이상 탐지 설정을 포함한 CDK 스택에 구성 요소를 정의합니다. 클라이언트 측 설정은 애플리케이션에 스크립트 태그를 추가하거나 SDK를 초기화하는 방식으로 이루어집니다. 비용 추정치는 다양한 트래픽 수준에 대해 제공되며, 일일 데이터 진공 프로세스로 인해 최악의 경우 예측이 실제 비용보다 znacz하게 높습니다. v0에서 v1로 업그레이드할 때는 파티셔닝 및 DNS 레코드 ID와 관련된 breaking changes가 발생합니다. 문서에는 설계 결정, 기여 가이드라인, 그리고 상세한 비용 분석이 포함됩니다. 라이브 데모를 이용할 수 있습니다.