

# 문제 해결
<a name="CloudWatch-OTLPTroubleshooting"></a>

다음은 OTLP 엔드포인트에 대한 일반적인 문제 해결 시나리오 및 솔루션입니다.


| 문제 | 설명 | Solution | 
| --- | --- | --- | 
|  OCB 수집기를 시작할 때 AWS 자격 증명이 존재하지 않음  |  시작 시 수집기에서 다음과 같은 오류가 발생합니다. *Error: invalid configuration: extensions::sigv4auth: could not retrieve credential provider: failed to refresh cached credentials, no EC2 IMDS role found, operation error ec2imds: GetMetadata, request canceled, context deadline exceeded*.  |  올바른 자격 증명을 입력합니다.  | 
|  유효하지 않은 AWS 자격 증명  |  수집기에서 HTTP 상태 코드 403 발생, Message=The security token included in the request is invalid., Details=[]“ when sending requests though OTLP endpoint.  | 수집기 서버의 AWS 자격 증명을 새로 고침합니다. | 
|  트랜잭션 검색 비활성화됨  |  수집기에서 오류 발생 Message=The OTLP API is supported with CloudWatch Logs as a Trace Segment Destination.  | 트레이스에 OTLP 엔드포인트를 사용하기 전에 CloudWatch에서 트랜잭션 검색이 활성화되어 있는지 확인합니다. 자세한 내용은 [트랜잭션 검색](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html) 섹션을 참조하세요. | 
| 배치 및 제한 시간 문제 | 수집기에서 다음 문제 중 하나가 발생합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPTroubleshooting.html) | [batchprocessor](https://github.com/open-telemetry/opentelemetry-collector/tree/main/processor/batchprocessor)를 사용하여 배치 및 제한 시간 정책을 조정합니다. | 
| 재시도 문제 | 수집기와 OTLP 엔드포인트 간의 일시적인 네트워크 문제입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPTroubleshooting.html) | [내보내기 도구](https://github.com/open-telemetry/opentelemetry-collector/blob/main/exporter/exporterhelper/README.md)를 사용하여 재시도 정책을 조정합니다. | 
| 페이로드 거부됨 | NA | 트레이스 엔드포인트로 전송된 페이로드가 한도 및 제한 사항 내에 있는지 확인합니다. 자세한 내용은 [엔드포인트 제한 및 제약 조건](CloudWatch-OTLPEndpoint.md#CloudWatch-LimitsandRestrictions) 섹션을 참조하세요. | 
| ADOT에서 발신 내보내기 요청에 인증 헤더가 주입되지 않음 | 일반 403 오류, '인증 토큰 누락': 예제: `ERROR:opentelemetry.exporter.otlp.proto.http.trace_exporter:Failed to export batch code: 403, reason: Missing Authentication Token` |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPTroubleshooting.html)  | 
| CloudWatch 로그 그룹에 로그 또는 스팬이 나타나지 않음 | 예상되는 CloudWatch 로그 그룹(스팬의 경우 aws/spans, 로그의 경우 지정된 사용자 지정 로그 그룹)에 로그 또는 스팬이 표시되지 않습니다. | 계측할 라이브러리가 자동 계측을 통해 지원되는지 확인합니다. [Java](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md), [Python](http://github.com/open-telemetry/opentelemetry-python-contrib/blob/main/instrumentation/README.md), [JavaScript](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/packages/auto-instrumentations-node#supported-instrumentations) 및 [.NET](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/docs/internal/instrumentation-libraries.md)에 대해 지원되는 라이브러리를 참조하세요. | 