콘텐츠로 건너뛰기
Telemetry
구조화된 이벤트 SQL 레시피

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

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

초보자service_heartbeats검토됨 2026-07-27테스트됨 아파치 DataFusion 45.2.0

검토자 Telemetry 제품 팀 . SQL 호환성, 이벤트 계약, 합성 출력 및 운영상의 주의사항. 표준 및 소유권 검토

질문에 답변됨

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

침묵은 프로세스 중단이나 수집 경로 중단의 첫 번째 증상인 경우가 많습니다. 이 쿼리는 각 소스의 최신 하트비트를 예상 보고 간격과 비교합니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp심장 박동이 관찰되었을 때.
service_nameUtf8안정적인 소스 또는 서비스 이름입니다.
environmentUtf8프로덕션, 준비 또는 개발.
statusUtf8심장 박동 시간에 건강하거나 성능이 저하되었습니다.
DataFusion SQL

쿼리 복사

sql
SELECT
  service_name,
  environment,
  MAX(timestamp_utc) AS last_seen_at,
  COUNT(*) AS heartbeats_in_window
FROM service_heartbeats
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
  AND environment = 'production'
GROUP BY service_name, environment
HAVING MAX(timestamp_utc) < now() - INTERVAL '10 minutes'
ORDER BY last_seen_at ASC;

이 읽기 전용 쿼리는 빈 유형의 테이블에 대해 계획되고 실행됩니다. 아파치 DataFusion 45.2.0. 결정론적 샘플 출력은 합성되어 별도로 검토됩니다. 자신의 데이터에 대해 필드 유형, 임계값 및 비즈니스 정의를 검증합니다. 테스트 방법론을 읽어보세요.

쿼리 결과

하트비트 기한이 지난 프로덕션 소스

가장 오래된 last_seen_at 값을 먼저 조사해야 합니다.

service_nameenvironmentlast_seen_atheartbeats_in_window
billing_syncproduction2026-07-27 15:04:00Z132
email_workerproduction2026-07-27 15:11:00Z139

합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.

Production sources past the heartbeat deadline: Detect Missing Service Heartbeats 예제 결과의 합성 last_seen_at 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. illustrative 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.

SQL 작동 방식

  1. 1MAX(timestamp_utc)는 각 소스에 대해 가장 최근에 관찰된 하트비트를 반환합니다.
  2. 2그룹화 후 필터를 사용하여 최신 이벤트가 허용된 침묵 기간보다 오래된 서비스만 유지합니다.
  3. 3개수는 유용한 컨텍스트를 제공합니다. 전체 전환 확인 기간에 이벤트가 없는 소스에는 이 이벤트 전용 쿼리가 아닌 예상 소스 테이블이 필요할 수 있습니다.

결정해야 할 극단적인 경우

  • 하트비트를 생성한 적이 없는 소스는 나타날 수 없습니다. 완전한 적용 범위가 중요한 경우 예상 소스 레지스트리를 유지하십시오.
  • 임계값을 일반 간격과 수집 및 예약 지터보다 높게 설정합니다.
  • 시끄러운 알림을 피하기 위해 계획된 유지 관리 또는 장애가 있는 작업자를 분리하십시오.

추천 대시보드

  • 통계: 마감일이 지난 소스 수
  • 표: service_name의 last_seen_at
  • 꺾은선형 차트: 소스별 하트비트 볼륨

알림 안내

2~3개의 예상 간격이 누락된 후 알림하고 마지막으로 표시된 시간과 런북 링크를 포함합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

분석 계속하기

실제 이벤트에서 실행

테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.

무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.

API 키 받기