5.2. リポジトリーログのエクスポート
より多くのログファイルを取得して Red Hat Quay データベースの外に保存するには、ログのエクスポート機能を使用できます。ここでは、Export Logs を使用する上で知っておくべきことをいくつかご紹介します。
- リポジトリーから収集するログの日付の範囲を選択することができます。
- ログをメールに添付して送ったり、コールバック URL に誘導したりすることを要求することができます。
- ログをエクスポートするには、リポジトリーまたは名前空間の管理者権限が必要です。
- 一度に最大 30 日分のログデータをエクスポートすることができます。
- Export Logs では、過去に生成されたログデータのみを収集します。ログ取得中のデータのストリーミングは行いません。
- この機能を使用するには、Red Hat Quay インスタンスが外部ストレージ用に設定されている必要があります (ローカルストレージは使用できません)。
- ログが収集され利用できるようになったら、そのデータを保存したい場合はすぐにコピーしてください。デフォルトでは、データの有効期限は 1 時間となっています。
ログのエクスポート機能を使用するには、以下の手順を行います。
- 管理者権限のあるリポジトリーを選択します。
- 左の列から Usage Logs アイコンを選択します。Usage Logs 画面が表示されます。
- 収集したいログエントリーの開始日と終了日の範囲を選択します。
Export Logs ボタンを選択します。以下のような Export Usage Logs のポップアップが表示されます。
- エクスポートされたログを受信するメールアドレスまたはコールバック URL を入力します。コールバック URL には、webhook.site のような場所への URL を使用することができます。
- Start Logs Export を選択します。これにより、Red Hat Quay は選択したログエントリーの収集を開始します。収集するログデータの量にもよりますが、1 分から 1 時間程度で完了します。
ログのエクスポートが完了すると、以下のようになります。
- 要求したエクスポートされたログエントリーが利用可能になったことを通知するメールを受信します。
- webhook URL からログエクスポートのリクエストが成功したことを確認できます。エクスポートされたデータへのリンクが表示されるため、選択してログをダウンロードしてください。
この URL は Red Hat Quay の外部ストレージの場所を指しており、1 時間で期限切れになるように設定されていることに注意してください。そのため、エクスポートしたログを保存する場合は、その有効期限までにコピーしてください。