로그 및 가시성 동기화

클라우드 데이터 인제스트(CDI) 동기화 로그 대시보드를 통해 CDI에서 처리된 모든 데이터를 모니터링하고, 데이터가 성공적으로 동기화되었는지 확인하며, “잘못된” 데이터나 누락된 데이터와 관련된 문제를 진단할 수 있습니다.

동기화 로그에 접근하려면 데이터 설정 > 클라우드 데이터 수집으로 이동한 후 동기화 로그 탭을 선택하세요.

싱크 로그 대시보드 이해하기

메인 동기화 로그 페이지에서는 모든 동기화 실행에 대한 개요를 제공하며, 여기에는 현재 상태 또는 최종 상태별 최근 동기화 작업 개요가 포함됩니다.

• 달리기: 현재 진행 중인 작업을 동기화합니다.
• 성공: 동기화 작업이 완료되었으며, 모든 행이 성공적으로 처리되었습니다.
• 부분적 성공: 완료되었지만 하나 이상의 행에서 오류가 발생한 작업 동기화
• 오류: 완료되지 못한 작업 동기화
• 한도 초과: 데이터 한도를 초과하여 처리가 중지된 작업을 동기화합니다.

동기화 로그에는 각 동기화에 대해 다음과 같은 세부 정보도 제공됩니다:

• 동기화 이름: 동기화 구성의 이름.
• 실행 ID: 동기화 작업의 특정 실행에 대한 고유 식별자. 이 ID를 선택하여 자세한 내용을 확인하세요. 이 기능은 CDI API 엔드포인트에서도 사용할 수 있으며, Braze 지원팀과 동기화 실행을 참조하는 데에도 활용할 수 있습니다.
• 상태: 실행 상태 (성공, 부분 성공, 오류, 실행 중).
• 소스에서 읽은 새 행: 이번 실행을 위해 데이터 웨어하우스에서 가져온 새 행의 수.
• 결과: 실행 내에서 성공하거나 실패한 행 수의 세부 내역.
• 마지막 이 동기화 실행에서 “UPDATED_AT”:처리된 가장 최근 레코드의 타임스탬프.
• 실행 시작 시간: 동기화 작업이 시작되었을 때.
• 실행 시간: 동기화 작업이 완료되는 데 걸린 총 시간.

데이터 보존

모든 행 수준 페이로드 및 오류 세부 정보를 포함한 동기화 데이터는 최대 30일간 보관됩니다. 30일 이상 지난 로그 파일은 자동으로 삭제됩니다.

처리된 행 수와 같은 동기화 실행 메타데이터는 최소 12개월 동안 유지됩니다.

동기화 로그 필터링

동기화 로그 테이블을 필터하여 특정 실행을 찾을 수 있습니다. 사용 가능한 필터는 다음과 같습니다:

• 근무 시작일: 사전 정의된 범위(예: “지난 30일”) 또는 커스텀 날짜 범위를 선택하십시오.
• 상태: 하나 이상의 동기화 상태로 필터링합니다(예: 오류 및 부분 성공 상태만 표시).
• 동기화 이름: 특정 동기화를 이름으로 검색하세요.

특정 동기화를 조사하려면 동기화 로그 테이블에서 관련 실행 ID를 선택하십시오. 실행 세부 정보 페이지에서는 동기화 과정에 대한 세분화된 행별 로그를 확인할 수 있습니다.

실행 개요

이 섹션은 선택된 실행을 요약하여 시작 시간, 종료 시간, 지속 시간 및 소스에서 읽은 총 행 수를 포함합니다. 또한 성공한 행 수와 오류가 발생한 행 수를 제공합니다.

이번 실행에서 처리된 행 수

이 테이블은 동기화 과정에서 처리된 데이터에 대한 행 단위 가시성을 제공하여 개별 레코드를 검증할 수 있도록 합니다.

• 검색: 실행 결과 내에서 사용자 ID로 검색하기 바를 사용하여 특정 사용자를 검색할 수 있습니다.
• 사용 가능한 세부 정보:
  • UPDATED_AT: 해당 특정 행의 열에서UPDATED_AT 가져온 타임스탬프.
  • ID: 사용자 식별자(예: external_id,email , 또는 alias_name)는 해당 레코드를 Braze 고객 프로필과 매칭하는 데 사용됩니다.
  • 상태: 해당 행의 개별 처리 상태(성공 또는 오류).
  • 소스 페이로드: 데이터 페이로드를 볼 수 있는 링크.
  • 오류 원인: 상태가 오류인 경우, 이 열은 행이 동기화되지 못한 이유를 설명하는 메시지를 제공합니다.

페이로드 보기

특정 행에 대해 Braze로 전송된 정확한 데이터를 보려면 소스 페이로드 열에서 ‘페이로드 보기’를 선택하세요. 해당 사용자에 대해 처리된 원시 JSON 페이로드를 표시합니다.

동기화 로그 내보내기

‘수행된 동기화 작업에 대한 행 수준 로그를 내보내려면’ ‘수행된 동기화 작업에 대한 행 수준 로그를 내보내려면’ ‘수행된 동기화 작업에 대한 행 수준 로그를 내보내려면’ ‘수행된 동기화 작업에 대한 행 수준 그런 다음 내보내기 방법을 선택하세요:

• 오류가 있는 행: 오류 상태인 행만 포함된 파일을 다운로드합니다.
• 모든 행: 실행 중에 처리된 모든 행이 포함된 파일을 다운로드합니다.

대시보드에서 로그를 직접 내보낼 수 없습니다. 내보내기가 생성된 후 로그 내보내기 파일을 다운로드할 수 있는 링크가 포함된 이메일을 받게 됩니다.

Notifications

CDI 동기화 상태에 대한 최신 정보를 받아보려면 이메일 알림을 설정할 수 있습니다. 이 설정은 동기화를 생성할 때 구성되며 언제든지 업데이트할 수 있습니다.

오류 알림

동기화 수준 오류에 대한 알림을 수신하려면 최소한 하나의 이메일 주소 연락처가 필요합니다. 전체 동기화 작업이 실행 또는 완료에 실패하거나, 만료된 자격 증명이나 누락된 소스 테이블과 같이 사용자 개입이 필요한 오류가 발생한 경우 이러한 알림이 전송됩니다.

추가 알림에는 다음이 포함됩니다:

• 행 오류: 동기화 과정에서 특정 비율의 행이 업데이트에 실패할 때 알림을 받습니다.
• 실패 임계값(%): 경보를 트리거해야 하는 행 실패 비율을 지정하십시오. 예를 들어, 이 값을 1로 설정하면 동기화 실행 시 행의 1% 이상에서 오류가 발생할 경우 알림을 전송합니다.
• 동기화 성공: 동기화가 성공적으로 완료되면 알림을 받습니다.
• 변경된 행이 없더라도 알림: 성공적인 동기화 실행 시 새 행이나 업데이트된 행이 전혀 처리되지 않았더라도 알림을 받습니다.