ログに有用な変数

  Last updated November 09, 2018

一般的なカスタムログに加えて、リモートログストリーミングに以下のリクエストとレスポンスに関連する変数をログに含めることが出来ます。この他 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	接続が HTTP2 で行われたかどうか。
%{if(fastly_info.h2.is_push, "true", "false")}V	HTTP2 プッシュレスポンスかどうか。
%{fastly_info.h2.stream_id}V	HTTP2 ストリーム ID。

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

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

                                                                           

変数	説明
%{Fastly-Orig-Host}i	リクエストに元々設定されていた Host ヘッダー。
%{Host}i	変数取得時点での Host（リクエスト）ヘッダー (オリジンに送信する前に変更されている可能性があります)。
%{Referer}i	Referer（リクエスト）ヘッダー。リンク元のURL。
%{User-Agent}i	User-Agent（リクエスト）ヘッダー。ページをリクエストしたブラウザ等の情報。
%{Accept}i	Accept（リクエスト）ヘッダー。クライアントが利用可能な MIME タイプ
%{Accept-Language}i	Accept-Language（リクエスト）ヘッダー。クライアントが利用可能な言語コード。
%{Accept-Encoding}i	Accept-Encoding（リクエスト）ヘッダー。クライアントが利用可能なエンコーディング形式。
%{Accept-Charset}i	Accept-Charset（リクエスト）ヘッダー。クライアントが利用可能な文字エンコーディング。
%{Connection}i	Connection（リクエスト）ヘッダー。クライアントの keep-alive 利用の可否。
%{DNT}i	DNT（リクエスト）ヘッダー。クライアントが "Do Not Track" ヘッダーを送ったかどうか。
%{Forwarded}i	Forwarded（リクエスト）ヘッダー。リクエストがプロキシを経由した場合、プロキシからみたクライアントの IP の情報。
%{Via}i	Via（リクエスト）ヘッダー。リクエストをプロキシしたサーバや中間プロトコル情報。
%{X-Requested-With]i	X-Requested-With（リクエスト）ヘッダー。 通常、XMLHttpRequest でリクエストされる Ajax リクエストを判別する目的で利用される。
%{X-Requested-For}i	X-Requested-For（リクエスト）ヘッダー。リクエストがプロキシを経由した場合、プロキシからみたクライアントの IP の情報。
%{X-ATT-DeviceId}i	X-ATT-DeviceId（リクエスト）ヘッダー。AT&T デバイスのMake Mode または ファームウェア。
%{Content-Type}o	Content-Type レスポンスヘッダー。コンテンツの MIME タイプ。
%{TSV}o	TSV レスポンスヘッダー。DNT リクエストに対するレスポンスに含まれる トラッキングステータスを示す値。

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

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

                                           

変数	説明
%{If-Modified-Since}i	If-Modified-Since（リクエスト）ヘッダー。サーバはリクエストの IMS ヘッダーに指定された日時よりも新しいコンテンツを持つ場合にのみ 200 ステータスでレスポンスを返却します。
%{If-None-Match}i	If-None-Match（リクエスト）ヘッダー。サーバーは該当のリソースが If-None-Match に指定された Etag に一致しない場合に 200 ステータスでレスポンスを返却します。
%{Cache-Control}o	Cache-Control レスポンスヘッダー。キャッシュのコントロールに必要な指示や情報。
%{Age}o	Age レスポンスヘッダー。オブジェクトがプロキシキャッシュに保持されていた秒数。
%{Expires}o	Expires レスポンスヘッダー。レスポンスが失効したと判断される、 RFC 7231 フォーマットで定義された日時。
%{Last-Modified}o	Last-Modified レスポンスヘッダー。リクエストされたオブジェクトが最後に更新された日時。RFC 7231 で "HTTP-date" と定義されているフォーマット. If-Modified-Since リクエストヘッダーと併せて利用される。
%{ETag}o	ETag レスポンスヘッダー。リソースのバージョンを特定するために利用され、 If-None-Match リクエストヘッダーと併せて利用される。
%{obj.hits}V	キャッシュされたオブジェクトがヒットした回数。
%{obj.lastuse}V	キャッシュされたオブジェクトが最後に利用された時間。

Fastly-specific 独自の変数:

               

変数	説明
%{if(fastly_info.state ~"^(HIT|MISS)(?:-|$)", "true", "false")}V	オブジェクトがキャッシュ可能かどうか。
%{regsub(fastly_info.state, "^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*", "\\2\\3") }V	レスポンスが HIT, MISS, PASS, ERROR, PIPE, HITPASS, または SYNTH(etic) のどれであったか。

地理情報に関連する変数

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

                           

変数	説明
%{server.datacenter}V	配信に利用された Fastly のデータセンター。
%{client.geo.city}V	リクエスト発生元の都市。
%{client.geo.city.ascii}V	`client.geo.city`の別名。
%{client.geo.city.utf8}V	UTF-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	輻輳ウィンドウサイズ(CWND - Congestion Window Size) 。
%{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	クライアントソケットのパケットロス。

その他のログ変数

その他に以下のような内容をログに含めることが可能です。

           

変数	説明
%{LF}V	改行。 (例, "\n")。

Was this guide helpful?

Yes No

Tell us what worked and what we could do better.

Do not use this form to send sensitive information. If you need assistance, contact support@fastly.com.

Back to Top