HTTPS Listener

HTTPS Listener는 외부 시스템이 보내는 웹훅 요청을 받아 이벤트를 Foundry 스트림에 기록합니다. 외부 시스템이 이벤트 알림용 웹훅은 제공하지만 표준 Foundry 인증이나 API 요청 형식은 지원하지 않을 때 사용할 수 있습니다.

설정과 출력

Data Connection > Listeners에서 Listener를 생성하고 외부 서비스에 맞는 유형을 선택합니다. 설정 마법사에 표시되는 인증 또는 서명 검증 항목을 입력하고, 필요한 하위 도메인 연결 및 관리자 승인을 완료한 뒤 Listener를 시작합니다. 외부 시스템에는 생성된 엔드포인트를 등록합니다.

Listener의 Overview에서 출력 스트림을 찾을 수 있습니다. Data Lineage에서 스트림과 후속 변환의 연결 관계도 확인할 수 있습니다. 이벤트를 받은 뒤 액션이나 함수를 실행하려면 Automate를, 스트리밍 변환에는 Pipeline Builder를, 이력 분석에는 아카이브 데이터셋을 사용합니다. 처리 방식별 조건을 확인한 뒤 구성합니다.

수신 요청은 공급자별 인증 방식을 사용합니다. Listener와 출력 스트림을 모두 적절한 프로젝트 권한과 보안 표지로 보호해야 합니다. HTTPS 보안과 하위 도메인 설정에 수신 범위와 엔드포인트 회전 절차가 있습니다.

처리량과 크기 제한

HTTPS Listener는 낮은 처리량의 이벤트 수신에 적합하며, 요청 속도 제한은 대략 초당 100건입니다. 이보다 훨씬 높은 처리량에는 스트리밍 동기화나 공개 스트리밍 API를 우선 사용합니다. Listener만 사용할 수 있는 연동에서 더 높은 한도가 필요하면 Palantir 지원팀과 협의합니다.

개별 이벤트와 요청 페이로드는 1 MB로 제한됩니다. 출력 스트리밍 데이터셋의 최대 행 크기와 관련된 제한이며, 초과하는 이벤트는 거부됩니다. 후속 스트리밍 파이프라인의 처리량을 늘려도 Listener의 수신 한도는 그대로 적용됩니다.

지원하는 연동 유형

사용자 지정 Basic authentication Listener와 다음 서비스용 Listener를 사용할 수 있습니다. 서비스마다 설정 마법사에 나타나는 인증 정보와 검증 방식이 다르므로 동일한 인증 설정을 다른 유형에 그대로 적용하지 않습니다.