Serverless 함수 X-Ray 추적 설정 점검

설명

AWS X-Ray는 Lambda 호출의 지연과 오류를 분석하는 데 도움이 됩니다. Active는 활성 추적을 사용하며, PassThrough와는 샘플링 동작이 다릅니다. 함수 설정을 생략하면 provider의 추적 설정을 상속할 수 있습니다.

잠재적 영향

필요한 추적 데이터가 없으면 서비스 간 지연이나 오류의 위치를 찾는 데 더 오래 걸릴 수 있습니다.

해결 방법

활성 추적이 필요하면 함수의 tracing: Active 또는 공통 provider 추적 설정을 사용하세요. 사용자 지정 실행 역할에는 필요한 X-Ray 권한을 부여하고 실제 추적 수집을 확인하세요.

예시

함수의 PassThrough를 Active로 변경합니다. Framework 4와 Node.js 22에 맞는 핸들러, SNS 토픽 ARN인 failureTopicArn, X-Ray 권한이 있는 실행 역할 ARN인 lambdaRoleArn을 별도로 제공하세요.

변경 전

yaml

service: service
frameworkVersion: '4'
provider:
  name: aws
  runtime: nodejs22.x

functions:
  hello:
    handler: handler.hello
    onError: ${param:failureTopicArn}
    tags:
      foo: bar
    role: ${param:lambdaRoleArn}
    tracing: PassThrough

변경 후