Technical Documentation

技術文書

Matomoに関する技術文書

Matomoへのトラフィックを再生し、matomo.php(またはpiwik.php)リクエストのログを取り込むにはどうすればいいですか?

Log Analytics では、あらゆるウェブサーバーのログファイルをインポートすることができます。この FAQ では、Matomo でインポートすると便利なログの 1 つ、Matomo トラッキング API ログに焦点を当てます。

Matomo Tracking APIのログとは何ですか?

ユーザーがあなたのウェブサイトを訪問すると、MatomoJavaScriptトラッキングコードはmatomo.php(またはpiwik.php) Tracking APIエンドポイントにHTTP(S)リクエストを送信します。もしモバイルアプリやゲーム、デスクトップアプリを測定するために、APIクライアントのトラッキングを使用している場合、それらもmatomo.php(またはpiwik.php)にリクエストを送信します。これらのリクエストを処理するウェブサーバは、Matomo がデータベースに収集するトラッキングデータを含むアクセスログファイルを作成します。

以下にアクセスログの例を示します:

12.10.30.51 - - [03/Feb/2020:16:40:31 +1300] "GET /matomo.php?idsite=1&rec=1&urlref=https://www...................... HTTP/1.1" 200 256 "-" "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:72.0) Gecko/20100101 Firefox/72.0"

ログ再生の用途

ログの再生は、例えばデータベースサーバーが故障し、Matomoが数時間データを書き込めなかった場合などに非常に便利です。幸運なことに、/matomo.php(または/piwik.php)にマッチするウェブサーバのログを使用してMatomoに再生することができます。ログを再生するということはログ分析ツールはログの各行を調べ、過去の正しい日付のMatomoにインポートするということです。ログの再生は、高可用性 Matomo.をセットアップしたい場合にも便利です。

トラッキングAPIのログを再生するには?手順

1) まず、インポートすべきリクエストだけを含むログファイルを準備します。通常、一定期間のみインポートします。これらのログでは、リクエストURLはすべてmatomo.phpまたはpiwik.php.で始まっています。これらは次に再生できるリクエストです。

2) 次に、ファイル内のすべてのリクエストが時系列にソートされている ことを確認します。これは、異なるログファイルからデータをマージした場合に特に重要です。その後、ログファイルを日付時間フィールドで並べることが重要です。

3) 最後に、トラッキングAPIのログを再生するには、ログアナリティクスインポーターに--replay-trackingパラメーターがあります:

./misc/log-analytics/import_logs.py --url=piwik.example.net --replay-tracking /var/log/apache2/access.log 

4) ログを再生した後、core:archiveコンソールコマンドでデータの再処理することをお勧めします。

これが完了したら、おめでとうございます。これで、消えたウェブ解析データの復旧は完了です!

ログ再生の限界

ログを再生する場合、ほとんどのログデータは期待通りに再生されます(訪問、ページビュー、ゴール、eコマーストランザクションなど)が、再生されないトラッキングリクエストがいくつかあるかもしれません:特に、POSTリクエストであるログエントリは再生されません(POSTリクエストパラメータはアクセスログファイルに保存されないため)。

Matomo JavaScript トラッカーは、フォームアナリティクス、メディアアナリティクス、ヒートマップ、ハートビートタイマーを使用している場合、POST リクエストを使用する可能性が高くなります。

 

オンラインデモを体験

面倒なアカウント登録や
サーバーへのインストールは一切不要です。
実際の解析データを反映した管理画面で、
Matomoの快適な操作感を
今すぐ体験できます。

matomo画面
※Matomo Cloudは
Matomo開発元である
InnoCraft社が
提供するサービスです。
matomo画面

法人向け導入運用サポート

導入から運用まで 完全支援

Matomoユーザー会では、法人・団体向けにMatomoの導入から運用までの技術支援を行っています。
必要なサービスだけを組み合わせてご利用いただけます。

導入・運用支援

初期構築をお任せ

要件の整理から環境構築、導入直後の調整まで、必要な作業をまとめてお任せいただけます。

  • 要件整理・ヒアリング
  • 環境構築・インストール
  • パフォーマンス調整

matomo保守

導入後も安心の保守

操作や設定のご相談から、バージョンアップや性能改善までを継続的に支援します。

  • お問い合わせ対応
  • バージョンアップ対応
  • 性能・障害の調査対応

サーバ保守

サーバ稼働もお任せ

Matomoが動作するサーバを監視し、障害時も含めて計測を止めない状態を維持します。

  • 死活・リソース監視
  • 障害の一次・二次対応
  • 24時間365日の対応

オプション

必要な分だけ依頼

ご契約の有無にかかわらず、必要な作業だけを単発でご依頼いただけます。

  • トレーニング・設定代行
  • マニュアル・運用設計
  • データ移行
法人導入のご相談はお気軽にお問い合わせください。

要件整理・見積もり・PoC環境提供まで無償で対応いたします。