chrome-visits

Chrome ブラウザのHistory SQLite データベースファイルを解析して Web サイトの訪問履歴を取得します。訪問したページの URL、タイトル、訪問回数、直接入力回数などを構造化されたフィールドとして変換して出力します。

コマンドプロパティ

項目説明
コマンドタイプドライバークエリ
必要な権限なし
ライセンス使用量集計あり
並列実行非対応
分散実行データノードで実行（mapper）

構文

chrome-visits [zippath=STR] [zipcharset=STR] FILE_PATH

オプション

zippath=STR
History ファイルが含まれる ZIP ファイルのパス。ZIP ファイル内部の History ファイルを直接取得する際に使用します。
zipcharset=STR
ZIP ファイルエントリの文字セット（デフォルト: utf-8）。

対象

FILE_PATH
取得する Chrome ブラウザのHistory SQLite ファイルのパス。ワイルドカード（*）を使用して複数のファイルを指定できます。Chrome ブラウザの History ファイルは通常C:\Users\<username>\AppData\Local\Google\Chrome\User Data\Default\Historyにあります。

出力フィールド

フィールドタイプ説明
_timetimestamp訪問日時
titlestring訪問した Web ページのタイトル
visit_countlongその URL の総訪問回数
typed_countlongアドレスバーに直接 URL を入力して訪問した回数
hiddenboolean非表示訪問かどうか。true: iframe などによる間接訪問、false: 直接訪問
urlstring訪問した Web ページの URL

エラーコード

パースエラー

該当なし

ランタイムエラー
エラーコードメッセージ説明後処理動作
-cannot load chrome history database: パス指定したパスの History ファイルを読み取れない場合クエリ実行を中断

説明

chrome-visitsコマンドは、Chrome ブラウザのHistory SQLite データベースファイルのurlsテーブルとvisitsテーブルを読み取って Web サイトの訪問履歴を取得します。

コマンドはまずurlsテーブルで URL、タイトル、訪問回数、直接入力回数、非表示フラグのマッピングを構成した後、visitsテーブルの各レコードに該当する URL 情報を結合して出力します。visitsテーブルの1行が1件の訪問履歴に対応します。

_timeフィールドはvisitsテーブルのvisit_timeカラムから Chrome 内部の WebKit タイムスタンプ（マイクロ秒単位）を日付タイプに変換して割り当てます。

hiddenフィールドはurlsテーブルのhiddenカラム値が1の場合はtrue、0の場合はfalseを返します。iframe などを通じた間接訪問が非表示訪問に該当します。

ZIP ファイル内部の History ファイルを取得するには、zippathオプションに ZIP ファイルのパスを指定し、対象に ZIP 内部のファイルパスを指定します。

使用例

  1. Chrome 訪問履歴を取得

    chrome-visits /opt/logpresso/evidence/History

    指定したパスのHistoryファイルからすべての訪問履歴を取得します。

  2. ZIP ファイル内部の History ファイルを取得

    chrome-visits zippath=/opt/logpresso/evidence/artifacts.zip History

    ZIP ファイル内部のHistoryファイルから訪問履歴を取得します。

  3. 直接入力で訪問した履歴をフィルタリング

    chrome-visits /opt/logpresso/evidence/History
| search typed_count > 0

    アドレスバーに直接 URL を入力して訪問した履歴のみフィルタリングします。

  4. 訪問回数の多い上位 URL を取得

    chrome-visits /opt/logpresso/evidence/History
| stats max(visit_count) as visit_count by url
| sort -visit_count
| limit 20

    訪問回数が多い上位 20 件の URL を取得します。