Show Menu
トピック×

イベントデータレコードフィールド

データセットを構築する際に Data Workbench サーバーで処理できるデータフィールドについて取り上げます。

イベントデータについて

データセット構築用のイベントデータは、ログソースと呼ばれるファイル内に存在します。各データレコードが 1 件のトランザクションレコード、またはタイムスタンプを持った 1 回のイベントの発生を表していることから、ログソース内のデータは「イベントデータ」と呼ばれます。
A log source's event data is collected in real-time by Sensors. Event data collected by Sensors from HTTP and application servers is transmitted to data workbench servers, which convert the data into compressed log ( .vsl) files. フラットファイル、XML ファイルまたは ODBC データソースに存在するイベントデータを読み取る Data Workbench サーバーは、こうした様々な形式のファイルから決まった一連のデータフィールドを抽出するよう設定されたデコーダーの役割を担います。
The following sections provide information about the data fields (referred to as event data record fields or log entry fields ) that are collected by Sensors or read and made available to the data workbench server.
フィールドの名前は、通常、W3C拡張ログファイル形式の命名規則に従います。 多くのフィールドには、その情報の取得元を表すプレフィックスが付いています。
  • cs は、クライアントからサーバーへの通信を表します。
  • sc は、サーバーからクライアントへの通信を表します。
  • s は、サーバーからの情報を表します。
  • c は、クライアントからの情報を表します。
  • x は、アドビのソフトウェア製品によって生成された情報であることを表します。

ベースラインイベントデータレコードフィールド

Log ( .vsl) files contain the fields of event data that are collected from servers by Sensors and used by the data workbench server in the dataset construction process. 次の表は、Sensor によって記録される代表的なイベントデータレコードのフィールドの一覧です。
フィールド 説明
c-ip
サーバーに対して送信されたリクエストに含まれているクライアントの IP アドレス。
例:207.68.146.68
cs(cookie)
クライアントによってリクエストとともに送信された cookie。
例:v1st=42FDF66DE610CF36; ASPSESSIONIDQCATDAQC=GPIBKEIBFBFIPLOJMKCAAEPM;
cs(referrer)
クライアントによってリクエストとともにサーバーに送信された HTTP リファラー文字列。
例: http://www.mysite.net/cgi-bin/websearch?qry
cs(user-agent)
クライアントによってリクエストとともにサーバーに送信された文字列。そのクライアントに該当するユーザーエージェントのタイプを表します。
例:Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7) Gecko/20040707 Firefox/0.9.2
cs-method
HTTP リクエストのメソッドのタイプ。
例:GET
リファレンス: http://www.w3.org/TR/2000/NOTE-shoplogfileformat-20001115/#field_method
cs-uri-query
URI のクエリー文字列部分(ステム + クエリー文字列 = URI)。疑問符(?)で始まり、名前と値のペアを含んでいる場合もあります。複数のペアが含まれている場合は、アンパサンド(&)で区切って指定されます。
例:page=homepage
cs-uri-stem
URI のステム部分(ステム + クエリー文字列= URI)。ステムは、サーバー上の要求されたリソースに対する実際のパスまたは論理パスです。
例: /index.asp
sc(content-type)
クライアントから要求されているとしてサーバーが報告したリソースのコンテンツタイプ。
例:text/html、image/png、image/gif、video/mpeg
sc-bytes
リクエストへの応答としてサーバーからクライアントに送信されたデータのバイト数。
例:4996
sc-status
サーバーからクライアントに返されたステータスコード。
例:200
リファレンス: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
s-dns
要求されたリソースのホストの完全修飾ドメイン名または IP アドレス。
例: www.adobe.com
x-experiment
リクエストの時点でクライアントが属しているすべての制御実験の名前とグループのリスト。
例:VSHome_Exp.Group_1,VSRegistration_Exp.Group_2
x-timestamp
リクエストがサーバーによって受信された日付と時刻(GMT)。時刻は、1600 年 1 月 1 日からの 100 ナノ秒数で表されます。
例:2005 年 9 月 13 日 火曜日 11:28:52.0000000 の場合、x-timestamp 値は 127710989320000000 となります。
x-trackingid
持続 Cookie に検出されたブラウザーの一意識別子を表す 64 ビットの 16 進数値。 Sensor によって設定され、サーバーへのリクエストとともにクライアントから提供されます。
例:42FDF66DE610CF36

派生フィールド

次の表は、ベースラインイベントデータレコードのフィールドから Data Workbench サーバーが生成する派生フィールドの例を示しています。
フィールド 説明
cs(cookie)(name) cookie に含まれる特定の名前と値のペアの値。
cs(referrer-domain)
HTTP 参照元 URI のドメイン名または IP アドレス。
注意:このフィールドは読み取り専用です。
cs(referrer-host)
リファラーのホスト名全体。
例:cs(referrer) が http://my.domain.com/my/page である場合、cs(referrer-host) は my.domain.com になります。
cs(referrer-query)(name)
リファラークエリー文字列の値。
注意:cs(referrer)(name) フィールドを使用して、リファラークエリー文字列の値にアクセスすることはできません。
cs-uri
完全な URI(ステム + クエリー文字列 = URI 全体)。
例: /shopping/checkout.html?product1=8Track&product2=casette&product3=cd
cs-uri-query(name)
指定された名前に関連付けられている値。指定された名前に対して複数の値が存在する場合、その中の最後の値が返されます。
例:
  • /shopping/checkout.html?product1=8Track&product2=casette&product3=cd という URI に対し、cs-uri-query(product3) からは「cd」が返されます。
  • /shopping/checkout.html?product1=8Track&product1=casette という URI に対し、 cs-uri-query(product1) からは「casette」が返されます。
ctime 1970 年 1 月 1 日からの秒数で表される x-timestamp。このフィールドは、x-unixtime と呼ばれることもあります。
date YYYY-MM-DD 形式の x-timestamp。
time HH:MM:SS 形式の x-timestamp。
x-local-timestring
データセットの Transformation.cfg ファイルに指定されたローカルタイムゾーンに変換した x-timestamp。YYYY-MM-DD HH:MM:SS.mmm という形式になります。
注意: Log Processing.cfg ファイルで時刻変換(x-local-timestring など)を定義することもできます。詳しくは、ログ処理設定フ ァイルを参照してくださ い。
x-log-source-id
特定のログエントリのログソースに対応する識別子。この識別子を記録するためには、 Sensor 、ログファイルまたは ODBC データソースを定義するときに、 Log Processing.cfg ファイルの Log Source ID フィールドに識別子を指定する必要があります。詳しくは、ログ処理設定ファ イルを参照してくださ い。
例:from VSensor01
x-mask Sensor データソースのマスクパターン( .vsl ファイル名から派生)。名前の形式が YYYYMMDD-SENSORID.VSL であるファイルの x-mask は SENSORID になります。
x-timestring YYYY-MM-DD HH:MM:SS.mmm 形式の x-timestamp。
x-unixtime x-timestamp から派生した 10 進数の UNIX 時間。
サーバー上の Sensor は、有効な HTTP リクエスト(または応答)ヘッダーから、またはサーバーの API を介して提供される変数から、イベントデータのフィールドを収集することができます。こうしたデータフィールドを収集するには、txlogd.conf の Sensor 設定ファイルに目的のヘッダーフィールドまたは変数を指定する必要があります。詳しくは、『 Data WorkbenchSensorガイド 』を参照してください。