ログに有用な変数

  最終更新日 2023-10-12

一般的なカスタムログに加えて、リモートログストリーミングに以下のリクエストとレスポンスに関連する変数をログに含めることができます。また、あらゆる Varnish 変数 VCL の機能拡張 のご利用もご検討ください。

注意

すべての変数の前に、パーセント記号 (%) を付ける必要があります。 文字列形式の詳細については、カスタムログ形式に関するガイドをご覧ください。

重要

ストリームログに含める予定のデータに対する設定とエンドポイントの決定を行う際には、セキュリティ、プライバシー、およびコンプライアンスのそれぞれの要件を必ず考慮するようにしてください。

時間に関連するログ変数

ログに含めることが可能な時間に関連する変数です。

変数説明
%{begin:%Y-%m-%dT%H:%M:%S%z}tリクエストを開始した時間 (ISO 8601規格)。
%{end:%Y-%m-%dT%H:%M:%S%z}tリクエストが終了した時間 (ISO 8601規格)。
%{time.elapsed.usec}Vリクエストを処理するのに要した時間 (マイクロ秒)。
%{time.start.sec}Vリクエストを開始した時間 (エポック秒)。

接続に関連するログ変数

ログに含めることが可能な接続に関連する変数です。

変数説明
%{if(req.is_ipv6, "true", "false")}Vリクエストが IPv6 で行われたどうか。
%{if(req.is_ssl, "true", "false")}Vリクエストが HTTPS で行われたかどうか。
%{cstr_escape(tls.client.protocol)}Vクライアントとの接続に利用された TLS のバージョン。
%{cstr_escape(tls.client.servername)}Vクライアントが送信した SNI サーバー名。
%{cstr_escape(tls.client.cipher)}Vどの暗号が TLS リクエストに使われたか。
%{cstr_escape(tls.client.ciphers_sha)}Vどの暗号が TLS リクエストに使われたか。
%{cstr_escape(tls.client.tlsexts_sha)}Vクライアントが TLS ハンドシェイクの一部として送信した TLS 拡張識別の SHA (Base64)。
%{if(fastly_info.is_h2, "true", "false")}V接続が HTTP/2 リクエストかどうか。
%{if(fastly_info.h2.is_push, "true", "false")}VHTTP/2 プッシュレスポンスかどうか。
%{fastly_info.h2.stream_id}VHTTP/2 ストリーム ID が何であったか。

リクエストとレスポンスに関連するログ変数

ログに含めることが可能なリクエストとレスポンスに関連する変数です。

変数説明
%{Fastly-Orig-Host}iHost ヘッダーのオーバーライドが存在する場合、リクエストに設定されていた元の Host ヘッダー。
%{Host}i変数取得時点での Host リクエストヘッダー (オリジンに送信する前に変更されている可能性があるため)。
%{Referer}iReferer リクエストヘッダー。リンク元の URL。
%{User-Agent}iUser-Agent リクエストヘッダー。ページをリクエストしたブラウザ。
%{Accept}iAccept リクエストヘッダー。クライアントが対応可能なコンテンツタイプ。
%{Accept-Language}iAccept-Language リクエストヘッダー。クライアントが応答可能な言語。
%{Accept-Encoding}iAccept-Encoding リクエストヘッダー。クライアントが理解可能なコンテンツのエンコーディング形式。
%{Accept-Charset}iAccept-Charset リクエストヘッダー。クライアントが対応可能な文字エンコーディング。
%{Connection}iConnection リクエストヘッダークライアントの keep-alive 利用の可否。
%{DNT}iDNT リクエストヘッダー。クライアントが「Do Not Track」ヘッダーを送ったかどうか。
%{Forwarded}iForwarded リクエストヘッダー。リクエストがプロキシを経由した場合、リクエストの送信元であるクライアントの IP アドレス。
%{Via}iVia リクエストヘッダー。プロキシされたリクエストにおけるユーザーエージェントとサーバー間の中間プロトコルとプロキシサーバー。
%{X-Requested-With]iX-Requested-With リクエストヘッダー。通常、XMLHttpRequest でリクエストされる Ajax リクエストを判別する目的で利用されます。
%{X-Requested-For}iX-Requested-For リクエストヘッダー。リクエストがプロキシを経由した場合、リクエストの送信元であるクライアントの IP アドレス。
%{X-ATT-DeviceId}iX-ATT-DeviceId リクエストヘッダー。AT&T デバイスのメーカー、モード、ファームウェア。
%{Content-Type}oContent-Type レスポンスヘッダー。コンテンツの MIME タイプ。
%{TSV}oTSV レスポンスヘッダー。DNT リクエストに対するレスポンスに含まれるトラッキングステータスを示す値。

キャッシュステータスに関連するログ変数

ログに含めることが可能なキャッシュステータスに関連する変数です。

変数説明
%{If-Modified-Since}iIf-Modified-Since リクエストヘッダー。サーバはリクエストの IMS ヘッダーに指定された日時よりも新しいコンテンツを持つ場合にのみ、200ステータスでレスポンスを返します。
%{If-None-Match}iIf-None-Match リクエストヘッダー。サーバーは該当するリソースが If-None-Match に指定された Etag に一致しない場合に、200ステータスでレスポンスを返します。
%{Cache-Control}oCache-Control レスポンスヘッダー。サーバーからクライアントまでのすべてのキャッシュメカニズムで、オブジェクトを数秒でキャッシュできるかどうか。
%{Age}oAge レスポンスヘッダー。オブジェクトがプロキシキャッシュに保持されていた秒数。
%{Expires}oExpires レスポンスヘッダー。レスポンスが失効したと判断される日時が、RFC7231 で定義されている「HTTP-date」形式で示されます。
%{Last-Modified}oLast-Modified レスポンスヘッダー。リクエストされたオブジェクトが最後に更新された日時が、RFC7231 で定義されている「HTTP-date」形式で示されます。If-Modified-Since リクエストヘッダーと併せて使用されます。
%{ETag}oETag レスポンスヘッダー。リソースの特定のバージョンを示す識別子。If-None-Match Request ヘッダーと併せて使用されます。
%{obj.hits}Vキャッシュされたオブジェクトがヒットした回数。
%{obj.lastuse}Vキャッシュされたオブジェクトが最後に利用された時。
"cache_status":"%{fastly_info.state}V"(Fastly 固有) リクエストの状態。オプションのサフィックスで特別なケースを説明しています。

地理情報に関連するログ変数

ログに含めることが可能な地理情報に関連する変数です。

変数説明
%{server.datacenter}Vリクエストの処理に使用された Fastly のデータセンター。
%{client.geo.city}Vリクエスト発生元の都市。
%{client.geo.city.ascii}V`client.geo.city` のエイリアス。
%{client.geo.city.utf8}VUTF-8 文字エンコーディングを使用してエンコードされた、IP アドレスに関連付けられた都市または町の名前。
%{client.geo.country_code}Vリクエスト発生元の国コード。
%{client.geo.continent_code}Vリクエスト発生元の大陸コード。
%{client.geo.region}Vリクエスト発生元のリージョンコード。

サイズに関連するログ変数

ログに含めることが可能なサイズ情報に関連する変数です。

変数説明
%{req.header_bytes_read}Vリクエストヘッダーのサイズ。
%{req.body_bytes_read}Vリクエストボディのサイズ。
%{resp.header_bytes_written}Vレスポンスヘッダーのサイズ。
%{resp.body_bytes_written}Vレスポンスボディのサイズ。

Socket 関連のログ変数

ログに含めることが可能な Socket 情報に関連する変数です。

変数説明
%{client.socket.cwnd}Vクライアントソケットの輻輳ウィンドウサイズ。
%{client.socket.nexthop}V次のゲートウェイの IP アドレス。
%{client.socket.tcpi_rcv_mss}Vクライアントソケットの受信セグメントサイズの最大値。
%{client.socket.tcpi_snd_mss}Vクライアントソケットの送信セグメントサイズの最大値。
%{client.socket.tcpi_rtt}Vクライアントソケットの平準化したラウンドトリップ時間 (マイクロ秒)。
%{client.socket.tcpi_rttvar}Vクライアントソケットのラウンドトリップ時間偏差 (マイクロ秒) 。
%{client.socket.tcpi_rcv_rtt}Vクライアントソケットの受信側におけるラウンドトリップ時間の推測値 (マイクロ秒)。
%{client.socket.tcpi_rcv_space}V受信したデータに対して現在利用可能なバッファースペース。
%{client.socket.tcpi_last_data_sent}Vクライアントソケットに最後にデータが送られてからの時間 (マイクロ秒)。
%{client.socket.tcpi_total_retrans}Vクライアントソケットでのパケット再送回数の合計。
%{client.socket.tcpi_delta_retrans}Vクライアントソケットでのパケット再送回数の差異。
%{client.socket.ploss}Vクライアントソケットのパケットロス。

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

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

Fastly
© Fastly 2024