NSPR_LOG_MODULES

此环境变量指定哪些日志模块已启用日志记录。

语法

moduleName:level[, moduleName:level]*

moduleName 是在 :ref:`PR_NewLogModule <http://www-archive.mozilla.org/projects/nspr/reference/html/prlog.html#25372>`__ 调用中指定的名称，或下面列出的便捷的魔术名称之一。

level 是 0 到 5 之间的数值，这些值具有以下含义

  • 0 = PR_LOG_NONE: 不应记录任何内容

  • 1 = PR_LOG_ALWAYS: 重要；旨在始终记录

  • 2 = PR_LOG_ERROR: 错误

  • 3 = PR_LOG_WARNING: 警告

  • 4 = PR_LOG_DEBUG: 调试消息，通知

  • 5: 所有内容！

描述

指定与对 :ref:`PR_NewLogModule <http://www-archive.mozilla.org/projects/nspr/reference/html/prlog.html#25372>`__ 的调用中的 name 参数关联的 moduleName 和一个非零 level 值，以启用对指定 moduleName 的日志记录。

提供了用于在运行时控制 NSPR 日志服务的特殊日志模块名称。这些控件应在执行时在 NSPR_LOG_MODULES 环境变量中设置，以影响应用程序的 NSPR 日志服务。

  • all 名称 all 启用所有日志模块。要启用对 `PR_LOG <http://www-archive.mozilla.org/projects/nspr/reference/html/prlog.html#25497>`__ 的所有日志模块调用，请按如下方式设置变量

    set NSPR_LOG_MODULES=all:5

  • timestamp 包含 timestamp 会导致每行日志前面都加上“2015-01-15 21:24:26.049906 UTC - “ 形式的时间戳。

  • append 包含 append 会导致日志条目追加到 NSPR_LOG_FILE 引用的文件的现有内容中。如果未指定，则在创建具有相同文件名的文件时，将丢失 NSPR_LOG_FILE 的现有内容。

  • sync 名称 sync 启用无缓冲日志记录。这确保所有日志消息在写入时都刷新到操作系统，但这可能会降低程序速度。

  • bufsize:size 名称 bufsize:size 将日志缓冲区设置为 size。

示例

记录 Toolkit::Storage 组件中发生的所有事件，并在将每个事件记录到文件 /tmp/foo.log 时在每行前面加上时间戳（每次执行可执行文件时都会替换此文件）。

set NSPR_LOG_MODULES=timestamp,mozStorage:5
set NSPR_LOG_FILE=/tmp/foo.log

使用 Try Server 进行日志记录

  • 对于 mochitest，在推送到 try 之前，编辑 testing/mochitest/runtests.py 中的变量 NSPR_LOG_MODULES。您将能够从日志查看器下载日志文件作为工件。

  • （其他测试？）