Cloudflare Web Analytics 데이터가 안 보일 때: 설치와 Beacon 점검
프록시, 수동 설치, Pages별 설정을 구분하고 beacon 로드와 데이터 전송을 확인한다.
Cloudflare Web Analytics에 방문 데이터가 표시되지 않으면 먼저 사이트에 beacon이 실제로 삽입되고 브라우저에서 전송되는지 확인한다. 설치 방법은 Cloudflare 프록시 사용 여부와 Pages 배포 여부에 따라 다르다.
브라우저 성능 측정과 클라우드 수집을 표현한 AI 생성 개념 이미지
이 글은 2026년 11월 18일 확인한 Cloudflare 공식 문서에 기반한다. 실제 계정이나 사이트의 설정을 변경해 검증하지 않았다.
설치 경로를 구분한다
프록시를 사용하지 않는 사이트는 Web Analytics 설정에서 Add a site를 선택하고 호스트명을 등록한다. Manage site에서 제공하는 JavaScript 스니펫을 복사해 측정할 HTML 페이지의 닫는 body 태그 앞에 넣는다. DNS를 Cloudflare로 옮기거나 프록시를 사용할 필요는 없다.
Cloudflare 프록시를 사용하는 사이트는 Web Analytics에서 호스트를 추가하면 자동 삽입을 사용할 수 있다. Manage Site에서 자동 삽입, EU 방문자 제외, 수동 스니펫 또는 비활성화 설정을 확인한다. 자동과 수동을 동시에 적용하기 전에 기존 스니펫과 실제 응답을 확인해 중복 설치를 피한다.
Cloudflare Pages 프로젝트는 Workers & Pages에서 프로젝트의 Metrics → Web Analytics → Enable을 선택한다. 공식 문서에 따르면 스니펫은 다음 배포에 추가된다. 자동 삽입을 위해 유효한 HTML이 필요하다. Pages 설정과 HTML 예시
브라우저에서 수집 경로를 확인한다
배포된 페이지를 열고 개발자 도구의 Network 탭에서 페이지를 새로고침한다. beacon.min.js가 로드되는지, /cdn-cgi/rum으로 전송이 발생하는지 확인한다. 공식 문서는 프록시 사이트의 전송 대상으로 해당 사이트 도메인을, 프록시를 사용하지 않는 사이트에는 cloudflareinsights.com을 설명한다. 수동 설치는 전송 대상이 다를 수 있으므로 실제 요청을 확인한다. 데이터 수집 방식, 설치 FAQ
수집 결과는 표시되기까지 몇 분이 걸릴 수 있다. 보고 기간과 호스트 필터도 확인하고, 페이지를 벗어나거나 탭을 숨긴 뒤 다시 확인한다. Core Web Vitals는 로드 후 페이지가 처음 숨겨질 때 보고된다. 요청 하나가 성공했다고 모든 방문이나 지표가 정확하게 수집됐다고 단정하지 않는다.
데이터가 없다면 점검할 항목
- 삽입 여부: 배포된 HTML에 스니펫이 있는지 확인한다. 프록시 자동 삽입은
Cache-Control: public, no-transform이 있으면 원본 응답을 수정하지 못한다.
- 보안 정책과 차단: Content Security Policy가 beacon 스크립트와 실제 전송 대상을 허용하는지 확인한다. 브라우저 확장이나 네트워크 차단도 점검한다. 정책을 무조건 완화하지 말고 필요한 출처만 검토한다.
- 설정과 배포: 정확한 호스트명, 측정 대상 페이지, 자동 삽입 설정, Pages의 새 배포 여부를 확인한다.
- EU 제외 설정: 해당 옵션이 켜져 있으면 EU 방문자에게 스니펫이 주입되지 않는다. 테스트 위치와 설정을 함께 살펴본다.
브라우저에서 실행되는 beacon은 실제 사용자의 페이지 경험을 측정하는 RUM이다. JavaScript가 실행되지 않거나 요청이 차단된 방문은 빠질 수 있으므로 Cloudflare 엣지 요청 통계와 값이 같을 것으로 기대하지 않는다. 자동 수집 범위, SPA 동작과 데이터 보존은 운영 환경에 적용하기 전에 공식 FAQ와 설정을 확인한다.
English version:
Cloudflare Web Analytics Not Showing Data: Check Installation and the Beacon