SAM 함수의 X-Ray 능동 추적 미설정

능동 추적이 필요한 함수에 Active 모드를 지정하세요.

설명

SAM 함수의 Tracing: Active는 Lambda가 요청을 샘플링해 X-Ray 추적을 시작하도록 합니다. 필요한 추적 데이터가 없으면 실행 지연이나 서비스 간 문제를 분석하기 어려워질 수 있습니다.

잠재적 영향

다른 추적 수단도 없다면 호출 흐름과 실패 지점을 찾는 데 더 오래 걸릴 수 있습니다.

해결 방법

능동 추적이 필요하면 Tracing: Active를 설정하세요. 직접 지정한 실행 역할에는 X-Ray 쓰기 권한을 부여하고, 하위 호출을 추적할 코드는 계측하세요.

예시

예시는 이미지 기반 함수의 능동 추적을 켭니다. 이미지와 실행 설정은 실제 환경에 맞게 지정하세요.

변경 전

yaml
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Resources:
  Function:
    Type: AWS::Serverless::Function
    Properties:
      PackageType: Image
      ImageUri: account-id.dkr.ecr.region.amazonaws.com/ecr-repo-name:image-name
      ImageConfig:
        Command:
          - app.lambda_handler
        EntryPoint:
          - entrypoint1
        WorkingDirectory: workDir
      Tags:
        Type: AWS Serverless Function

변경 후

yaml
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Resources:
  Function:
    Type: AWS::Serverless::Function
    Properties:
      PackageType: Image
      ImageUri: account-id.dkr.ecr.region.amazonaws.com/ecr-repo-name:image-name
      ImageConfig:
        Command:
          - app.lambda_handler
        EntryPoint:
          - entrypoint1
        WorkingDirectory: workDir
      Tags:
        Type: AWS Serverless Function
      Tracing: Active

참조