콘텐츠로 건너뛰기
Telemetry
문서 찾아보기
가이드업데이트된 2026년 7월 30일Telemetry 편집 및 제품 팀의 검토2 최소 읽기

코딩 에이전트와 함께 이 문서를 사용하세요.

Claude Code, Codex, Cursor 또는 다른 코딩 에이전트에 대한 집중 프롬프트 팩을 연 다음 여기에서 다루는 워크플로에 맞게 조정하세요.

이 페이지에서
  1. 쿼리를 수동으로 확인하세요.
  2. 조건을 확인하세요
  3. 평가 이력 점검
  4. 수신자 및 이메일 전달 확인
  5. 안전하게 소음을 줄여보세요

알림 전달 및 문제 해결

알림은 쿼리, 평가 지점, 임계값 상태 및 알림 전달이라는 네 가지 독립적인 부분으로 구성됩니다. 해당 순서대로 확인하여 이메일 문제가 적합한 데이터를 반환하지 않은 쿼리와 혼동되지 않도록 하세요.

Telemetry 대시보드에 추가 옆에 알림 생성 작업을 보여주는 탐색 결과

이미 실행하고 검토한 결과에서 알림을 만든 다음 별도의 단계로 평가 및 전달 문제를 해결합니다.

쿼리를 수동으로 확인하세요.

저장된 탐색 또는 SQL 쿼리를 열고 알림에 사용된 것과 동일한 시간 범위를 실행합니다. 알림이 계열을 평가할 때 숫자 값과 시간순 타임스탬프 열을 반환하는지 확인하세요.

완전한 버킷을 사용하십시오. 최신 포인트가 계속 변경될 수 있으므로 부분적으로 채워진 버킷이 임계값을 넘을 수 있는 경우 마지막 데이터 포인트 무시를 활성화하세요.

조건을 확인하세요

확인:

  • 평균, 최대값, 합계 또는 p95와 같은 집계
  • 최근 포인트 수
  • 비교 연산자
  • 임계값 및 단위
  • 평가 간격
  • 쿼리의 최소 트래픽 또는 분모 보호 장치

오류율 알림은 백분율을 계산하기 전에 실패와 요청을 모두 반환해야 합니다. 대기 시간 알림에는 값이 밀리초인지 초인지 명시되어야 합니다.

평가 이력 점검

알림 세부 정보 페이지를 열고 최근 평가 상태 및 이벤트를 검토하세요. 구별:

  • 데이터가 반환되지 않았습니다
  • 쿼리 실행 실패
  • 점수가 평가되었으나 위반하지 않았습니다.
  • 위반이 감지됨
  • 알림 전달을 시도했습니다.

쿼리가 실패하면 쿼리 작업 영역에서 쿼리를 실행하고 테이블 이름, 필드 유형, SQL 호환성 및 구성된 타임스탬프 열을 검사합니다.

수신자 및 이메일 전달 확인

수신자 주소가 현재 주소이고 공백이나 복사하여 붙여넣기 가능한 아티팩트가 포함되어 있지 않은지 확인하세요. 스팸 필터링을 확인하고 구성된 Telemetry 발신자의 메시지를 허용합니다. 설정 중에 제어된 테스트 임계값을 사용한 다음 배송이 확인된 후 프로덕션 임계값을 복원하십시오.

단순히 테스트하기 위해 프로덕션 알림 임계값을 반복적으로 낮추지 마십시오. 페이징 또는 수익 워크플로가 영향을 받을 수 있는 경우 테스트를 복제하거나 일시적으로 격리합니다.

안전하게 소음을 줄여보세요

알림을 보내기 전에 여러 개의 완전한 지점, 최소 볼륨 또는 절대 영향 임계값이 필요합니다. 정보 수명주기 변경 사항을 예정된 검토로 보냅니다. 명확한 소유자와 응답이 있는 상태에 대한 즉각적인 알림을 예약합니다.

알림을 읽은 다음 모든 SQL 레시피에 포함된 알림 지침을 사용하세요.

관련 제품 기능

검토된 SQL을 자체 임계값 및 응답 워크플로로 승격합니다.

소유권 및 기술 참조

이 설명은 Telemetry 편집팀의 소유입니다. 제품 팀은 동작, 예시, 경계를 검토합니다.

편집 기준 검토