API Gateway에서 ‘엔드포인트와 통신하는 네트워크 오류’ 문제를 해결하려면 어떻게 합니까?

간략한 설명

API 요청 수가 수신한 오류 수보다 훨씬 많은 경우 일시적인 네트워크 문제가 발생할 수 있습니다. 이 문제를 해결하려면 저주파 네트워크 오류 해결 섹션의 단계를 따르십시오.

오류가 자주 발생하거나 지속적으로 발생하는 경우 고주파 네트워크 오류 해결 섹션의 단계를 완료합니다.

해결 방법

저주파 네트워크 오류 해결

• 실패한 요청에 대해 지수 백오프와 함께 재시도를 사용합니다.
• 액세스 로깅을 활성화하려면 Amazon CloudWatch API 로깅 설정을 참조하십시오. 그리고 CloudWatch 콘솔에서 API Gateway 로그 이벤트 보기를 참조하십시오. 디버깅의 경우 컨텍스트 변수 $context.integration.error, $context.integration.latency 및 $context.integrationStatus를 분석합니다.

고주파 네트워크 오류 해결

Amazon CloudWatch 로깅 설정 전체 요청/응답 데이터 로깅 옵션을 선택해야 합니다. 이 옵션을 사용하면 오류 문제를 해결할 수 있도록 전체 API 요청 및 응답을 기록할 수 있습니다.

다음 해결 방법을 고려하십시오.

• 로드 밸런서에 여러 대상 그룹이 있는 경우 교차 영역 로드 밸런싱을 사용하여 지연 시간을 줄입니다. 활성화된 모든 가용 영역에 수신 트래픽을 균등하게 분배하고 요청이 대상 없는 가용 영역으로 라우팅되지 않도록 하여 지연 시간을 줄일 수 있습니다.
• Network Load Balancer 및 Application Load Balancer를 사용하는 활성화된 모든 가용 영역에 등록된 정상 인스턴스가 있는지 확인합니다.
  참고: 로드 밸런서는 활성화된 각 가용 영역에 등록된 대상이 하나 이상 있을 때 가장 효과적입니다. 가용 영역에는 대상 그룹당 정상 인스턴스가 하나 이상 있어야 합니다. 이 정상 인스턴스는 Network Load Balancer 또는 Application Load Balancer에서 정상 상태에 도달해야 합니다.
• API Gateway의 통합 시간 초과 할당량을 초과하지 않도록 하려면 대상 그룹 인스턴스가 29초 이내에 API에 대한 응답을 제공하는지 확인합니다.
• TLS 리스너가 있는 경우에만 액세스 로깅을 활성화하는 지점은 Network Load Balancer 및 Application Load Balancer입니다.
• Network Load Balancer를 사용하는 경우 Amazon Elastic Compute Cloud(Amazon EC2) 보안 그룹에서 인스턴스에 연결할 수 있는 IP 주소를 확인합니다. IP는 모든 소스 또는 Network Load Balancer의 프라이빗 IP 주소의 트래픽을 허용해야 합니다.
• Application Load Balancer를 사용하는 경우 Application Load Balancer의 보안 그룹이 모든 소스의 트래픽을 허용하는지 확인합니다.
  참고: 대상 인스턴스는 Application Load Balancer에 대한 액세스만 제한할 수 있습니다. 보다 엄격한 보안을 위해 API가 위치한 AWS 리전용으로 예약된 API Gateway IP 주소의 액세스를 제한할 수 있습니다. IP 범위 목록이 변경될 때마다 알림을 받으려면 AWS IP 주소 범위 알림을 구독하세요.
• Amazon Virtual Private Cloud(VPC) 흐름 로그을 활성화합니다. 그런 다음 Network Load Balancer 및 Application Load Balancer의 네트워크 인터페이스에서 송수신되는 트래픽 정보를 캡처합니다.
• Network Load Balancer가 Amazon VPC 링크에 연결되어 있는 경우 TCP_Target_Reset_Count 지표를 확인하십시오. 이 지표의 스파이크는 대상 인스턴스가 Network Load Balancer에 대한 연결을 닫지 않을 수 있음을 나타냅니다.

---

관련 정보

API Gateway 프라이빗 API 엔드포인트에 대한 연결 문제를 해결하려면 어떻게 해야 합니까?