Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

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 で、メンバー logpush@cloudflare-data.iam.gserviceaccount.com を 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 .

役に立ちましたか？