Marketing Cloud Engagement | Enhanced FTP 사이트에 SFTP로 연결할 때 발생하는 일시적인 오류의 원인과 해결 방법

Marketing Cloud Engagement(MCE)의 SFTP를 이용한 파일 전송 처리는 일시적인 연결 오류로 인해 실패할 수 있습니다. 이러한 일시적 오류는 대부분 인터넷 측의 일시적 문제이며, MCE 서비스나 클라이언트 측 설정으로 인한 것이 아니므로 회피 및 원인 파악이 불가능하다는 특징이 있습니다.

에러의 주요 원인

SFTP 연결은 클라이언트와 서버 간에 인터넷을 경유하여 통신합니다. 인터넷은 통신 품질이 보장되지 않는 'best-effort' 네트워크입니다. 따라서 경로상에서 발생하는 일시적인 네트워크 혼잡이나 패킷 손실로 인해 예기치 않은 연결 끊김이나 연결 오류가 발생할 수 있습니다. 이로 인해 당사 및 연결 소스 서비스의 가동 상황에 문제가 없더라도 산발적으로 일시적인 오류가 발생합니다. 이러한 원인 조사 및 문제회피는 어렵습니다.

또한, Marketing Cloud Engagement는 다수의 고객이 자원을 공유하는 '멀티테넌트(multi-tenant)' 환경에서 제공됩니다. 다른 이용자의 높은 부하를 발생시키는 처리가 자사의 SFTP 성능에 일시적인 영향을 미칠 가능성도 고려해야 합니다. 따라서 다음 항목과 같이 효과적인 재실행 프로세스의 구축을 검토해 주십시오.

가장 효과적인 대책 : 재시도 프로세스 구현

일시적인 오류는 피할 수 없다는 전제하에, 파일 전송을 자동화하는 스크립트에는 재실행 프로세스를 반드시 구현해야 합니다. 이를 통해 시스템의 안정성을 크게 향상시킬 수 있습니다.

재실행 처리를 할 때는 단순히 일정 시간 기다렸다가 다시 실행하는 방법이나, 다음과 같은 "exponential backoff" 개념을 도입하는것도 유용합니다.

• Exponential Backoff : 실행이 실패할 때마다 다음 시도까지 기다리는 시간을 지수적으로 늘리는 방식입니다 (예: 1초, 2초, 4초, 8초…). 

재실행으로도 해결되지 않는 경우 장애 원인 특정 방법

반복적으로 오류가 발생하고 재실행으로도 문제가 해결되지 않는다면, 아래 예시와 같은 순서로 문제를 체계적으로 해결해야 합니다. 이 외에도 인터넷을 경유하는 경우에는 모든 장비가 관여하므로, 의심스러운 것이 있다면 필요에 따라 확인하는 것을 권장드립니다.

1. Step 1: Salesforce Trust 사이트 확인

   1. status.salesforce.com 에 접속하여 사용중이신 인스턴스(MID)에서 Marketing Cloud Engagement서비스 장애나 점검이 진행중인지 확인합니다. 만약 Enhanced FTP 사이트의 문제가 보고되었다면, 해당 문제에 대한 업데이트를 기다려 주십시오.

2. Step 2: 클라이어트 설정과 소프트웨어 검증

   • 자동화 스크립트에서 오류가 발생하고 있다면, 해당 디바이스에서 표준 SFTP 클라이언트 툴을 사용해 동일한 인증 정보로 수동 연결이나 파일 전송을 시도해 보십시오.
   • 이 시도가 성공한다면, 문제의 원인은 스크립트의 로직이나 사용 중인 라이브러리에 있을 가능성이 매우 높아집니다.

3. Step 3: 네트워크 경로진단

   • 표준 클라이언트에서도 연결이 안 될 경우, 네트워크 경로의 문제가 의심됩니다. Command Prompt나 터미널에서  traceroute 를 실행하여 엔드포인트에 SFTP 사이트까지의 네트워크 경로 전송 상황을 확인하고, 제대로 전송되고 있는지 확인하세요. 
   • 실행 결과에서 특정 경로에 현저한 지연이나 연속적인 타임아웃이 발생하는지 확인하세요.

※드문 사례로써, 특정 인터넷 회선에서만 지속적으로 통신 품질 저하가 발생하는 경우가 있습니다. 만약 다른 인터넷 회선을 통해 연결할 수 있는 환경이 준비되어 있다면, 해당 회선을 통해 Enhanced FTP 사이트로 파일 전송을 시도해 보십시오. 다른 회선을 통해 문제없이 연결 및 전송이 가능하다면, 해당 회선에 문제가 발생했을 가능성이 높습니다.

문의주실때 필요한 정보

위의 문제 해결 절차를 모두 시도했는데도 문제가 해결되지 않고 원인이 클라이언트나 네트워크 경로에 없다고 판단될 경우, 다음 정보를 확인하여 Salesforce 지원팀에 문의하는 것을 검토 해 보십시오. 문의할 때 아래 정보를 케이스에 포함해 주시면 더 원활하게 조사를 진행 할 수 있습니다.

• 오류가 발생한 정확한 날짜 및 시간(타임존 포함)

• 대략적인 발생 빈도

• 전체 오류 메시지

• 연결 소스의 글로벌 IP 주소

• traceroute 의 실행결과

• 다른 SFTP 클라이언트에서도 문제가 재현되는지 확인

*주의하실 점*

・Marketing Cloud Engagement의 Enhanced FTP 사이트 서비스에 문제가 있는지 확인하는 것이 주요 조사 대상입니다. 

・문의하실 때 Enhanced FTP 사이트의 로그 제공을 요청하시는 경우가 있습니다만, 로그 자체는 제공해 드리지 않는 점 양해 부탁드립니다.

・Marketing Cloud Engagement 서비스 운영에 문제가 없더라도, 인터넷 등의 일시적인 문제로 인해 일부 연결이나 파일 전송 처리가 실패하거나, 연결이 리셋되어 클라이언트 측에서 I/O 예외 등이 발생할 수 있습니다. FTP 통신 연결 불량은 FTP 클라이언트부터 인터넷, Marketing Cloud Engagement 측 서비스에 이르기까지 모든 장비와 요인이 관여하므로, 산발적으로 발생하는 문제에 대해서는 조사가 불가능하며 원인을 알 수 없다는 점을 미리 양해해 주시기를 부탁드립니다. 이러한 일시적인 오류가 불가피한 특성을 고려하여, 효율적인 재실행 프로세스를 구축하시는 것을 권장합니다.