PostgreSQL とアップグレード ログをダウンロードする

PostgreSQL サーバー ログを使用して、Azure Database for PostgreSQL フレキシブル サーバー インスタンスで発生した特定の問題を診断し、サーバーで実行されるアクティビティに関する詳細な分析情報を得ることができます。 メジャー バージョン アップグレード ログを使用すると、サーバーを PostgreSQL の上位メジャー バージョンにアップグレードしようとしたときに発生する可能性のあるエラーをトラブルシューティングできます。

既定では、Azure Database for PostgreSQL フレキシブル サーバー インスタンスでダウンロードするサーバー ログのキャプチャは無効になっています。 ただし、この機能を有効にすると、Azure Database for PostgreSQL フレキシブル サーバー インスタンスがサーバー ログのファイルへのキャプチャを開始します。このログをダウンロードして詳細な検査を行うことができます。 Azure portal または Azure CLI コマンドを使用して、トラブルシューティングの作業に役立つこれらのファイルを一覧表示およびダウンロードできます。

この記事では、この機能を有効または無効にする方法について説明します。 また、利用可能なすべてのサーバー ログを一覧表示する方法と、それらをダウンロードする方法についても説明します。

ダウンロードのために PostgreSQL とアップグレード ログのキャプチャを有効にする手順

ポータル

Azure portal を使用して以下を実行します。

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

2. リソース メニューの [監視] セクションで、[サーバー ログ] を選びます。

   

3. [ ログをキャプチャしてダウンロードする] チェック ボックスをオンにします。

   

4. 既定では、ログ ファイルは 3 日間保持されますが、保持期間は 1 日から 7 日まで調整できます。 ログ保持期間 (日数) スライサーを使用して、目的の構成に合わせて調整します。

   

5. [保存] ボタンを選択します。

   

6. サービスによってダウンロード用のログのキャプチャが構成されていることを知らせる通知が表示されます。

   

7. 操作が終了すると、サービスによるダウンロード用のログのキャプチャの構成が完了したことを知らせる通知が表示されます。

   

CLI

az postgres flexible-server parameter set コマンドを使用すると、PostgreSQL サーバー ログとメジャー バージョン アップグレード ログのキャプチャを有効にすることができます。

ダウンロードするログのキャプチャを有効にするには、次のコマンドを使用します。

az postgres flexible-server parameter set \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.download_enable \
  --value on

ダウンロード用にキャプチャされたログの保持期間を調整するには、次のコマンドを使用します。

az postgres flexible-server parameter set \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.retention_days \
  --value <retention_period_in_days>

サーバー パラメーター logfiles.retention_days に使用できる値は、1 日から 7 日です。 別の値に設定しようとすると、次のエラーが発生します。

Code: ServerParameterToCMSUnAllowedParameterValue
Message: The value: [<value>] of Server Parameter: [logfiles.retention_days] is invalid, the allowed values are: [1-7]

Note

• ダウンロード用のサーバー ログのキャプチャを有効にしてから数分後に、最初のログをダウンロードできるようになります。

• 最初は約 1 時間、サーバー ログによってデータ ディスク領域が占有されます。 その後、バックアップ ストレージに移動され、構成された保持期間中そこに保持されます。

ダウンロードのために PostgreSQL とアップグレード ログのキャプチャを無効にする手順

ポータル

Azure portal を使用して以下を実行します。

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

2. リソース メニューの [監視] セクションで、[サーバー ログ] を選びます。

   

3. [ ダウンロード用のログのキャプチャ ] チェック ボックスをオフにします。

   

4. [保存] ボタンを選択します。

   

5. サービスによってダウンロード用のログのキャプチャが構成されていることを知らせる通知が表示されます。

   

6. 操作が終了すると、サービスによるダウンロード用のログのキャプチャの構成が完了したことを知らせる通知が表示されます。

   

CLI

az postgres flexible-server parameter set コマンドを使用すると、PostgreSQL サーバー ログとメジャー バージョン アップグレード ログのキャプチャを無効にすることができます。

ダウンロードするログのキャプチャを無効にするには、次のコマンドを使用します。

az postgres flexible-server parameter \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.download_enable \
  --value off

ダウンロード可能なキャプチャされたログを一覧表示する手順

ポータル

Azure portal を使用して以下を実行します。

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

2. リソース メニューの [監視] セクションで、[サーバー ログ] を選びます。

   

3. テーブルには、まだ削除されていないすべてのキャプチャ済みログ ファイルが表示されます。 ある時点でキャプチャされたが、構成された保持期間を超えたために削除されたファイルは、表示されず、アクセスできなくなります。 [ 名前を含むファイルの検索]、[ 時間範囲]、[ ログの種類 ] ボックスを使用して、表示されるログを減らすフィルター条件を定義できます。 列ヘッダーを選択すると、選択したヘッダーで表される属性の値によって、表示されるログ ファイルの一覧を昇順または降順で並べ替えることができます。 使用可能な各列の下に、各ファイルのさまざまな属性が表示されます。

   • [名前]: ログ ファイルの名前。 サービスによって、各ログ ファイルに postgresql_yyyy_mm_dd_hh_00_00.log というパターンの名前が割り当てられます。
   • [最終更新時刻]: 各ログ ファイルが最後にアップロードされた時刻のタイムスタンプ。 ログ ファイルは、約 10 分ごとにアップロードされます。
   • [サイズ]: ログ ファイルによって占有されるサイズ (バイト単位)。
   • ログの種類: サーバー ログ は、ファイルが PostgreSQL サーバー ログに対応することを示します。 アップグレード ログ は、ファイルがメジャー バージョンのアップグレード ログに対応することを示します。

   

4. テーブルの内容は自動的に更新されません。 最新の情報を表示するには、[最新の情報に更新] を選択します。

   

CLI

az postgres flexible-server server-logs list コマンドを使用すると、キャプチャされた PostgreSQL サーバー ログとメジャー バージョン アップグレード ログを一覧表示できます。

過去 72 時間 (既定値) に更新された、ダウンロード可能なすべてのキャプチャされたログを一覧表示するには、次のコマンドを使用します。

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server>

過去 10 時間以内に更新された、ダウンロード可能なすべてのキャプチャされたログを一覧表示するには、次のコマンドを使用します。

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --file-last-written 10

サイズが 30 KiB 未満の、ダウンロード可能なすべてのキャプチャされたログを一覧表示するには、次のコマンドを使用します。

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --max-file-size 30

名前に 01_07 が含まれる、ダウンロード可能なすべてのキャプチャされたログを一覧表示するには、次のコマンドを使用します。

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --filename-contains 01_07

キャプチャされたログをダウンロードする手順

ポータル

Azure portal を使用して以下を実行します。

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

2. リソース メニューの [監視] セクションで、[サーバー ログ] を選びます。

   

3. テーブルには、まだ削除されていないすべてのキャプチャ済みログ ファイルが表示されます。 ある時点でキャプチャされたが、構成された保持期間を超えたために削除されたファイルは、表示されず、アクセスできなくなります。 [ 名前を含むファイルの検索]、[ 時間範囲]、[ ログの種類 ] ボックスを使用して、表示されるログを減らすフィルター条件を定義できます。 列ヘッダーを選択すると、選択したヘッダーで表される属性の値によって、表示されるログ ファイルの一覧を昇順または降順で並べ替えることができます。 ダウンロードするログを特定し、[アクション] 列の [ダウンロード] を選択します。

   

4. 一度に複数のログ ファイルをダウンロードする場合は、ダウンロードするすべてのファイルを選択し、ツール バーの [ダウンロード] を選択します。

   

5. テーブルの内容は自動的に更新されません。 最新の情報を表示するには、[最新の情報に更新] を選択します。

   

CLI

az postgres flexible-server server-logs download コマンドを使用すると、キャプチャされた PostgreSQL サーバー ログとメジャー バージョン アップグレード ログをダウンロードできます。

特定のログを 1 つダウンロードするには、次のコマンドを使用します。

az postgres flexible-server server-logs download \
  --resource-group <resource_group> \
  --server-name <server> \
  --name <log_name>

特定のログを 1 つダウンロードするには、次のコマンドを使用します。

az postgres flexible-server server-logs download \
  --resource-group <resource_group> \
  --server-name <server> \
  --name <log1_name log2_name ...logn_name>

Note

• 指定されたファイル名に、ダウンロード可能な一致する名前のログ ファイルがある場合、同じ名前と内容のローカル ファイルが作成されます。

• 指定されたファイル名のいずれかがダウンロードできない場合、コマンドはエラーを報告しません。 そのファイルはダウンロードされません。

関連するコンテンツ

• 高可用性の構成。
• 予定メンテナンスを構成する。
• ポータルを使用してメトリックのアラートを作成します。