技術情報

Matomoのアプリケーションログを見るには?

Matomo アプリケーションログは、Matomo が書き込むメッセージです。

LogViewerプラグインをインストールすることでログを見ることができます。
プラグインはMatomo・マーケットプレイスからインストールできます。
スーパーユーザーとしてAdministrationに行き、左のメニューからMarketplaceを選択してください。
そこでプラグインを見つけ、ワンクリックでインストールできます。

このプラグインは、何らかの問題が発生し、Matomoのインストールをトラブルシューティングしたい場合、例えば、トラッキングリクエストが正しく処理されない場合などに役立ちます。

LogViewer plugin

Matomoでロギングを設定する

デフォルトでは、ログはスクリーンにのみ書き込まれるため、MatomoはLogViewerプラグインに何も表示しません。実際にログを表示するには、以下のどちらかを有効にする必要があります。fileまたはdatabaseまたはerrorlogerror_log()php関数を使用したログ)またはsyslog(syslogサービスへのログ)のいずれかを有効にする必要があります。

databaseログライターは、Matomoのインストールに複数のサーバを使用する場合に推奨されます。

この詳細についてはよくある質問:
Matomoでロギングを有効にするにはどうすればよいですか?
.

ほとんどの場合、config/config.ini.phpファイルに以下の行を追加するだけで十分です:

[log]
    log_writers[] = file
    

Matomo のアプリケーションログは次の場所にあります。piwik/tmp/logs/matomo.log.

ログメッセージが表示されない場合は、まだ警告やエラーが発生していないだけかもしれません。以下の行を[log]セクションに追加することでログレベルをあげることができます:

log_level = DEBUG
    

Matomo Trackerのロギングを有効にする

Matomo Tracker API (piwik.php)が実際にメッセージをログに記録するには、追加の設定が必要です。piwik.phpのトラッカーでデバックログを有効にする方法についてはpiwik.phpトラッカーでデバッグ・ロギングを有効にするを参照してください。

LogViewerプラグインの使用

ロギングが設定されると、Administrationに行き、DiagnosticセクションからLogViewerを選択することで、スーパーユーザーとしてログに記録されたメッセージを見ることができます。

ログメッセージの検索、ログレベルによるフィルタリング、ファイルとデータベースライターの切り替え、ログメッセージのエクスポートができます。便利なのは、カラムをクリックして表示されるメッセージを絞り込めることです。例えばRequestIdをクリックすると、同じリクエスト中にログに記録されたすべてのメッセージを見ることができます。