The AWS SDK for Java 1.x는 2024년 7월 31일부터 유지 관리 모드로 전환되었으며 2025년 12월 31end-of-support일에 도달할 예정입니다. 새로운 기능, 가용성 개선 사항 및 보안 업데이트를 AWS SDK for Java 2.x 계속 받으려면 로 마이그레이션하는 것이 좋습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS SDK for Java 통화 로깅

AWS SDK for Java 는 런타임에 여러 로깅 시스템 중 하나를 사용할 수 있는 추상화 계층인 Apache Commons Logging으로 계측됩니다.

지원되는 로깅 시스템에는 Java Logging Framework와 Apache Log4j 등이 있습니다. 이 주제에서는 Log4j 사용법을 보여줍니다. 애플리케이션 코드를 변경하지 않고도 SDK의 로깅 기능을 사용할 수 있습니다.

Log4j에 대해 자세히 알아보려면 Apache 웹 사이트를 참조하십시오.

Log4J 다운로드 JAR

에서 Log4j를 사용하려면 Apache 웹 JAR 사이트에서 Log4j를 다운로드SDK해야 합니다. 에는가 포함되지 SDK 않습니다JAR. JAR 파일을 클래스 경로에 있는 위치에 복사합니다.

Log4j는 구성 파일인 log4j.properties를 사용합니다. 아래에는 예제 구성 파일이 나와 있습니다. 이 구성 파일을 classpath의 디렉터리 중 하나로 복사합니다. Log4jJAR와 log4j.properties 파일은 동일한 디렉터리에 있을 필요가 없습니다.

log4j.properties 구성 파일은 로깅 수준, 로깅 출력이 전송될 대상(예를 들면, 파일 또는 콘솔), 출력 형식 같은 속성을 지정합니다. 로깅 수준은 로거가 생성되는 출력의 세부 수준입니다. Log4j는 여러 로깅 계층의 개념을 지원합니다. 로깅 수준은 각 계층마다 독립적으로 설정됩니다. AWS SDK for Java에서는 다음과 같은 두 가지 로깅 계층을 사용할 수 있습니다.

Classpath 설정

Log4jJAR와 log4j.properties 파일은 모두 클래스 경로에 있어야 합니다. Apache Ant를 사용 중인 경우 Ant 파일의 path 요소에서 classpath를 설정합니다. 다음 예제는에 포함된 예제의 Ant 파일의 Amazon S3 경로 요소를 보여줍니다SDK.

<path id="aws.java.sdk.classpath">
  <fileset dir="../../third-party" includes="**/*.jar"/>
  <fileset dir="../../lib" includes="**/*.jar"/>
  <pathelement location="."/>
</path>

Eclipse를 사용하는 경우 메뉴를 열고 프로젝트 | 속성 | Java 빌드 경로로 이동하여 클래스 경로를 설정할 IDE수 있습니다.

서비스 관련 오류 및 경고

클라이언트 라이브러리에서 중요한 메시지를 가져오려면 항상 “com.amazonaws” 로거 계층 구조를 “WARN”로 설정하는 것이 좋습니다. 예를 들어 Amazon S3 , 클라이언트가 애플리케이션이를 제대로 닫지 않았고 리소스가 유출될 InputStream 수 있음을 감지하면 S3 클라이언트는 경고 메시지를 통해 이를 로그에 보고합니다. 또한 클라이언트에 요청 또는 응답 처리 문제가 발생하는 경우에도 메시지가 기록됩니다.

다음 log4j.properties 파일은를 rootLogger로 설정하여 WARN'com.amazonaws' 계층 구조에 있는 모든 로거의 경고 및 오류 메시지가 포함됩니다. 또는 com.amazonaws 로거를 로 명시적으로 설정할 수 있습니다WARN.

log4j.rootLogger=WARN, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d [%t] %-5p %c -  %m%n
# Or you can explicitly enable WARN and ERROR messages for the {AWS} Java clients
log4j.logger.com.amazonaws=WARN

요청/응답 요약 로깅

에 대한 모든 요청은가 AWS 요청을 AWS 서비스 처리하는 방식에 문제가 발생할 경우 유용한 고유한 요청 ID를 AWS 서비스 생성합니다. AWS 요청은 실패한 서비스 호출에 SDK 대해의 예외 객체를 통해 프로그래밍 방식으로 IDs 액세스할 수 있으며 'com.amazonaws.request' 로거의 DEBUG 로그 수준을 통해 보고할 수도 있습니다.

다음 log4j.properties 파일을 사용하면 요청를 포함한 AWS 요청 및 응답의 요약을 사용할 수 있습니다IDs.

log4j.rootLogger=WARN, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d [%t] %-5p %c -  %m%n
# Turn on DEBUG logging in com.amazonaws.request to log
# a summary of requests/responses with {AWS} request IDs
log4j.logger.com.amazonaws.request=DEBUG

다음은 로그 출력의 예입니다.

2009-12-17 09:53:04,269 [main] DEBUG com.amazonaws.request - Sending
Request: POST https://rds.amazonaws.com / Parameters: (MaxRecords: 20,
Action: DescribeEngineDefaultParameters, SignatureMethod: HmacSHA256,
AWSAccessKeyId: ACCESSKEYID, Version: 2009-10-16, SignatureVersion: 2,
Engine: mysql5.1, Timestamp: 2009-12-17T17:53:04.267Z, Signature:
q963XH63Lcovl5Rr71APlzlye99rmWwT9DfuQaNznkD, ) 2009-12-17 09:53:04,464
[main] DEBUG com.amazonaws.request - Received successful response: 200, {AWS}
Request ID: 694d1242-cee0-c85e-f31f-5dab1ea18bc6 2009-12-17 09:53:04,469
[main] DEBUG com.amazonaws.request - Sending Request: POST
https://rds.amazonaws.com / Parameters: (ResetAllParameters: true, Action:
ResetDBParameterGroup, SignatureMethod: HmacSHA256, DBParameterGroupName:
java-integ-test-param-group-0000000000000, AWSAccessKeyId: ACCESSKEYID,
Version: 2009-10-16, SignatureVersion: 2, Timestamp:
2009-12-17T17:53:04.467Z, Signature:
9WcgfPwTobvLVcpyhbrdN7P7l3uH0oviYQ4yZ+TQjsQ=, )

2009-12-17 09:53:04,646 [main] DEBUG com.amazonaws.request - Received
successful response: 200, {AWS} Request ID:
694d1242-cee0-c85e-f31f-5dab1ea18bc6

상세 표시 유선 로깅

경우에 따라가 AWS SDK for Java 보내고 받는 정확한 요청과 응답을 보는 것이 유용할 수 있습니다. 대규모 요청(예: 업로드되는 파일 Amazon S3) 또는 응답을 작성하면 애플리케이션이 크게 느려질 수 있으므로 프로덕션 시스템에서이 로깅을 활성화해서는 안 됩니다. 이 정보에 액세스해야 하는 경우 Apache HttpClient 4 로거를 통해 일시적으로 활성화할 수 있습니다. org.apache.http.wire 로거에서 DEBUG 레벨을 활성화하면 모든 요청 및 응답 데이터에 대한 로깅이 활성화됩니다.

다음 log4j.properties 파일은 Apache HttpClient 4에서 전체 와이어 로깅을 활성화하며 애플리케이션에 상당한 성능 영향을 미칠 수 있으므로 일시적으로만 활성화해야 합니다.

log4j.rootLogger=WARN, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d [%t] %-5p %c -  %m%n
# Log all HTTP content (headers, parameters, content, etc)  for
# all requests and responses. Use caution with this since it can
# be very expensive to log such verbose data!
log4j.logger.org.apache.http.wire=DEBUG

지연 시간 지표 로깅

문제를 해결하고 어떤 프로세스가 가장 많은 시간이 걸리는지 또는 서버 또는 클라이언트 측에서 더 긴 지연 시간을 가지는지와 같은 지표를 확인하려면 지연 시간 로거가 유용할 수 있습니다. com.amazonaws.latency 로거를 로 설정DEBUG하여이 로거를 활성화합니다.

log4j.rootLogger=WARN, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d [%t] %-5p %c -  %m%n
log4j.logger.com.amazonaws.latency=DEBUG

다음은 로그 출력의 예입니다.

com.amazonaws.latency - ServiceName=[{S3}], StatusCode=[200],
ServiceEndpoint=[https://list-objects-integ-test-test.s3.amazonaws.com],
RequestType=[ListObjectsV2Request], AWSRequestID=[REQUESTID], HttpClientPoolPendingCount=0,
RetryCapacityConsumed=0, HttpClientPoolAvailableCount=0, RequestCount=1,
HttpClientPoolLeasedCount=0, ResponseProcessingTime=[52.154], ClientExecuteTime=[487.041],
HttpClientSendRequestTime=[192.931], HttpRequestTime=[431.652], RequestSigningTime=[0.357],
CredentialsRequestTime=[0.011, 0.001], HttpClientReceiveResponseTime=[146.272]