콘텐츠로 이동
Newsfork Docs

Tail Worker for Cloudflare Analytics Engine

Overview

섹션 제목: “Overview”

Tail Workers 패턴: 메인 빌드 워커의 로그·실행 상태를 실시간으로 가로채 Cloudflare Analytics Engine으로 전송한 뒤, SQL로 실시간 대시보드 구축.

Tail Worker는 별도 실행이 아니라, 메인 워커에서 로그가 발생할 때마다 Cloudflare 인프라에 의해 자동 트리거됩니다.

핵심 구조

섹션 제목: “핵심 구조”
  • tail(events): 이벤트 배열 처리
  • event: scriptName, outcome, exceptions, logs, eventTimestamp
  • MONITORING_ENGINE.put(metadata): blobs(도메인, outcome, scriptName, 에러 메시지), doubles(타임스탬프, 예외 수) 전송

운영 원칙

섹션 제목: “운영 원칙”
  • 비동기로 데이터 적재하여 빌드 성능에 영향 최소화
  • 전송 실패 시 로그만 남기고 메인 워크플로우는 중단하지 않음
섹션 제목: “Related Documents”