콘텐츠로 건너뛰기
Telemetry
SQL 레시피 모음

구조화된 이벤트 SQL 레시피

재사용 가능한 구조적 이벤트 SQL에서 중첩 필드, 시간 버킷, 창 기능, 하트비트 확인 및 안전 차원을 사용합니다.

공통 이벤트 계약

이러한 쿼리를 재사용 가능하게 유지하는 필드

  • timestamp_utc, event_name, 소스, 환경 및 schema_version
  • correlation_id, request_id, user_id, team_id 및 릴리스
  • 입력된 상태, 기간, 금액, 개수 및 분류된 오류 필드

SQL 이전의 정의

쿼리가 대신 내릴 수 없는 결정

  1. 1많은 부분 메시지 대신 완료된 작업 단위에 대해 하나의 이벤트를 사용하십시오.
  2. 2SQL이 이식성을 유지하도록 타입이 지정된 필드와 명시적 단위를 보존합니다.
  3. 3이벤트 계약 외부에 비밀과 원시 비공개 콘텐츠를 유지하세요.

권장 순서

먼저 탐지를 구축한 다음 진단을 구축하세요.

분석 패턴

결과를 통해 결정을 설명

하나의 정식 완료 이벤트를 내보냅니다.

완료된 작업 단위에 대한 입력, 결과, 기간, 안정적인 식별자 및 분류된 오류 컨텍스트를 기록합니다.

유형이 지정되고 제한된 치수 사용

구문 분석이 필요하거나 무제한 그룹을 생성해야 하는 값보다 명시적인 숫자, 부울, 단위 및 명명된 범주를 선호합니다.

상관 관계를 의도적으로 유지

정의된 질문에 필요한 이벤트를 연결하는 경우에만 요청, 실행, 전달, 계정 또는 작업 식별자를 사용하십시오.

완전한 레시피

쿼리를 복사한 다음 가정 검증

초보자service_heartbeats

누락된 서비스 하트비트 감지

오류 이벤트가 나타나기 전에 보고가 중지된 서비스, 작업자 또는 예약된 작업을 찾아보세요.

어떤 예상 원격 분석 소스가 하트비트 전송을 중단했나요?

SQL 및 결과를 참조하세요.
중급agent_events

중첩된 AI 도구 호출 이벤트 쿼리

원래 이벤트 페이로드를 평면화하지 않고 점으로 중첩된 필드를 필터링하고 실패한 도구의 순위를 매깁니다.

가장 많이 실패한 호출과 관련된 AI 도구 및 인수는 무엇입니까?

SQL 및 결과를 참조하세요.
고급api_requests

롤링 기준선을 사용하여 오류율 급증 감지

하나의 영구 임계값에 의존하는 대신 각 시간별 API 오류율을 롤링 7버킷 평균과 비교합니다.

최근 기준보다 훨씬 높은 시간당 오류율 버킷은 무엇입니까?

SQL 및 결과를 참조하세요.
고급workflow_timeline_events

상호 연관된 워크플로우 타임라인 재구성

공유 워크플로 식별자에서 정렬된 서비스 간 워크플로 단계와 경과 시간을 재구성합니다.

최근 실패한 워크플로에서 순서대로 어떤 일이 발생했나요?

SQL 및 결과를 참조하세요.

임계값 이전에 이벤트 계약을 조정하세요.

분석 패턴을 유지하되 자신의 이벤트에 대해 테이블 이름, 필드 유형, 비즈니스 정의, 기간 및 최소 볼륨 규칙을 검증하세요. 게시된 모든 쿼리는 고정된 엔진을 사용하여 빈 형식의 테이블에 대해 계획되고 실행됩니다.