5.2. リポジトリログのエクスポート

より多くのログファイルを取得して Red Hat Quay データベースの外に保存するには、ログのエクスポート機能を使用できます。ここでは、Export Logsを使用する上で知っておくべきことをいくつかご紹介します。

  • リポジトリから収集するログの日付の範囲を選択することができます。
  • ログをメールに添付して送ったり、コールバックURLに誘導したりすることを要求することができます。
  • ログをエクスポートするには、リポジトリまたは名前空間の管理者権限が必要です。
  • 一度に最大30日分のログデータをエクスポートすることができる
  • Export Logsでは、過去に生成されたログデータのみを収集します。ログ取得中のデータのストリーミングは行いません。
  • この機能を使用するには、Red Hat Quayインスタンスが外部ストレージ用に設定されている必要があります(ローカルストレージは使用できません)。
  • ログが収集され利用できるようになったら、そのデータを保存したい場合はすぐにコピーしてください。デフォルトでは、データの有効期限は1時間となっています。

ログのエクスポート機能を使うには、以下の手順を実施します。

  1. 管理者権限のあるリポジトリを選択します。
  2. 左の列からUsage Logsアイコンを選択します。Usage Logs画面が表示されます。
  3. 収集したいログエントリの開始日と終了日の範囲を選択します。
  4. Export Logsボタンを選択します。以下のようなExport Usage Logsのポップアップが表示されます。

    Enter email or callback URL to receive exported logs

  5. エクスポートされたログを受信するメールアドレスまたはコールバックURLを入力します。コールバックURLには、webhook.siteのような場所へのURLを使うことができます。
  6. Start Logs Exportを選択します。これにより、Red Hat Quay は選択したログエントリの収集を開始します。収集するログデータの量にもよりますが、1分から1時間程度で完了します。
  7. ログのエクスポートが完了すると、以下のようになります。

    • 要求したエクスポートされたログエントリが利用可能になったことを通知するメールを受信します。
    • webhook URLからログエクスポートのリクエストが成功したことを確認できます。エクスポートされたデータへのリンクが表示されるので、選択してログをダウンロードしてください。

このURLはRed Hat Quayの外部ストレージの場所をポイントし、1時間で期限切れになるように設定されていることに注意してください。そのため、エクスポートしたログを保存する場合は、その有効期限までにコピーしてください。