Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

Google Cloud Storage を有効にする

最終更新 Markdown で表示Agent セットアップ

Cloudflare Logpush は、Cloudflare ダッシュボードまたは API から、Google Cloud Storage(GCS)へログを直接プッシュできます。

Cloudflare ダッシュボードで管理する

  1. Cloudflare ダッシュボードで、アカウントまたはドメイン(ゾーンとも呼ばれます)の Logpush ページを開きます。

    アカウントの場合: 公式ダッシュボードで Logpush を開く ↗

    ドメイン(ゾーン)の場合: 公式ダッシュボードで Logpush を開く ↗

  2. 選んだ範囲に応じて、それぞれ アカウントスコープのデータセット と ゾーンスコープのデータセット を利用できます。

  3. Create a Logpush job を選択します。

  1. Select a destination で Google Cloud Storage を選びます。

  2. 次の送信先の詳細を入力または選択します。

    • Bucket - GCS バケット名
    • Path - ストレージコンテナ内のバケットの場所
    • Organize logs into daily subfolders(推奨)
    • Grant Cloudflare access to upload files to your bucket では、バケットに Cloudflare の IAM が Storage Object Admin ロール ↗ を持つユーザーとして追加されていることを確認します。

送信先の詳細を入力したら、Continue を選択します。

  1. 所有権を証明するため、Cloudflare は指定した送信先にファイルを送信します。トークンを確認するには、所有権チャレンジファイルの Overview タブで Open ボタンを選択し、Cloudflare ダッシュボードに貼り付けてバケットへのアクセスを検証します。Ownership Token を入力し、Continue を選択します。

  2. ストレージサービスへプッシュするデータセットを選択します。

  3. 次のステップで、Logpush ジョブを設定します。

    • Job name を入力します。
    • If logs match では、ログに含めるイベントと除外するイベントを選べます。詳細は フィルター を参照してください。このオプションがないデータセットもあります。
    • Send the following fields では、すべてのログを送信先へプッシュするか、プッシュするログを選ぶかを選べます。
  4. Advanced Options では、次の設定ができます。

    • ログ内のタイムスタンプフィールドの形式を選びます(RFC3339(デフォルト)、Unix、または UnixNano)。
    • ログの サンプリングレート を選ぶか、ランダムにサンプリングした割合のログをプッシュします。
    • CVE-2021-44228 の秘匿化を有効にします。このオプションは ${ の出現をすべて x{ に置き換えます。
  5. Logpush ジョブの設定が完了したら、Submit を選択します。

GCS バケットを作成してアクセスを許可する

Cloudflare は Google Cloud Identity and Access Management(IAM)を使ってバケットにアクセスします。Cloudflare の IAM サービスアカウントには、バケットの管理者権限が必要です。

Logpush ジョブの読み取りや設定の前に、Log Share の権限が有効になっていることを確認してください。詳細は Roles のセクション を参照してください。


Logpush を GCS に有効にするには、次の手順を実行します。

  1. GCS バケットを作成します。GCS の手順 ↗ を参照してください。

  2. Storage > Browser > Bucket > Permissions で、メンバー [email protected] を Storage Object Admin 権限で追加します。

圧縮と展開トランスコーディング

Logpush は、ログファイルを常に gzip 圧縮形式で配信します。GCS へアップロードするとき、Logpush はオブジェクトメタデータに Content-Encoding: gzip を設定します。

GCS は、デフォルトで 展開トランスコーディング(decompressive transcoding) ↗ を行います。Content-Encoding: gzip で保存されたオブジェクトをクライアントがダウンロードするとき、リクエストヘッダーに Accept-Encoding: gzip が含まれていないと、GCS は転送中にファイルを自動で展開することがあります。この場合、ファイル名は .gz のままですが、ダウンロードしたファイルには非圧縮データが含まれます。

ログファイルを元の圧縮形式でダウンロードするには、次のいずれかの方法を使います。

  • ダウンロードリクエストのヘッダーに Accept-Encoding: gzip を含めます。 たとえば gsutil を使う場合:

    gsutil -h "Accept-Encoding: gzip" cp gs://your-bucket/path/file.log.gz .

役に立ちましたか?