구조화된 이벤트에 대한 상관 ID

상관 관계 ID는 동일한 워크플로에서 생성된 레코드를 연결합니다. 인바운드 요청을 대기 중인 작업에 연결하거나 웹후크를 청구 동기화에 연결하거나 구조화된 결과 이벤트를 기존 추적에 연결할 수 있습니다.

하나의 의미를 지닌 ID를 선택하세요

그것이 나타내는 사물의 식별자 이름을 request_id, trace_id, job_id, webhook_delivery_id 또는 workflow_run_id로 지정합니다. 일반 correlation_id는 서로 다른 서비스가 서로 다른 의미를 부여할 때 사용하기가 더 어렵습니다.

신뢰할 수 있는 가장 빠른 경계에서 값을 생성하고 이를 다운스트림 작업을 통해 명시적으로 전달합니다. 이미 사용 가능한 업스트림 추적 ID를 유지합니다. 비동기 작업의 경우 원래 요청 또는 워크플로 ID와 각각 다른 질문에 대답할 때 작업 시스템의 자체 ID를 모두 저장합니다.

이메일 주소, 액세스 토큰 또는 원시 공급자 페이로드를 상관 관계 값으로 사용하지 마세요. 불투명한 내부 식별자는 회전하기 쉽고 쿼리 결과에 노출하는 것이 더 안전합니다.

워크플로 쿼리

관련 테이블이 식별자를 공유하면 SQL는 시퀀스를 재구성할 수 있습니다.

SELECT
  timestamp_utc,
  event_name,
  status,
  duration_ms,
  error_type
FROM workflow_events
WHERE workflow_run_id = 'run_example'
ORDER BY timestamp_utc;

집계 대시보드의 경우 ID 자체가 아닌 안정적인 카테고리별로 그룹화하세요. 엔지니어가 비율에서 구체적인 예로 이동할 수 있도록 최근 오류 테이블이나 드릴다운 쿼리에 상관관계 ID를 유지하세요.

일반적인 휴식 시간을 피하세요

각 서비스에서 새 요청 ID를 생성하지 마세요. 일부 행에는 요청 ID가 있고 다른 행에는 계정 ID가 있는 필드 하나를 오버로드하지 마십시오. 재시도를 확인하면 고유한 시도 또는 배달 ID를 받는 동안 워크플로 ID가 유지됩니다. 값이 신뢰 경계를 넘으면 기록하기 전에 형식과 길이를 확인하세요.

상관관계는 인과관계 자체가 아닌 탐색 가능성을 생성합니다. 가치가 어떻게 전파되고 어떤 이벤트가 최종 결과를 가져오는지 문서화하세요.

이 가이드를 로그, 지표, 추적 및 이벤트 및 높은 카디널리티 필드와 연결하세요.