Amazon RDS データベースログファイルの操作

AWS Management Console、AWS Command Line Interface (AWS CLI)、または Amazon RDS API を使用して、データベースログを表示、ダウンロード、監視できます。トランザクションログの表示、ダウンロード、監視はサポートされていません。

トピック

• データベースログファイルの表示とリスト化
• データベースログファイルのダウンロード
• データベースログファイルの監視
• Amazon CloudWatch Logs へのデータベースログの発行
• REST を用いたログファイルの内容の読み取り
• MariaDB データベースのログファイル
• Microsoft SQL Server データベースのログファイル
• MySQL データベースログファイルへのアクセス
• Oracle Database のログファイル
• PostgreSQL データベースのログファイル

データベースログファイルの表示とリスト化

AWS Management Console を使用して、DB エンジンのデータベースログファイルを閲覧できます。AWS CLI または Amazon RDS API を使用して、ダウンロードまたはモニタリングできるログファイルを一覧表示できます。

注記

既存の Oracle DB インスタンスのログファイルを一覧表示できない場合は、インスタンスを再起動してリストを表示します。

Console

データベースログファイルを閲覧するには

1. Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

2. ナビゲーションペインで、[データベース] を選択します。

3. 表示するログファイルのある DB インスタンスの名前を選択します。

4. [ログとイベント] タブを選択します。

5. [ログ] セクションまで下にスクロールします。

6. [ログ] セクションで、表示するログを選択してから、[表示] を選択します。

AWS CLI

DB インスタンスで使用できるデータベースログファイルを一覧表示するには、AWS CLI の describe-db-log-files コマンドを使用します。

次の例では、DB インスタンス (my-db-instance) のログファイルのリストが返ります。

例

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

RDS API

DB インスタンスの使用可能なデータベースログファイルを一覧表示するには、Amazon RDS API の DescribeDBLogFiles アクションを使用します。

データベースログファイルのダウンロード

データベースログファイルをダウンロードするには、AWS Management Console、AWS CLI、または API を使用します。

Console

データベースログファイルをダウンロードするには

1. Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

2. ナビゲーションペインで、[データベース] を選択します。

3. 表示するログファイルのある DB インスタンスの名前を選択します。

4. [ログとイベント] タブを選択します。

5. [ログ] セクションまで下にスクロールします。

6. [ログ] セクションで、ダウンロードするログの横にあるボタンを選択し、[ダウンロード] を選択します。

7. 表示されたリンクのコンテキスト (右クリック) メニューを開き、[名前を付けて保存] を選択します。ログファイルを保存する場所を入力し、[保存] を選択します。

   

AWS CLI

データベースログファイルをダウンロードするには、AWS CLI の download-db-log-file-portion コマンドを使用します。デフォルトでは、このコマンドによってログファイルの最新部分のみがダウンロードされます。ただし、--starting-token 0 パラメータを指定して、ファイル全体をダウンロードすることもできます。

以下の例では、ログファイル (log/ERROR.4) のすべての内容をダウンロードし、ローカルファイル (errorlog.txt) に格納する方法について説明します。

例

Linux、macOS、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 アクションを使用します。

データベースログファイルの監視

AWS Management Console を使用して、ログファイルの内容をモニタリングできます。

Console

データベースログファイルを監視するには

1. Amazon RDS コンソール (https://console.aws.amazon.com/rds/) を開きます。

2. ナビゲーションペインで、[データベース] を選択します。

3. 表示するログファイルのある DB インスタンスの名前を選択します。

4. [ログとイベント] タブを選択します。

5. [ログ] セクションでログファイルを選択し、[監視] を選択します。

Amazon CloudWatch Logs へのデータベースログの発行

DB インスタンスログの表示およびダウンロードに加え、ログを Amazon CloudWatch Logs に発行することもできます。CloudWatch Logs では、ログデータのリアルタイム分析、高い耐久性を持つストレージへのデータの保存、CloudWatch Logs エージェントを使用したデータの管理を実行できます。AWS は、CloudWatch Logs に公開されたログデータを、保持期間を指定しない限り、無期限に保持します。詳細については、「CloudWatch Logs でのログデータ保管期間の変更」を参照してください。

CloudWatch ログの統合の設定

ログデータの公開を有効にする前に、AWS Identity and Access Management (IAM) にサービスにリンクされたロールがあることを確認します。サービスにリンクされたロールの詳細については、「Amazon RDS のサービスにリンクされたロールの使用」を参照してください。

CloudWatch Logs にデータベースログファイルを発行するには、発行するログを選択します。新しい DB インスタンスを作成するとき、[Advanced Settings] セクションでこの選択を行います。また、既存の DB インスタンスを変更して発行を開始できます。

発行を有効にした後、Amazon RDS はすべての DB インスタンスログレコードをロググループに継続してストリームします。例えば、発行した各タイプのログにロググループ /aws/rds/instance/log type を持っているとします。このロググループは、ログを生成するデータベースインスタンスと同じ AWS リージョンにあります。

ログレコードを発行した後、CloudWatch Logs を使用してレコードの検索およびフィルタリングができます。ログの検索およびフィルタリングの詳細については、「ログデータの検索およびフィルタリング」を参照してください。RDS ログをモニタリングする方法を説明するチュートリアルについては、Amazon CloudWatch Logs、AWS Lambda、および Amazon SNS を使用して Amazon RDS のプロアクティブなデータベースモニタリングを構築するを参照してください。

エンジン固有のログ情報

エンジン別の情報については、以下を参照してください。

• MariaDB ログを Amazon CloudWatch Logs に発行する

• Amazon CloudWatch Logs への MySQL ログの発行

• Amazon CloudWatch Logs への Oracle ログの発行

• Amazon CloudWatch Logs への PostgreSQL ログの発行

• Amazon CloudWatch Logs への SQL Server ログの発行

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 インスタンスを指定した場合、レスポンスは次のエラーになります。

• DBInstanceNotFound—DBInstanceIdentifier が既存の DB インスタンスを参照していません。(HTTP ステータスコード: 404)