W3C ログ

  • [アーティクル]

W3C 拡張ログは、サーバー 側のログ記録の種類であり、サーバー セッションまたは URL グループで有効にすることができます。 URL グループで W3C ログが有効になっている場合、ログ記録は URL グループにルーティングされた要求に対してのみ実行されます。 W3C ログ記録を有効にするように構成された URL グループごとに、個別のログ ファイルが作成されます。

サーバー セッションで W3C ログが有効になっている場合、サーバー セッションの下にあるすべての URL グループのログ記録の一元化された形式として機能します。 サーバー セッション内のすべての URL グループに対して、1 つのログ ファイルが保持されます。

次の表に、HTTP Server API でログに記録できるフィールドの一覧を示します。 テーブルには、 HTTP_LOG_FIELD 定数のサブセットが含まれています。 以下に示すフィールドの一部は、HTTP Server API によって内部的に自動生成されるため、 HTTP_LOG_FIELDS_DATA 構造には含まれていません。 "Appears As" 列には、ログ ファイルに表示されるテキストが含まれています。 テーブル内のデータは、ログ ファイル レコード内の出現順です。

"HTTP Server API generated" とマークされていないフィールドは、アプリケーションによって 構造体HTTP_LOG_FIELDS_DATA 渡される必要があります。 アプリケーションは、渡された HTTP_REQUEST 構造からこれらのフィールドを生成できます。

フィールド [次のように表示] 説明 HTTP_LOG_FIELDS_DATA メンバー HTTP_LOG_FIELDS定数
Date 日付 アクティビティが発生した日付。 HTTP サーバー API が生成されました。 HTTP_LOG_FIELD_DATE
Time time アクティビティが発生した世界協定時刻 (UTC) の時刻。 HTTP サーバー API が生成されました。 HTTP_LOG_FIELD_TIME
サービス名とインスタンス番号 s-sitename クライアントで実行されていたインターネット サービス名とインスタンス番号。 ServiceName HTTP_LOG_FIELD_SITE_NAME
サーバー名 s-computername ログ ファイル エントリが生成されたサーバーの名前。 ServerName HTTP_LOG_FIELD_COMPUTER_NAME
サーバー IP アドレス s-ip ログ ファイル エントリが生成されたサーバーの IP アドレス。 ServerIp HTTP_LOG_FIELD_SERVER_IP
メソッド cs-method 要求された動詞 (GET メソッドなど)。 メソッド HTTP_LOG_FIELD_METHOD
URI Stem cs-uri-stem 動詞のターゲット (たとえば、Default.htm)。 UriStem HTTP_LOG_FIELD_URI_STEM
URI クエリ cs-uri-query クライアントが実行しようとしていたクエリ (存在する場合)。 ユニバーサル リソース識別子 (URI) クエリは、動的ページにのみ必要です。 UriQuery HTTP_LOG_FIELD_URI_QUERY
サーバー ポート s-port サービス用に構成されているサーバー ポート番号。 ServerPort HTTP_LOG_FIELD_SERVER_PORT
[ユーザー名] cs-username サーバーにアクセスした認証済みユーザーの名前。 匿名ユーザーはハイフンで示されます。 UserName HTTP_LOG_FIELD_USER_NAME
Client IP Address (現在の IP アドレス) c-ip 要求を行ったクライアントの IP アドレス。 ClientIp HTTP_LOG_FIELD_CLIENT_IP
プロトコルのバージョン cs-version クライアントが使用した HTTP プロトコルのバージョン。 HTTP サーバー API が生成されました。 HTTP_LOG_FIELD_VERSION
ユーザー エージェント cs(User-Agent) クライアントで使用されたブラウザーの種類。 UserAgent HTTP_LOG_FIELD_USER_AGENT
クッキー cs(Cookie) 送受信された Cookie の内容 (存在する場合)。 クッキー HTTP_LOG_FIELD_COOKIE
Referrer cs(Referrer) ユーザーが最後にアクセスしたサイト。 現在のサイトへのリンクを提供したサイト Referrer HTTP_LOG_FIELD_REFERRER
Host cs-host ホスト ヘッダー名 (存在する場合)。 Host HTTP_LOG_FIELD_HOST
HTTP の状態 sc-status HTTP 状態コード。 ProtocolStatus HTTP_LOG_FIELD_STATUS
Protocol Substatus sc-substatus substatus エラー コード。 SubStatus HTTP_LOG_FIELD_SUB_STATUS
Win32 の状態 sc-win32-status Windows 状態コード。 Win32Status HTTP_LOG_FIELD_WIN32_STATUS
送信バイト数 sc-bytes サーバーによって送信されたバイト数。 HTTP サーバー API が生成されました。 HTTP_LOG_FIELD_BYTES_SENT
受信バイト数 cs-bytes サーバーによって受信および処理されたバイト数。 HTTP サーバー API が生成されました。 HTTP_LOG_FIELD_BYTES_RECV
所要時間 時間の取得 アクションにかかった時間の長さ (ミリ秒単位)。 HTTP サーバー API が生成されました。 HTTP_LOG_FIELD_TIME_TAKEN
ストリーム ID streamid ストリーム ID。 HTTP サーバー API が生成されました。 HTTP_LOG_FIELD_STREAM_ID

 

ログ ファイルは、カスタマイズ可能な ASCII テキスト ベースの形式です。 ファイル内のフィールド プレフィックスは、次のように定義されます。

Prefix 説明
s サーバー アクション。
c クライアント アクション。
Sc サーバーからクライアントへのアクション。
cs クライアントからサーバーへのアクション。

 

アプリケーションでは、1 つ以上の W3C 拡張ログ ファイル フィールドを選択できますが、すべてのフィールドに情報が含まれているわけではありません。 選択されているが情報がないフィールドの場合は、プレースホルダーとしてハイフン (-) が表示されます。 フィールドに印刷できない文字が含まれている場合、HTTP Server API はログ ファイル形式を保持するためにプラス記号 (+) に置き換えます。 これは通常、ウイルス攻撃で発生します。たとえば、悪意のあるユーザーがキャリッジ リターンを送信し、改行をプラス記号 (+) に置き換えない場合にログ ファイル形式が破損する場合です。 フィールドはスペースで区切られます。

URL グループまたはサーバー セッションでフィールドが有効になっているが、要求に対して選択されていない場合、フィールドはプレースホルダーとしてハイフン (-) でログ ファイルに表示されます。

ログ ファイルは、最初の要求が URL グループまたはサーバー セッションに到着したときに作成され、ログ記録が構成されている場合は作成されません。 次の例は、クライアント IP、ユーザー名、サーバー IP、サーバー ポート、メソッド、URI Stem、URI クエリ、状態、およびユーザー エージェント フィールドが有効になっている W3C ログ ファイルの最初のログ ファイル エントリを示しています。

#Software: Microsoft HTTP Server API 2.0  
#Version: 1.0   // the log file version as it's described by "https://www.w3.org/TR/WD-logfile".
#Date: 2002-05-02 17:42:15  // when the first log file entry was recorded, which is when the entire log file was created.
#Fields: date time c-ip cs-username s-ip s-port cs-method cs-uri-stem cs-uri-query sc-status cs(User-Agent)
2002-05-02 17:42:15 172.22.255.255 - 172.30.255.255 80 GET /images/picture.jpg - 200 Mozilla/4.0+(compatible;MSIE+5.5;+Windows+2000+Server)

取得時間フィールドは、要求が解析される前に、HTTP Server API が最初のバイトを受信したときに初期化されます。 最後の送信完了が発生すると、時間がかかったタイムスタンプが停止します。 所要時間は、ネットワーク全体の時間を反映しません。 サイトへの最初の要求では、HTTP Server API が最初の要求でログ ファイルを開くので、他の同様の要求よりも少し長い時間がかかります。