문제 해결
이 문서는 NetFUNNEL Akamai Agent 사용 중 발생할 수 있는 일반적인 문제와 해결 방법을 제공합니다.
설치 및 초기화
EdgeWorker 배포 실패
증상: EdgeWorker 버전 생성 또는 배포가 실패합니다.
해결 방법:
bundle.json파일의 형식이 올바른지 확인- EdgeWorker 코드에 문법 오류가 없는지 확인
- Akamai 계정의 EdgeWorker 권한 확인
Property Variables 설정이 적용되지 않음
증상: Property Variables를 설정했지만 에이전트가 동작하지 않습니다.
해결 방법:
- Property Variables의 이름이 정확한지 확인 (
NF_CLIENT_ID등) - Property를 활성화했는지 확인
- Property 활성화 후 충분한 시간(몇 분) 대기
동작 문제
대기열이 적용되지 않음
증상: 트리거 규칙을 설정했지만 대기열이 적용되지 않습니다.
해결 방법:
- NetFUNNEL 콘솔에서 세그먼트 트리거 규칙이 올바르게 설정되었는지 확인
- URL이 트리거 규칙과 일치하는지 확인
- EdgeWorker Rule이 올바르게 설정되었는지 확인
- Property가 활성화되었는지 확인
대기실로 리다이렉트되지 않음
증상: 대기 응답을 받았지만 대기실로 리다이렉트되지 않습니다.
해결 방법:
- EdgeWorker Rule이 HTML 파일에 적용되도록 설정되었는지 확인
- File Extension 설정에서 HTML 파일이 제외되지 않았는지 확인
- Property Variables
NF_VWR_PAGE_DOMAIN설정 확인
네트워크 문제
Origin Server 연결 실패
증상: Core Origin 또는 Setting Origin에 연결할 수 없습니다.
해결 방법:
- Origin Rule의 Hostname 설정이 올바른지 확인
{CLIENT_ID}.netfunnel.stclab.com형식이 정확한지 확인- 네트워크 연결 상태 확인
설정 문제
Property Variables 값이 적용되지 않음
증상: Property Variables를 설정했지만 값이 반영되지 않습니다.
해결 방법:
- Property Variables 이름의 대소문자 확인
- Property 활성화 여부 확인
- Property 활성화 후 캐시 클리어 또는 시간 대기