AWS SDK for Java 1.x는 2024년 7월 31일부터 유지 관리 모드로 전환되었으며 2025년 12월 end-of-support
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
통화 기록 AWS SDK for Java
AWS SDK for Java 는 런타임 시 여러 로깅 시스템 중 하나를 사용할 수 있게 해주는 추상화 계층인 Apache Commons
지원되는 로깅 시스템에는 Java Logging Framework와 Apache Log4j 등이 있습니다. 이 주제에서는 Log4j 사용법을 보여줍니다. 애플리케이션 코드를 변경하지 않고도 SDK 의 로깅 기능을 사용할 수 있습니다.
Log4j
참고
이 항목에서는 Log4j 1.x에 초점을 맞춰 설명합니다. Log4j2는 Apache Commons Logging을 직접 지원하지 않지만, Apache Commons Logging 인터페이스를 사용하는 Log4j2에 로깅 호출을 자동으로 전달하는 어댑터를 제공합니다. 자세한 내용은 Log4j2 설명서의 Commons Logging Bridge
Log4J 다운로드 JAR
Log4j를 와 함께 사용하려면 아파치 SDK 웹 사이트에서 JAR Log4j를 다운로드해야 합니다. 는 포함되지 SDK 않습니다. JAR JAR파일을 클래스 경로에 있는 위치에 복사합니다.
Log4j는 구성 파일인 log4j.properties를 사용합니다. 아래에는 예제 구성 파일이 나와 있습니다. 이 구성 파일을 classpath의 디렉터리 중 하나로 복사합니다. JARLog4j와 log4j.properties 파일은 같은 디렉터리에 있지 않아도 됩니다.
log4j.properties 구성 파일은 로깅 수준
-
log4j.logger.com.amazonaws
-
log4j.logger.org.apache.http.wire
Classpath 설정
Log4j JAR 및 log4j.properties 파일은 모두 클래스 경로에 있어야 합니다. Apache Antpath
요소에서 classpath를 설정합니다. 다음 예제는 에 포함된 예제의 Ant 파일 경로 요소를 보여줍니다. Amazon S3
<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를 설정합니다. 그러면 “rootLogger
WARNcom.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
참고
이 로거는 SDK 메트릭이 활성화된 경우에만 사용할 수 있습니다. SDK메트릭 패키지에 대한 자세한 내용은 의 메트릭 활성화를 참조하십시오. AWS SDK for Java
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]