프로덕션 계측 체크리스트

합성 이벤트, 쿼리, 대시보드 및 알림 작업이 끝난 후 이 체크리스트를 사용하십시오. 목표는 최대 이벤트 적용 범위가 아니라 소유자와 폴백을 갖춘 제한된 프로덕션 롤아웃입니다.

이벤트 계약

• 이벤트 이름은 하나의 지속 가능한 워크플로 결과를 설명합니다.
• 요청, 작업, 계정, 에이전트 실행, 웹훅 또는 기타 안정적인 단위 등 비즈니스 세부 사항이 문서화됩니다.
• 필수 및 선택 필드는 유형 및 단위와 함께 나열됩니다.
• 상태, 오류, 기능, 릴리스 및 환경 값은 제한된 어휘를 사용합니다.
• 안정적인 식별자는 비밀을 노출하지 않고 관련 이벤트를 연결합니다.
• 재시도 및 반복 시도는 최종 결과와 구별될 수 있습니다.

이벤트 스키마 설계, 표준 와이드 이벤트 및 상관 ID를 검토하세요.

민감한 데이터 경계

• 비밀번호, API 키, 인증 헤더, 쿠키 및 세션 토큰은 금지됩니다.
• 원시 요청 본문, 웹훅 페이로드, 프롬프트, 완료 및 작업 페이로드는 별도로 검토되지 않는 한 그대로 유지됩니다.
• 경로 템플릿은 식별자가 포함된 URL을 대체합니다.
• 오류 범주는 가능한 경우 원시 개인 콘텐츠를 대체합니다.
• 개인 또는 규제 필드에는 승인된 목적, 액세스 경계 및 보존 기간이 있습니다.

검토하는 동안 민감한 데이터 수정 및 보안 및 데이터 처리 개요를 사용하세요.

자격 증명 및 환경

• 프로덕션 수집은 명명된 쓰기 범위 키를 사용합니다.
• 보고 자동화는 별도의 읽기 범위 키를 사용합니다.
• 키는 비밀 관리자 또는 보호된 런타임 구성에 있습니다.
• 스테이징 및 프로덕션에서는 별도의 키와 명시적인 environment 필드를 사용합니다.
• 순환 및 해지 소유권이 기록됩니다.

배포된 모든 환경을 확인하거나 호환 가능한 폴백을 제공하지 않고 필수 환경 변수를 도입하지 마세요.

배달 및 실패 동작

• Telemetry 전송에는 제한된 시간 초과가 있습니다.
• 텔레메트리 오류는 기본 애플리케이션 결과를 손상시키지 않습니다.
• 재시도는 제한되어 있으며 관찰 가능합니다.
• 선택한 SDK에 대해 종료 또는 세척 동작을 테스트합니다.
• 대용량 루프는 승인된 이유 없이 모든 내부 단계에 대해 이벤트를 생성하지 않습니다.

Telemetry 엔드포인트를 사용할 수 없거나 느린 상태에서 제어된 테스트를 실행합니다. 애플리케이션은 문서화된 대체를 따라야 합니다.

스키마 및 데이터 수명주기

• 최종 테이블에서 합성 행이 검사되었습니다.
• 필드 유형은 기존 프로듀서 및 저장된 쿼리와 계속 호환됩니다.
• 파티션 선택은 실제 쿼리 필터를 반영합니다.
• 보존은 운영 및 개인정보 보호 목적과 일치합니다.
• 행 및 테이블 삭제 책임을 이해합니다.

스키마 진화, 파티션 열 선택, 데이터 보존 및 삭제를 참조하세요.

분석 및 대응

• 처음으로 저장된 SQL 결과는 알려진 고정 장치와 일치합니다.
• 분모, 제외, 기간 및 신원 규칙이 문서화되어 있습니다.
• 대시보드 위젯은 검사 가능한 SQL 또는 행으로 다시 연결됩니다.
• 모든 알림에는 테스트된 임계값, 수신자 및 대응 조치가 있습니다.
• 상업, 보안 또는 고객 차원에는 적절한 액세스 경계가 있습니다.

결과를 프로덕션 증거로 처리하기 전에 SQL 테스트 방법론 및 관련 SQL 레시피를 사용하세요.

점진적으로 출시

하나의 서비스, 작업자 또는 경로로 시작하세요. 확장하기 전에 이벤트 볼륨, 스키마 동작, 쿼리 비용, 배달 실패 및 알림 소음을 관찰하세요.

기록:

• 소유자 및 검토 날짜.
• 배포된 서비스 및 릴리스.
• 예상 일일 이벤트 볼륨입니다.
• 저장된 쿼리 및 대시보드 링크.
• 알림 수신자 및 응답 문서.
• 알려진 격차와 다음 검토 트리거.

워크플로가 이 체크리스트를 통과하면 증거를 확장합니다. 그렇지 않은 경우 경계가 명확해질 때까지 이벤트를 개발 또는 준비 상태로 유지하십시오.