X-Ray에서 추적 할당량 오류를 해결하려면 어떻게 해야 하나요?

간략한 설명

다음은 추적 문서가 AWS X-Ray의 허용 한도를 초과할 수 있는 시나리오입니다.

• 추적을 위해 추적 문서 크기가 500KB를 초과하는 일괄 처리된 세그먼트를 다량 전송함.
• 추적을 위해 추적 문서 크기가 100KB 크기를 초과하는 일괄 처리되지 않은 세그먼트를 전송함.
• 사용자 지정 세그먼트, 메타데이터, 주석을 추가해 추적 문서 크기가 늘어남.

X-Ray 추적 문서 크기의 상한은 함께 전송한 세그먼트 수에 따라 동적으로 달라집니다. 이는 제한 초과 추적 기능 때문입니다. 추적에 첨부하는 세그먼트를 일괄적으로 다량 전송하는 경우, 500KB이 상한입니다. 추적에 첨부하는 세그먼트를 개별적으로 시간 차를 두고 전송하는 경우 100KB이 상한입니다.

추적을 빨리 전송할수록(일괄적으로 전송하는 세그먼트가 많을수록) 압축 효율이 더 높아집니다. 추적을 천천히 전송할수록(시간 차를 두고 세그먼트를 개별적으로 전송할수록) 추적한 수정본이 여러 버전으로 더 많이 생깁니다. 또 추적을 천천히 전송할수록 백엔드의 캐시 스토리지 용량이 더 많이 소비됩니다. 추적을 오랫동안 지속하면 중복 데이터가 더 많이 생성되므로 X-Ray가 수집하는 데이터가 줄어듭니다.

해결 방법

**참고:**AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류가 발생하면 최신 AWS CLI 버전을 사용하고 있는지 확인하세요.

추적은 X-Ray 콘솔에서 보거나, 다음 명령을 실행해 추적 문서가 크기 제한을 초과하는지 확인할 수 있습니다.

aws xray batch-get-traces --trace-ids <EXAMPLE_TRACE_ID>

참고: EXAMPLE_TRACE_ID를 추적 ID로 바꿉니다.

X-Ray는 다음 정보를 수집해 더 많은 추적을 실행합니다.

{
    "Id": "<EXAMPLE_TRACE_ID>",
    "Duration": 187.859,
    "LimitExceeded": true,
    "Segments": [
         ...
     ]
     ....
 }

**참고:**LimitExceeded 매개변수가 참이면 추적이나 세그먼트 할당량을 초과한 것입니다.

추적 문서 크기가 500KB를 초과하는 일괄 처리된 다량의 세그먼트 추적

이는 Step 함수를 X-Ray와 통합할 때 생기는 시나리오입니다. Step 함수를 X-Ray와 통합하면 X-Ray가 추적 및 추적 제외 대상을 사용자 지정할 수 없습니다. AWS Lambda 함수를 통해 추적 ID를 전달하면 세그먼트 데이터가 추적 ID에 추가됩니다.

Step 함수를 사용하는 경우 다음 단계를 완료하세요.

1. Step 함수로 이동해 적극 추적 기능을 끕니다.
2. 중요한 워크플로에만 Lambda 함수에 추적 ID를 전달하고, 추적 상한을 초과하지 않도록 합니다.
3. Lambda가 업스트림 서비스로부터 추적 헤더를 수신하는 경우 Lambda 실행 역할에서PutTraceSegments 권한을 제거하세요. 상한은 동적으로 조정됩니다.

Step 함수를 사용하지 않는 경우 다음 단계를 완료하세요.

1. 코드를 디버깅하여 여러 요청에 동일한 추적 ID를 전달하는지 확인하세요.
2. 추적 기능을 멈추세요. 추적 기능을 끄려면 호출 추적 ID를 다운스트림 서비스에 전달하지 않으면 됩니다.
3. 멈춘 지점에서 새 추적 ID를 생성합니다.

참고: 모든 애플리케이션에 추적 ID를 생성하면 추적 수가 늘어납니다. 추적을 용이하게 하려면 중요한 애플리케이션 워크플로는 추적 하나에 포함하는 것이 좋습니다.

자세한 내용은 AWS X-Ray 및 Step 함수를 참조하세요.

추적 문서 크기가 100KB 크기를 초과하는 일괄 처리되지 않은 세그먼트 추적

이 시나리오에서는 이전 섹션에 안내된 해결 방법을 사용하세요.

새로운 상한선인 100KB에서 추적을 중단하세요. 또는 애플리케이션에서 세그먼트를 다량으로 일괄 처리해 상한선을 500KB로 늘릴 수 있습니다. 세그먼트 일괄처리는 개방형 텔레메트리 SDK에서만 지원됩니다. X-Ray SDK를 사용하는 경우 애플리케이션이 세그먼트를 보내는 방식을 변경하세요.

사용자 지정 세그먼트, 메타데이터, 주석을 추가해 추적 문서 크기가 늘어난 경우

추적 문서 크기를 줄이려면 동일한 추적 ID에 추가 사용자 지정 세그먼트를 추가하지 마세요. 필요한 워크플로에만 사용자 지정 세그먼트를 추가하세요. 추적 문서 크기를 줄일 수 있는 또 다른 방법은 추적에 메타데이터와 주석을 줄이는 것입니다.