以前の名前:
動作条件: --enable-icap-client
デフォルト値: none
提案された設定:
ICAPのログファイルレコード,ICAPトランザクションの概要、トランザクションごとに1行。
icap_logオプションのフォーマットは次のとおり：
icap_log <filepath> [<logformat name> [acl acl ...]]
icap_log none [acl acl ...]]
詳細については、access_log のオプションのマニュアルを参照してください。
2種類のログは全体構成アプローチと多くの特徴を共有しています。
単一のHTTPメッセージまたはトランザクションのICAP処理は、複数のICAPトランザクションを必要とする場合があります。
このような場合、複数のICAPトランザクション・ログの行は、単一のアクセス・ログの行に対応する。
ICAPログは logformat コードを使い、ICAPトランザクションのための意味をなしています。
ヘッダに関連した(Header-related)コードは次の点に注意して、ICAPサーバの応答に埋め込まれたHTTPヘッダーに適用されます：
REQMODの場合、ICAPサーバがリクエストの履行を実施させない限りHTTPレスポンスヘッダーはありません。
RESPMODの場合、ICAPサーバにHTTPリクエスト・ヘッダーは送信されます。
OPTIONSの場合、HTTPヘッダは全くありません。
次の形式のコードは、ICAPログで使用できます：
- icap::
- ICAPサーバのIPアドレス。ìス。 <A に類似。
- icap::<service_name
- Squid の構成ファイル内の icap_service オプションでのICAPサービス名。
- icap::ru
- ICAP Request-URI。 ru に類似。
- icap::rm
- ICAP リクエストメソッド (REQMOD, RESPMOD, または OPTIONS)
既存のRMに類似。
- icap::>st
- ICAPサーバに送信されたバイト(TCPペイロードのみ。つまり、Squidはどのソケットから読取る)
- icap::<st
- ICAPサーバから受信したバイト。（TCPペイロードのみ。つまり、Squidはどのソケットから読取る）
- icap::
- ICAPサーバから受信したメッセージ本体のバイト数。
ICAPメッセージ本文、もしあれば、通常、カプセル化されたHTTPメッセージヘッダおよび場合によってカプセル化されたHTTPメッセージボディを含む。
そのサイズが計算される前にHTTPボディ部は非塊化(dechunked)されます。
- icap::tr
- トランザクションの応答時間（ミリ秒単位）。
タイマは、ICAPトランザクションが作成されるときに開始され、トランザクションが完了したときに停止する。
tr に類似。
- icap::tio
- トランザクションI/O時間（ミリ秒単位）。
最初のICAPリクエストバイトが送信するためにスケジュールされたときにタイマーが開始されます。
タイマーは、ICAP応答の最後のバイトを受信したときに停止します。
- icap::to
- トランザクションの結果：
ICAP_ERR* は、すべてのトランザクション・エラー
ICAP_OPT は、オプショントランザクション
ICAP_ECHO は、204の応答
ICAP_MOD は、メッセージ変更
ICAP_SAT は、request satisfaction
Ssに類似。
- icap::Hs
- ICAP応答のステータスコード。 Hsに類似。
- icap::>h
- ICAP要求ヘッダ。 >h に類似。
- icap::<h
- ICAP応答ヘッダ。 <h に類似。
明示的な定義なしで使用できるデフォルトのICAPログ形式は、icap_squid と呼ばれている：
logformat icap_squid %ts.%03tu %6icap::tr %>a %icap::to/%03icap::Hs %icap::<size %icap::rm %icap::ru% %un -/%icap::<A -
参照：logformat, log_icap, および %adapt::<last_h