Amazon Relational Database Service
사용 설명서 (API 버전 2014-10-31)

Amazon RDS 데이터베이스 로그 파일

Amazon RDS 콘솔, AWS Command Line Interface(AWS CLI) 또는 Amazon RDS API를 사용하여 데이터베이스 로그를 보고 다운로드하고 조사할 수 있습니다. 트랜잭션 로그 보기, 다운로드 또는 조사는 지원되지 않습니다.

엔진별 정보는 다음을 참조하십시오.

데이터베이스 로그 파일 보기 및 나열

Amazon RDS 콘솔을 사용하여 DB 엔진에 대한 데이터베이스 로그 파일을 볼 수 있습니다. AWS CLI 또는 Amazon RDS API를 사용하여 다운로드하거나 모니터링할 수 있는 로그 파일을 나열할 수 있습니다.

참고

기존 Oracle DB 인스턴스에 대한 로그 파일 목록을 볼 수 없는 경우 목록을 보려면 인스턴스를 재부팅합니다.

AWS Management 콘솔

데이터베이스 로그 파일을 보려면

  1. https://console.aws.amazon.com/rds/에서 Amazon RDS 콘솔을 엽니다.

  2. 탐색 창에서 데이터베이스를 선택합니다.

  3. 보고자 하는 로그 파일을 보유한 DB 인스턴스의 이름을 선택합니다.

  4. 로그 및 이벤트 탭을 선택합니다.

  5. 아래로 스크롤하여 [Logs] 섹션을 찾습니다.

  6. 로그 섹션에서 표시할 로그를 선택한 다음 보기를 선택합니다.

AWS CLI

DB 인스턴스에 사용 가능한 데이터베이스 로그 파일을 나열하려면 AWS CLI describe-db-log-files 명령을 사용합니다.

다음 예에서는 my-db-instance라는 DB 인스턴스에 대한 로그 파일 목록을 반환합니다.

aws rds describe-db-log-files --db-instance-identifier my-db-instance
API

DB 인스턴스에 사용 가능한 데이터베이스 로그 파일을 나열하려면 Amazon RDS API DescribeDBLogFiles 작업을 사용합니다.

데이터베이스 로그 파일 다운로드

Amazon RDS 콘솔, AWS CLI 또는 API를 사용하여 데이터베이스 로그 파일을 다운로드할 수 있습니다.

AWS Management 콘솔

데이터베이스 로그 파일을 다운로드하려면

  1. https://console.aws.amazon.com/rds/에서 Amazon RDS 콘솔을 엽니다.

  2. 탐색 창에서 데이터베이스를 선택합니다.

  3. 보고자 하는 로그 파일을 보유한 DB 인스턴스의 이름을 선택합니다.

  4. 로그 및 이벤트 탭을 선택합니다.

  5. 아래로 스크롤하여 [Logs] 섹션을 찾습니다.

  6. 로그 섹션에서 다운로드할 로그 옆에 있는 버튼을 선택한 다음 다운로드를 선택합니다.

  7. 제공된 링크에 대한 컨텍스트(마우스 오른쪽 클릭) 메뉴를 열고 나서 [Save Link As]를 선택합니다. 로그 파일을 저장할 위치를 입력한 다음 저장을 선택합니다.

    
								로그 파일 보기
AWS CLI

데이터베이스 로그 파일을 다운로드하려면 AWS CLI 명령 download-db-log-file-portion을 사용합니다. 기본적으로 이 명령은 로그 파일의 최신 부분만을 다운로드합니다. 하지만 --starting-token 0 파라미터를 지정하여 전체 파일을 다운로드할 수 있습니다.

다음 예제에서는 log/ERROR.4라는 로그 파일의 내용을 다운로드하여 errorlog.txt라는 로컬 파일에 저장하는 방법을 보여줍니다.

Linux, OS X, Unix의 경우:

aws rds download-db-log-file-portion \ --db-instance-identifier myexampledb \ --starting-token 0 --output text \ --log-file-name log/ERROR.4 > errorlog.txt

Windows의 경우:

aws rds download-db-log-file-portion ^ --db-instance-identifier myexampledb ^ --starting-token 0 --output text ^ --log-file-name log/ERROR.4 > errorlog.txt
RDS API

데이터베이스 로그 파일을 다운로드하려면 Amazon RDS API DownloadDBLogFilePortion 작업을 사용합니다.

데이터베이스 로그 파일 조사

Amazon RDS 콘솔을 사용하여 로그 파일의 내용을 모니터링할 수 있습니다.

AWS Management 콘솔

데이터베이스 로그 파일을 조사하려면

  1. https://console.aws.amazon.com/rds/에서 Amazon RDS 콘솔을 엽니다.

  2. 탐색 창에서 데이터베이스를 선택합니다.

  3. 보고자 하는 로그 파일을 보유한 DB 인스턴스의 이름을 선택합니다.

  4. 로그 및 이벤트 탭을 선택합니다.

  5. 로그 섹션에서 로그 파일을 선택한 다음 보기를 선택합니다.

Amazon CloudWatch Logs에 데이터베이스 로그 게시

DB 인스턴스 로그를 보고 다운로드하는 것 외에도 Amazon CloudWatch Logs에 로그를 게시할 수 있습니다. CloudWatch Logs에서는 로그 데이터에 대한 실시간 분석을 수행하고, 매우 내구력 있는 스토리지에 데이터를 저장하며, CloudWatch Logs 에이전트를 사용하여 데이터를 관리할 수 있습니다. 보존 기간을 지정하지 않는 한 AWS는 CloudWatch Logs에 게시된 로그 데이터를 무기한 보존합니다. 자세한 내용은 CloudWatch Logs에서 로그 데이터 보존 기간 변경을 참조하십시오.

엔진별 정보는 다음을 참조하십시오.

REST를 사용하여 로그 파일 내용 읽기

Amazon RDS는 DB 인스턴스 로그 파일 액세스를 허용하는 REST 엔드포인트를 제공합니다. Amazon RDS 로그 파일 내용을 스트리밍하는 애플리케이션을 작성해야 하는 경우 유용합니다.

구문은 다음과 같습니다.

GET /v13/downloadCompleteLogFile/DBInstanceIdentifier/LogFileName HTTP/1.1 Content-type: application/json host: rds.region.amazonaws.com

다음 파라미터는 필수 파라미터입니다.

  • DBInstanceIdentifier — 다운로드하려는 로그 파일이 있는 DB 인스턴스에 고객이 할당하는 이름입니다.

  • LogFileName — 다운로드할 로그 파일의 이름입니다.

응답에는 스트림으로 요청된 로그 파일의 내용이 포함됩니다.

다음 예제에서는 us-west-2 리전에 sample-sql로 명명된 DB 인스턴스에 대해 log/ERROR.6으로 명명된 로그 파일을 다운로드합니다.

GET /v13/downloadCompleteLogFile/sample-sql/log/ERROR.6 HTTP/1.1 host: rds.us-west-2.amazonaws.com X-Amz-Security-Token: AQoDYXdzEIH//////////wEa0AIXLhngC5zp9CyB1R6abwKrXHVR5efnAVN3XvR7IwqKYalFSn6UyJuEFTft9nObglx4QJ+GXV9cpACkETq= X-Amz-Date: 20140903T233749Z X-Amz-Algorithm: AWS4-HMAC-SHA256 X-Amz-Credential: AKIADQKE4SARGYLE/20140903/us-west-2/rds/aws4_request X-Amz-SignedHeaders: host X-Amz-Content-SHA256: e3b0c44298fc1c229afbf4c8996fb92427ae41e4649b934de495991b7852b855 X-Amz-Expires: 86400 X-Amz-Signature: 353a4f14b3f250142d9afc34f9f9948154d46ce7d4ec091d0cdabbcf8b40c558

존재하지 않는 DB 인스턴스를 지정하는 경우 응답에 다음 오류가 포함됩니다.

  • DBInstanceNotFoundDBInstanceIdentifier는 기존 DB 인스턴스를 참조하지 않습니다. (HTTP 상태 코드: 404)