ログストリーミング: HTTPS

1. リモートログストリーミングの設定に関するガイドをご確認ください。
2. HTTPS エリアで、Create endpoint をクリックします。
3. Create an HTTPS endpoint フィールドに次のように入力します。
   • Name フィールドに分かりやすいエンドポイントの名前を入力します。
   • Placement セクションでは、生成される VCL にログコールが配置される場所を選択します。有効な値は Format Version Default、waf_debug (waf_debug_log)、None です。詳細については、ログ配置の変更に関するガイドをご覧ください。
   • Log format フィールドには、ログ形式に使用する Apache 形式の文字列や VCL 変数を任意で入力します。詳細については、形式例のセクションをご覧ください。
   • URL フィールドに、ログデータの送信先となる URL を入力します (例: https://logs.example.com/)。
   • (オプション) Maximum logs フィールドに、バッチとして送信するログの最大数を入力します。
   • (オプション) Maximum bytes フィールドには、ログバッチの最大サイズを入力します。
4. Advanced options をクリックして、以下のようにフィールドにすべて入力します。
   • (オプション) Content type フィールドには、ログを送信する際に使用するコンテンツタイプを入力します (例: application/json)。
   • (オプション) Custom header name フィールドには、ログを送信する際に使用するカスタムヘッダーを入力します (例: Authorization)。
   • (オプション) Custom header value フィールドには、ログを送信する際に使用するカスタムヘッダー値を任意で入力します (例: Bearer <token>)。
   • (オプション) Method エリアにて、適切な HTTP 方式を選択します。
   • JSON log entry format エリアにて、適切なログエントリー形式を選択します。JSON log entry format は、有効な JSON フォーマットを強制するものです。Array of JSON を選択すると、JSON のログバッチを配列でラップします。Newline delimited を選択すると、各 JSON ログエントリーをバッチ内の新しい行に配置します。
   • Select a log line format のセクションで、ログメッセージのログライン形式を選択します。詳細については、ログライン形式の変更に関するガイドをご覧ください。
5. Advanced options エリアの Using your own certificate authority (CA) セクションに次のように記入します。
   • (オプション) TLS Hostname フィールドには、ログエンドポイントサーバーの証明書を検証するホスト名を入力します。コモンネーム (CN) またはサブジェクト代替名 (SAN) のどちらかを入力してください。このフィールドは、Use TLS メニューから Yes を選択した場合にのみ表示されます。
   • (オプション) TLS CA certificate フィールドには、ログエンドポイントサーバーの証明書が有効であることを確認するために使用する認証機関 (CA) の証明書をコピー＆ペーストしてください。アップロードする証明書は PEM 形式である必要があります。周知の認証機関によって署名されてない場合には、証明書のアップロードを熟慮してください。TLS 証明書が周知の機関によって署名されていれば、必要ありません。このフィールドは、Use TLS メニューから Yes を選択した場合にのみ表示されます。
   • (オプション) TLS client certificate フィールドには、Fastly をログエンドポイントサーバーへ認証する際に使用する TLS クライアント証明書をコピー＆ペーストしてください。アップロードする TLS クライアント証明書は、PEM 形式で、クライアントキーを添付する必要があります。TLS クライアント証明書により、Fastly が接続を実行していることをログエンドポイントサーバーが認証できるようになります。このフィールドは、Use TLS メニューから Yes を選択した場合にのみ表示されます。
   • (オプション) TLS client key フィールドには、ログエンドポイントサーバーへの認証に使用する TLS クライアントキーをコピー＆ペーストしてください。アップロードする TLS クライアントキーは、PEM 形式で、TLS クライアント証明書を添付する必要があります。TLS クライアントキーにより、Fastly が接続を実行していることをログエンドポイントサーバーが認証できるようになります。このフィールドは、Use TLS メニューから Yes を選択した場合にのみ表示されます。
6. Create をクリックして新規のログエンドポイントを作成します。
7. Activate をクリックして設定への変更をデプロイします。

フォーマットの例

以下に示すのは、HTTPS ログエンドポイントにデータを送信する書式指定文字列の例です。書式指定文字列の詳細については、こちらをご覧ください。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

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