Cloudflare Worker telemetry로 이벤트 전송 및 확인
제어된 애플리케이션 경계에서 Cloudflare Worker telemetry를 사용하고, 이벤트 계약을 작게 유지하고, 집계 뷰를 구축하기 전에 알려진 결과를 확인하세요.
- 1
결과를 선택하세요
엣지 API 모니터링
- 2
계약 정의
worker_name, route_template, 방법, status_code, 콜로 및 trigger_type
- 3
결과에서 방출
실패가 관찰된 전달 약속에만 ctx.waitUntil을 사용하십시오. 그렇지 않으면 원격 분석이 플러시되기 전에 작업자가 돌아올 수 있습니다.
- 4
증거를 확인하세요
Exercise a known fixture, then inspect edge_request_completed for one correctly typed terminal row.
시작하기 전에
시작하기 전에
- Telemetry API 키에 대한 작업자 비밀 바인딩
- 명시적으로 관리되는 백그라운드 전달에 사용 가능한 ExecutionContext
- Cloudflare 요청 메타데이터에 대한 정규화된 경로 이름 및 허용 목록
배송 설정
서버 측 설치 및 초기화
서버 전용 코드에서 telemetry-sh를 가져오고 process.env.TELEMETRY_API_KEY로 한 번 초기화합니다. 브라우저 번들, 클라이언트에 표시되는 환경 변수, 소스 제어, 로그 및 예외 메시지에서 수집 자격 증명을 유지하세요.
npm 설치
npm install telemetry-sh- 1제한된 네트워크 동작을 갖춘 재사용 가능한 서버 측 전달 클라이언트 하나를 준비합니다.
- 2성공, 실패, 재시도 또는 시간 초과 경계에 결과 이벤트를 추가합니다.
- 3알림을 활성화하기 전에 제어된 고정 장치를 보내고 저장된 행을 검사하십시오.
스니펫
하나의 체계적인 이벤트로 시작하세요
워크플로가 완료, 실패 또는 재시도되는 위치에 이 셰이프를 추가합니다. 그런 다음 실제 필드에서 대시보드를 구축합니다.
Cloudflare Worker telemetry 이벤트
await telemetry.log("edge_request_completed", {
worker_name: "events-api",
route_template: "/api/events",
method: "POST",
status_code: 202,
colo: request.cf?.colo,
latency_ms: 42,
status: "success",
release: env.APP_RELEASE,
});이벤트 스키마
worker_name, route_template, 방법, status_code, 콜로 및 trigger_type
상태, latency_ms, 사용 가능한 경우 cpu_time_ms 및 error_type
request_id, queue_name, 시도, 릴리스 및 환경
설정 확인하기
체크포인트 1
실패가 관찰된 전달 약속에만 ctx.waitUntil을 사용하십시오. 그렇지 않으면 원격 분석이 플러시되기 전에 작업자가 돌아올 수 있습니다.
체크포인트 2
원시 URL 대신 경로 템플릿을 기록하고 쿠키, 인증 헤더, 요청 본문, 클라이언트 IP 주소 또는 무제한 cf 속성을 기록하지 않습니다.
체크포인트 3
모든 콘솔 기록을 복제하는 대신 런타임 진단을 위해 작업자 로그를 유지하고 검토된 애플리케이션 결과에 대한 압축 Telemetry 이벤트를 내보냅니다.
검증
이벤트가 도착했음을 증명하세요.
알려진 성공 및 실패 사례를 연습한 후 이를 실행하십시오. 최종 이벤트 계약이 스니펫과 다른 경우 대체 테이블 이름을 바꾸세요.
Cloudflare Worker telemetry 확인 쿼리
SELECT *
FROM edge_request_completed
ORDER BY timestamp_utc DESC
LIMIT 20;구현 참조
새로운 프로덕션 경로를 활성화하기 전에 이벤트 계약, 데이터 안전 지침, 업스트림 기본 문서를 검토하세요.
이벤트를 기록할 위치
결과 이벤트를 작고 복구 가능하게 유지
이 패턴은 다음을 제공합니다.
- 업스트림 워크플로우 옆에 제한된 SQL 지원 결과가 있습니다.
- 대시보드, 알림 및 교차 이벤트 상관 관계를 위한 안정적인 필드입니다.
- 성공, 실패, 재시도 및 시간 초과 동작을 검증하기 위한 고정 장치 기반 경로입니다.
이 패턴은 제공하지 않습니다
- OTLP 내보내기, 자동 수집 파이프라인 또는 자세한 추적 및 진단 로그를 대체합니다.
- 페이로드에 이벤트 ID가 포함되어 있기 때문에 정확히 한 번만 전달됩니다.
- 원시 공급자 페이로드, 사용자 콘텐츠, 자격 증명 또는 규제 데이터를 수집할 수 있는 권한입니다.
이벤트 스키마 예제
이 워크플로의 이벤트 스키마
쿼리 또는 스니펫을 프로덕션에 적용하기 전에 행 그레인, 방출 경계, 필수 유형, 개인 정보 보호 클래스, 예제 페이로드 및 유효성 검사 체크리스트를 검토하세요.
관련 제품 기능
이 워크플로를 다음에서 계속하세요. 알림
검토된 신뢰성 쿼리를 소유한 임계값 및 응답 워크플로로 승격합니다.
관련 SQL 레시피
더 많은 SQL 예제
이 워크플로의 구조화된 필드에 대해 쿼리를 실행하고, 예제 결과를 검사하고, 유용한 답변을 대시보드 또는 알림으로 전환하세요.
경로별 API 요청 처리량 계산
분당 가장 많은 요청을 처리하는 API 경로는 무엇입니까?
레시피 열기API 429 속도 제한 복구 측정
HTTP 429를 수신하는 요청이 재시도 후에 성공적으로 복구됩니까?
레시피 열기경로별 API 오류율 계산
요청이 20건 이상인 API 경로 중 5xx 오류율이 가장 높은 경로는 무엇인가요?
레시피 열기p50, p95 및 p99 API 대기 시간 계산
꼬리 지연 시간이 가장 긴 엔드포인트는 무엇입니까?
레시피 열기API 오류 예산 소진율 계산
API는 99.9% 가용성 예산을 얼마나 빨리 소모합니까?
레시피 열기누락된 서비스 하트비트 감지
어떤 예상 원격 분석 소스가 하트비트 전송을 중단했나요?
레시피 열기경로 및 릴리스별로 핵심 웹 바이탈 비교
프런트엔드 성능이 가장 약한 경로와 릴리스는 무엇입니까?
레시피 열기구현 제품군별로 찾아보기
관련 통합 패턴 비교
이 통합과 페어링할 템플릿
더 많은 통합
Pino 구조화된 이벤트 분석
Node.js 요청, 작업 및 제품 신뢰성 분석을 위해 Pino 진단 로그를 제한된 Telemetry 결과 이벤트와 결합합니다.
가이드 열기NestJS 요청 및 워크플로 Telemetry
정규화된 경로 결과, 대기 시간, 오류, 릴리스 및 승인된 계정 컨텍스트를 사용하여 NestJS 컨트롤러 및 공급자를 계측합니다.
가이드 열기구글 클라우드 실행 Telemetry
애플리케이션 소유의 구조화된 이벤트를 통해 Cloud Run 요청 및 작업 결과, 콜드 스타트 컨텍스트, 인스턴스 동시 실행, 재시도, 지연 시간, 출시를 추적하세요.
가이드 열기