Lambda 함수 실패 문제를 해결하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2019년 10월 16일

AWS Lambda 함수를 실행하면 오류가 발생하여 실패합니다. 이 실패 문제를 해결하려면 어떻게 해야 합니까?

간략한 설명

Lambda 함수 실패는 일반적으로 다음과 같은 원인으로 발생합니다.

  • 권한 문제
  • 코드 문제
  • 네트워크 문제
  • 조절
  • API 500 및 502 호출 오류

Lambda 코드 및 구성에 따라 이러한 AWS 서비스 및 기능을 사용하여 원인을 파악할 수 있습니다.

다음과 같은 일반적인 문제 유형을 검토하여 사용할 서비스 또는 기능과 자세한 정보 및 문제 해결 지침을 찾을 수 있는 위치를 결정합니다.

해결 방법

권한 문제

CloudTrail은 AWS 계정의 API 호출을 이벤트로 캡처합니다. Lambda 함수가 호출에 실패하면 Lambda에 대한 CloudTrail 로그 항목을 검토합니다.

Lambda를 호출하는 요청자는 함수를 호출하는 데 필요한 AWS Identity and Access Management(IAM) 권한이 있어야 합니다. 요청자에게 액세스 권한이 없는 경우 Lambda 함수 권한을 업데이트하여 액세스 권한을 부여합니다. 자세한 내용은 AWS Lambda Identity and Access 문제 해결을 참조하십시오.

코드 문제

CloudWatch Logs

Lambda 함수의 실패에 대한 자세한 내용은 CloudWatch의 Lambda 로그를 참조하십시오. 자세한 내용은 사용 중인 프로그래밍 언어에 대한 로깅 지침을 참조하십시오.

X-Ray

Lambda 함수가 다운스트림 AWS 리소스, 마이크로서비스, 데이터베이스 또는 HTTP 웹 API를 사용하는 경우 X-Ray를 사용하여 문제를 해결할 수 있습니다.

종속성

Lambda 함수의 배포 패키지에 종속성이 포함되어 있는 경우 코드에서 종속성을 성공적으로 가져올 수 있는지 확인하십시오. 자세한 내용은 사용 중인 프로그래밍 언어에 대한 다음 지침을 참조하십시오.

또는 Lambda 계층을 사용하여 배포 패키지 외부에 종속성을 추가할 수 있습니다.

네트워크 문제

Lambda 함수가 Amazon Virtual Private Cloud(Amazon VPC)에 연결된 경우 모든 것이 올바르게 구성되었는지 확인합니다. 자세한 내용은 VPC의 리소스에 액세스하도록 Lambda 함수 구성을 참조하십시오.

Amazon VPC 지원 Lambda 함수가 인터넷을 호출해야 하는 경우 인터넷 액세스 권한을 부여해야 합니다.

조절

Lambda 함수 호출 요청이 동시성 한도를 확장하거나 초과할 수 있는 것보다 더 빨리 도착하면 요청이 실패하고 429 조절 오류가 발생합니다. 자세한 내용은 AWS Lambda 함수 조정을 참조하십시오.

원인을 해결하는 데 도움이 되도록 CloudWatch를 사용하여 Lambda 지표 ConcurrentExecutions, UnreservedConcurrentExecutionsThrottles를 모니터링합니다. 자세한 내용은 AWS Lambda CloudWatch 지표를 참조하십시오.

호출 API 502 및 500 오류

Lambda 함수가 502 또는 500 서버 오류와 함께 실패하는 경우 다음 문제 해결 지침을 검토하십시오.

발생 가능한 오류 목록(설명 포함)은 Lambda 호출 API 참조에서 오류를 확인하십시오.


이 문서가 도움이 되었습니까?

AWS에서 개선해야 할 부분이 있습니까?


도움이 필요하십니까?