この環境変数はどのlogモジュールでlogの取得が有効化されるのかを指定します。
構文
moduleName:level[, moduleName:level]*
moduleName は PR_NewLogModule の呼び出しで指定される名前か、あるいは、下記のリストにある別名のいずれかです。
level は0から5までの以下の意味を持つ値を指定します。
- 0 = PR_LOG_NONE: logを取りません
- 1 = PR_LOG_ALWAYS: 重要。全てのlogを取ることを意図しています。
- 2 = PR_LOG_ERROR: errors
- 3 = PR_LOG_WARNING: warnings
- 4 = PR_LOG_DEBUG: デバッグメッセージ、注意
- 5: 全部取ります！
説明
PR_NewLogModule 呼び出しの name 引数に関連した moduleNameと、0以外のレベルを指定することで moduleName の log を有効化します。
実行時にNSPRのlogサービスを制御するために、特別な log モジュール名が提供されています。これらの制御は実行時にNSPR_LOG_MODULES環境変数に設定された場合に、あなたのアプリケーションに関係する NSPR の log サービスに影響を与えます。
- all 全てのlogモジュールを有効化します。PR_LOGの呼び出しで全てのlogモジュールを有効にするには、下記のように変数をセットします。
set NSPR_LOG_MODULES=all:5
- timestamp 結果の各行の先頭に "2015-01-15 21:24:26.049906 UTC - "のような形式のタイムスタンプをつけます。
- append NSPR_LOG_FILEに参照される現存するファイルにのlogエントリーを追加します。もし指定されていないと、現在存在するNSPR_LOG_FILEの内容は書き換えられ、同じ名前で新しいファイルになります。
- sync バッファ無しでのログ取得を有効にします。これは全てのlogメッセージが書き込まれるようにOSでflushされることを保証しますが、プログラムの実行が遅くなる場合があります。
- bufsize:size logのバッファサイズを sizeにします。
例
Toolkit::Storage コンポーネントに起こったことすべてを記録します。各行の先頭にタイムスタンプを付け、ログは /tmp/foo.log に記録されます。(ログファイルは実行ファイルが実行されるたびに書き換えられます。)
set NSPR_LOG_MODULES=timestamp,mozStorage:5 set NSPR_LOG_FILE=/tmp/foo.log
試験サーバでのログ取得
- mochitest では、
testing/mochitest/runtests.py ファイル内のNSPR_LOG_MODULESを編集し、試験サーバにプッシュします。ログファイルのダウンロードは、 ログビュアーより artifact として行います。 - (その他のテスト?)