Cloud Functions 문제 해결

Cloud Functions를 이용하면서 사용자가 만날 수 있는 문제 상황과 원인 및 해결 방법을 안내합니다. 하지만 일부 문제 상황은 다음 안내를 숙지하여도 사용자가 직접 해결하기 어려운 과제일 수 있습니다. 이러한 사용자의 어려움을 효율적으로 해결하고자 네이버 클라우드 플랫폼은 다양한 문제 해결 창구도 함께 제공하고 있습니다.

Cloud Functions 문제 해결은 다음과 같은 몇 가지 주제로 구성되어 있습니다.

• 제한 사양
• 네트워크
• 로그
• 리소스
• 연동 서비스

제한 사양

제한 사양과 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

액션 실행 결과 Too many concurrent requests in flight()와 같은 형태의 응답이 리턴됐습니다.

• 원인: concurrent의 기본값을 초과한 경우입니다.
• 해결 방법: Cloud Functions 사용 준비를 참고하여 동시 실행 가능한 액션 개수를 수정해 주십시오. concurrent 기본값을 상향 조정해야 하는 경우 네이버 클라우드 플랫폼에 문의해 주십시오.

네트워크

네트워크와 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

VPC 액션에서 VPC VM 통신이 되지 않습니다.

• 원인: VM에 멀티 NIC(Public Subnet 1개 이상)가 설정된 경우 rp_filter(Reverse Path Filter)에 의해 패킷이 kernel drop될 수 있습니다.
• VM에서 다음과 같이 static route를 설정해 주십시오.

  # static route 추가
  ip route add <액션과 연결한 서브넷 대역대> via <VM의 Private NIC Gateway IP>
  
  # 예시
  Action과 연결된 VPC Subnet(Private) subnetA 대역대 10.0.10.0/24
  VM에는 연결된 서브넷:
    Subnet(Public) subnetB (10.0.20.0/24)
    Subnet(Private) subnetC (10.0.30.0/24)
  VM NIC
    eth0 ip 10.0.20.3 mask 255.255.255.0 g/w 10.0.20.1
    eth1 ip 10.0.30.5 mask 255.255.255.0 g/w 10.0.30.1
  
  ip route add 10.0.10.0/24 via 10.0.30.1
  

로그

로그와 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

대시보드/모니터링에서 실행 이력이 확인되지 않습니다.

• 원인: Cloud Functions의 실행 이력은 모두 Cloud Log Analytics에 저장되며 모니터링/대시보드에서는 Cloud Log Analytics에 저장된 실행 이력을 출력합니다. Cloud Log Analytics에 로그 적재 지연이 발생하면 일시적으로 실행 이력이 확인되지 않습니다.
• 해결 방법: Cloud Log Analytics에 로그가 있는지 확인합니다. Cloud Log Anaytics에는 로그가 있는데 Cloud Functions 모니터링/대시보드에서 확인되지 않거나 지연이 계속해서 발생할 경우 네이버 클라우드 플랫폼에 문의해 주십시오.

리소스

액션, 트리거, 패키지와 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

Python 액션 실행 시 "cannot import name ~" 와 같은 오류가 발생합니다.

• 원인: 코드 압축 파일에 라이브러리가 누락됐거나 시스템 라이브러리가 누락됐기 때문에 발생한 오류입니다.
• 해결 방법: 다음을 참고해 주십시오.
  • 코드 압축 파일 라이브러리 누락: 이 가이드의 Cloud Functions 예제 > 런타임별 액션 생성과 활용 > Python의 의존성 파일을 함께 패키징하여 액션 생성을 참고해 주십시오.
  • 시스템 라이브러리 누락: python 라이브러리가 시스템 라이브러리(e.g. *.so, *.dll)를 참조하는 os-dependent할 경우 주로 발생하거나 압축 파일에 windows 또는 macos 시스템 라이브러리가 포함되거나 CF 런타임 이미지에 참조할 시스템 라이브러리가 없을 경우 주로 발생하므로 해당 원인을 해결해 주십시오.

연동 서비스

연동 서비스와 관련된 문제 상황별 원인 및 해결 방법은 다음과 같습니다.

200이 아닌 HTTP Status 코드가 리턴됩니다.

• 원인: 비동기 실행 호출 시(blocking=false query param) 202(Accepted)가 리턴됩니다. 액션 실행 자체만 체크하기 때문에 액션 코드 내부 동작의 성공 및 실패 여부는 관여하지 않습니다. 또한 동기 호출 시, 정상 실행 성공 시 200(OK)이 리턴됩니다. 액션이 1분 이상 실행될 경우 비동기 실행으로 전환되며 202(Accepted)를 리턴합니다.