문제 해결
이 문서는 NetFUNNEL CloudFront Agent 사용 중 발생할 수 있는 일반적인 문제와 해결 방법을 제공합니다.
설치 및 초기화
Lambda 함수 배포 실패
증상: Lambda 함수 버전 생성 또는 배포가 실패합니다.
해결 방법:
package.json파일의 형식이 올바른지 확인- Lambda 함수 코드에 문법 오류가 없는지 확인
- IAM 역할의 권한이 올바르게 설정되었는지 확인
- Lambda 함수가 us-east-1 리전에서 생성되었는지 확인
IAM 역할 설정 오류
증상: Lambda 함수 생성 시 IAM 역할 오류가 발생합니다.
해결 방법:
- Trust Entity에
edgelambda.amazonaws.com과lambda.amazonaws.com이 포함되었는지 확인 - IAM 정책이 올바르게 첨부되었는지 확인
- CloudWatch 로그 권한이 포함되었는지 확인
동작 문제
대기열이 적용되지 않음
증상: 트리거 규칙을 설정했지만 대기열이 적용되지 않습니다.
해결 방법:
- NetFUNNEL 콘솔에서 세그먼트 트리거 규칙이 올바르게 설정되었는지 확인
- URL이 트리거 규칙과 일치하는지 확인
- Lambda 함수의
clientID설정이 올바른지 확인 - CloudFront Distribution에 Lambda@Edge가 올바르게 연결되었는지 확인
- CloudFront 무효화가 완료되었는지 확인
대기실로 리다이렉트되지 않음
증상: 대기 응답을 받았지만 대기실로 리다이렉트되지 않습니다.
해결 방법:
- Lambda 함수의
vwrPageDomain설정 확인 - CloudFront Distribution의 Lambda@Edge 연결 확인
- CloudFront 무효화 상태 확인
네트워크 문제
Lambda@Edge 실행 실패
증상: Lambda@Edge가 실행되지 않거나 오류가 발생합니다.
해결 방법:
- Lambda 함수 코드에 오류가 없는지 확인
- Lambda 함수가 us-east-1 리전에서 생성되었는지 확인
- IAM 역할 및 정책 설정 확인
- CloudWatch 로그에서 오류 메시지 확인
설정 문제
Lambda config 값이 적용되지 않음
증상: Lambda config를 설정했지만 값이 반영되지 않습니다.
해결 방법:
- Lambda 함수에서 [Deploy] 버튼을 클릭했는지 확인
- [버전] 탭에서 [새 버전 발행]을 클릭했는지 확인
- CloudFront Distribution에서 Lambda 함수 버전을 업데이트했는지 확인
- CloudFront 무효화를 수행했는지 확인
- CloudFront 무효화 완료 후 충분한 시간(몇 분) 대기
CloudFront 무효화가 완료되지 않음
증상: CloudFront 무효화가 오래 걸리거나 완료되지 않습니다.
해결 방법:
- 무효화 상태를 확인하고 완료될 때까지 대기
- 무효화가 실패한 경우 다시 시도
- CloudFront 서비스 상태 확인