ログストリーミング:Google Cloud Pub/Sub

Fastlyのリアルタイムログストリーミング機能では、Googleのグローバルメッセージングおよびイベントデータ取り込み製品であるCloud Pub/Subにログファイルを送信することができます。

注意

Fastly ではサードパーティのサービスに関する直接のサポートは行っておりません。詳細については、Fastly のご利用規約をご覧ください。

前提条件

Fastly サービスのログエンドポイントとして Cloud Pub/Sub を追加する前に、Google Cloud Platform (GCP) アカウントに登録する必要があります。

  • Google の Web サイトでサービスアカウントを作成します。
  • Google Cloud コンソールの Pub/Sub セクションに移動します。画面の指示に従って API を有効化します。
  • Pub/Sub トピックを作成します。
  • Google IAM サービスアカウントの偽装やキーベースのアクセスを使用して、Fastly がログを送信するために使用するアクセスメソッドを設定します。

サービスアカウントを作成する

Google Cloud Platform (GCP) は、Google Cloud リソースへのサードパーティのアプリケーション認証とロールベースのアクセスのためにサービスアカウントを使用します。 新しいサービスアカウントを作成するには、Google Cloud のドキュメントの指示に従ってください。

注意

Google Pub/Sub にログを配信するためにサービスアカウントを作成する場合、Fastly のログに作成したトピックに公開するPub/Sub Publisherロールをサービスアカウントに割り当てなければなりません。

サービスアカウント作成パネル

サービスアカウントへのアクセスを設定する

Fastly は、Pub/Sub のトピックにログを書き込みたい場合、アクセスを必要とします。 ロールベースのサービスアカウントの偽装やキーベースのアクセスを使用して、Fastly が Google Pub/Sub にログを送信できるようにすることができます。

Google IAM サービスアカウントの偽装の設定

Fastly でキーを保存することを避けるために、Google IAM サービスアカウントの偽装の使用を選択した場合、上記で作成した同じサービスアカウントを使用することができます。 Google IAM ロール作成に関するガイドでは、この機能の構成の詳細を説明しています。

キーベースのアクセスの設定

キーベースのアクセスの使用を選択した場合、サービスアカウントの認証情報の生成に関する Google のガイドを参照してください。

キーベースのアクセスを設定する場合、JSON 形式を選択する必要があります。 設定を保存すると、作成したばかりのGCS サービスアカウントの認証情報を含む JSON ファイルがコンピュータにダウンロードされます。 テキストエディターでファイルを開き、private_keyclient_email を記録しておきます。

注意

Cloud Pub/Sub の詳細については、Google のドキュメントをご覧ください。

ログエンドポイントとして Cloud Pub/Sub を追加する

次の指示に従って、ログエンドポイントとして Cloud Pub/Sub を追加してください。設定の一環として、機密情報の保存を回避するために、Google IAM ロールベースのサービスアカウントの偽装の設定を選択できます。この機能の詳細については、Google IAM ロールの作成ガイドをご覧ください。

  1. 配信サービス
  2. Compute サービス
  1. リモートログストリーミングの設定に関するガイドをご確認ください。
  2. Google Cloud Pub/Sub エリアで、Create endpoint をクリックします。
  3. Create a Google Cloud Pub/Sub endpoint フィールドに以下のように記入します。
    • Name フィールドに分かりやすいエンドポイントの名前を入力します。
    • Placement セクションでは、生成される VCL にログコールが配置される場所を選択します。有効な値は Format Version Defaultwaf_debug (waf_debug_log)None です。詳細については、ログ配置の変更に関するガイドをご覧ください。
    • Log format 欄に、Google Cloud Pub/Sub に送信するデータを入力します。詳細は形式の例のセクションを参照してください。
    • Project ID フィールドには、Google Cloud Platform プロジェクトの ID を入力します。
    • Email フィールドに、Pub/Sub トピックに設定されたサービスアカウントのメールアドレスを入力します。
    • Topicフィールドには、ログを送信先となる Pub/Sub トピックを入力します。
    • Access Method セクションで、ログ配信の目的で Fastly が Google リソースにアクセスする方法を選択します。有効な値は、User CredentialsIAM Role です。
    • User Credentials を選択した場合は、以下のフィールドに入力します。
      • Email フィールドに、Pub/Sub トピックに設定されたサービスアカウントのメールアドレスを入力します。
      • Secret Key フィールドには、Pub/Sub トピックに設定されたサービスアカウントに関連付けられたprivate_keyの正確な値を入力します。
    • IAM ロールを選択した場合、以下のフィールドに入力します。
      • Service Account Nameフィールドに、Google IAM サービスアカウントの偽装を設定する際に選択したサービスアカウントのメールアドレスの名前を入力します。
  4. Create をクリックして新規のログエンドポイントを作成します。
  5. Activate をクリックして設定への変更をデプロイします。

形式例

Cloud Pub/Sub に送信されたデータは JSON オブジェクトとしてシリアル化され、JSON オブジェクト内のフィールドはすべて、テーブルのスキーマ内の文字列にマッピングされる必要があります。JSON にはネストされたデータが入っていることがあります (例、オブジェクトのキーを値が別のオブジェクトである場合があります)。データを送信するためのフォーマット文字列の例は、こちらです。

1{
2 "timestamp": "%{strftime(\{"%Y-%m-%dT%H:%M:%S%z"\}, time.start)}V",
3 "client_ip": "%{req.http.Fastly-Client-IP}V",
4 "geo_country": "%{client.geo.country_name}V",
5 "geo_city": "%{client.geo.city}V",
6 "host": "%{if(req.http.Fastly-Orig-Host, req.http.Fastly-Orig-Host, req.http.Host)}V",
7 "url": "%{json.escape(req.url)}V",
8 "request_method": "%{json.escape(req.method)}V",
9 "request_protocol": "%{json.escape(req.proto)}V",
10 "request_referer": "%{json.escape(req.http.referer)}V",
11 "request_user_agent": "%{json.escape(req.http.User-Agent)}V",
12 "response_state": "%{json.escape(fastly_info.state)}V",
13 "response_status": %{resp.status}V,
14 "response_reason": %{if(resp.response, "%22"+json.escape(resp.response)+"%22", "null")}V,
15 "response_body_size": %{resp.body_bytes_written}V,
16 "fastly_server": "%{json.escape(server.identity)}V",
17 "fastly_is_edge": %{if(fastly.ff.visits_this_service == 0, "true", "false")}V
18}

翻訳についての注意事項
このガイドは役に立ちましたか?

このフォームを使用して機密性の高い情報を送信しないでください。サポートが必要な場合は、サポートチームまでご連絡ください。このフォームは reCAPTCHA によって保護されており、Google のプライバシーポリシー利用規約が適用されます。