AWS SDK for Java 1.x는 2024년 7월 31일부터 유지 관리 모드로 전환되었으며 2025년 12월 end-of-support31일에 출시될 예정입니다. 새 기능, 가용성 개선 사항 및 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를 와 함께 사용하려면 아파치 SDK 웹 사이트에서 JAR Log4j를 다운로드해야 합니다. 는 포함되지 SDK 않습니다. JAR JAR파일을 클래스 경로에 있는 위치에 복사합니다.

Log4j는 구성 파일인 log4j.properties를 사용합니다. 아래에는 예제 구성 파일이 나와 있습니다. 이 구성 파일을 classpath의 디렉터리 중 하나로 복사합니다. JARLog4j와 log4j.properties 파일은 같은 디렉터리에 있지 않아도 됩니다.

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

Classpath 설정

Log4j JAR 및 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>

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

서비스 관련 오류 및 경고

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

다음 log4j.properties 파일은 to를 설정합니다. 그러면 “rootLoggerWARNcom.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 요청 ID를 AWS 서비스 생성하는데, 이는 요청을 처리하는 방식에 문제가 발생할 경우 유용합니다. AWS 서비스 AWS IDs요청은 실패한 서비스 호출에 SDK 대해 Exception 객체를 통해 프로그래밍 방식으로 액세스할 수 있으며, “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]