OpenAnalytics

쿠키 없는 자체 호스팅 웹 분석과 MCP 서버

git clone https://github.com/OpenLabs-so/openanalytics && cd openanalytics/infra/selfhost && docker compose up -d

쿠키를 쓰지 않고 사이트 간 프로필도 만들지 않는 웹 분석 도구입니다. 읽기는 집계만 허용합니다. 추적 스크립트는 몇 킬로바이트짜리이고 크기 예산을 지속 통합이 강제합니다. 수집과 큐 처리, 제어 계층, 질의 관문, 실시간 스트림, 대시보드가 각각 다른 프로세스로 나뉩니다. 이벤트 저장소를 읽는 프로세스는 하나뿐이고 서명된 질의 봉투를 검증합니다. 페이지 조회와 사용자 정의 이벤트, 세션, 매출 귀속을 다루고 MCP 서버가 붙어 있어 에이전트가 지표를 직접 물어봅니다. AGPL 이고 자체 하드웨어에 올릴 수 있으며 만든 사람들이 운영하는 호스팅 판도 있습니다.

판단

이럴 때 씁니다

  • 쿠키 없이 방문 지표를 재야 할 때
  • 지표를 자기 서버에 두어야 할 때
  • 에이전트가 지표를 직접 물어보게 할 때

이럴 땐 쓰지 마세요

  • 관리형이 편하면 자체 운영은 부담입니다
  • 저장소가 여럿이라 운영 난도가 높습니다
  • 0.x 대라 마이너 판에서 기능이 빠질 수 있습니다

차별점

  • 쿠키와 사이트 간 프로필 없이 동작합니다.
  • 추적 스크립트 크기를 지속 통합이 예산으로 강제합니다.
  • 이벤트 저장소 읽기를 한 프로세스로 제한하고 질의에 서명을 요구합니다.
  • MCP 서버가 붙어 있어 지표를 대화로 물어봅니다.

워크플로

  1. 01저장소를 받아 자체 호스팅 구성으로 띄웁니다.
  2. 02사이트를 등록하고 추적 스크립트를 넣습니다.
  3. 03이벤트와 깔때기를 정의합니다.
  4. 04대시보드에서 지표를 봅니다.
  5. 05MCP 로 붙여 에이전트가 물어보게 합니다.

주요 명령

명령설명
docker compose up -d자체 호스팅 구성으로 띄웁니다.
git fetch --tags && git checkout v0.5.0 && cd infra/selfhost && ./upgrade.sh판을 올립니다.
oa사이트 설정과 통계 조회를 명령줄에서 합니다.

함정

설치 전에 확인하세요

  • 0.x 대이므로 마이너 판에서 기능이 제거될 수 있다고 저장소가 명시합니다.
  • 저장소가 제어 계층과 이벤트, 큐로 나뉩니다. 운영할 것이 여럿입니다.
  • 이벤트 저장소를 읽는 프로세스는 하나뿐이고 서명된 질의만 받습니다. 우회로 붙이려 하면 막힙니다.
  • AGPL 3.0 입니다. 고쳐서 서비스로 제공하면 조건이 따릅니다.

비교

관리형 분석 도구는 편하지만 방문자 데이터를 남의 서버에 둡니다. 이쪽은 전부 자기 하드웨어에 올릴 수 있고 쿠키도 쓰지 않습니다. 대신 운영할 구성 요소가 여럿입니다.

최근 변경

출처와 지역, 기기 카드를 눌러 해당 세션만 걸러 보는 필터가 생겼고 대시보드와 읽기 API, MCP 에서 똑같이 동작합니다. 페이지별 유입과 이탈, 이탈률이 표에 붙었고 광고 클릭 ID 와 ref 파라미터를 유입 출처로 인식합니다.