logging.html

Sun Java System Application Server Enterprise Edition 8.1 管理指南

<a name="wp952105"> </a><div class="pSmartList2"><li>要为将来的实例（使用 <code class="cCode">default-config</code> 的副本）配置默认设置，请选择 <code class="cCode">default-config</code> 节点。</li></div>
</ol></div>
<a name="wp952107"> </a><div class="pSmartList1"><li>对于节点代理，请选择“日志程序设置”选项卡。对于配置，请选择“日志程序设置”节点。</li></div>
<a name="wp952109"> </a><div class="pSmartList1"><li>在“日志设置”页面中，可以使用以下字段来自定义日志：</li></div>
<div class="pSmartList2"><ul class="pSmartList2">
<a name="wp952111"> </a><div class="pSmartList2"><li><b class="cBold">日志文件</b>：要为服务器日志文件指定替代名称或位置，请在文本字段中键入新的路径名。默认情况下，该位置为 <em class="cEmphasis">domain_root_dir</em><code class="cCode">/</code><em class="cEmphasis">domain_dir</em><code class="cCode">/logs/server.log</code>。</li></div>
<a name="wp952113"> </a><div class="pSmartList2"><li><b class="cBold">警报</b>：要通过 JMX 框架路由 <code class="cCode">SEVERE</code> 和 <code class="cCode">WARNING</code> 消息，请选中“已启用”复选框。</li></div>
<a name="wp952115"> </a><div class="pSmartList2"><li><b class="cBold">写入系统日志</b>：仅在 Solaris 和 Linux 系统中，如果要将日志输出发送到服务器日志和 <code class="cCode">syslog</code> 工具，请选中“已启用”复选框。</li></div>
<a name="wp952121"> </a><div class="pSmartList2"><li><b class="cBold">日志处理程序</b>：要将日志发送到 <code class="cCode">server.log</code> 或 <code class="cCode">syslog</code> 以外的目标，您可以插入自定义日志处理程序。自定义处理程序必须扩展 <code class="cCode">java.util.logging.Handler</code> 类（JSR 047 兼容 API）。在“日志处理程序”字段中键入处理程序的绝对类名。还应将处理程序类置于 Application Server 类路径中，以便在服务器启动过程中安装该处理程序。自定义处理程序的日志记录具有在<a  href="logging.html#wp951978" tppabs="http://docs.sun.com/source/819-1553/logging.html#wp951978">日志记录</a>中说明的格式。</li></div>
<a name="wp952123"> </a><div class="pSmartList2"><li><b class="cBold">日志过滤器</b>：要过滤发送给目标（如 <code class="cCode">server.log</code>、<code class="cCode">syslog</code> 或由自定义日志处理程序指定的目标）的日志记录，可以插入自定义日志过滤器。该自定义过滤器必须实现接口 <code class="cCode">java.util.logging.Filter</code>。在“日志过滤器”字段中键入过滤器的绝对类名。还应将过滤器类置于 Application Server 类路径中，以便在服务器启动过程中安装该过滤器。</li></div>
<a name="wp952125"> </a><div class="pSmartList2"><li><b class="cBold">文件轮转限制</b>：如果服务器日志的字节数达到了指定大小，请创建一个名为 <code class="cCode">server.log</code> 的新的空文件，并将旧文件重命名为 <code class="cCode">server.log_</code><em class="cEmphasis">date</em>，其中 <em class="cEmphasis">date</em> 是轮转文件的日期和时间。默认值为 2 兆字节。该限制的最小值为 500 千字节；如果指定较低的值，则要在达到 500 千字节时该文件才轮转。要关闭日志文件轮转，请将该值设置为 0。</li></div>
<a name="wp952127"> </a><div class="pSmartList2"><li><b class="cBold">文件轮转时间限制</b>：达到指定的分钟数之后才轮转服务器日志。默认值为零，这表示文件达到“文件轮转限制”字段中指定的大小即被轮转。<em class="cEmphasis">如果指定了非零的时间限制，则该时间限制优先于大小限制。</em></li></div>
</ul></div>
<a name="wp952129"> </a><div class="pSmartList1"><li>单击“保存”以保存更改。单击“查看日志文件”查看服务器日志。</li></div>
</ol></div>
<a name="wp952165"> </a><h3 class="pHeading2">
配置日志级别
</h3>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp952173"> </a><div class="pSmartList1"><li>在树组件中，展开“节点代理”节点或“配置”节点。</li></div>
<a name="wp952175"> </a><div class="pSmartList1"><li>选择节点代理，或者选择要配置的实例：</li></div>
<div class="pSmartList2"><ol type="a" class="pSmartList2">
<a name="wp952177"> </a><div class="pSmartList2"><li>要配置特定的实例，请选择该实例的配置节点。例如，对于默认实例 <code class="cCode">server</code>，请选择 <code class="cCode">server-config</code> 节点。</li></div>
<a name="wp952179"> </a><div class="pSmartList2"><li>要为将来的实例（使用 <code class="cCode">default-config</code> 的副本）配置默认设置，请选择 <code class="cCode">default-config</code> 节点。</li></div>
</ol></div>
<a name="wp952181"> </a><div class="pSmartList1"><li>对于节点代理，请选择“日志级别”选项卡。对于配置，请选择“日志程序设置”节点，然后选择“日志级别”选项卡。</li></div>
<a name="wp952183"> </a><div class="pSmartList1"><li>在“模块日志级别”页面中，请从要更改日志级别的一个或多个模块对应的下拉式列表中选择一个新值。默认级别为 <code class="cCode">INFO</code>，表示处于该级别或更高级别（<code class="cCode">WARNING</code>、<code class="cCode">SEVERE</code>）的消息将显示在日志中。可以选择以下任一值（以最高级别至最低级别的顺序列出）：</li></div>
<div class="pSmartList2"><ul class="pSmartList2">
<a name="wp952185"> </a><div class="pSmartList2"><li><code class="cCode">SEVERE</code></li></div>
<a name="wp952187"> </a><div class="pSmartList2"><li><code class="cCode">WARNING</code></li></div>
<a name="wp952189"> </a><div class="pSmartList2"><li><code class="cCode">INFO</code></li></div>
<a name="wp952191"> </a><div class="pSmartList2"><li><code class="cCode">CONFIG</code></li></div>
<a name="wp952193"> </a><div class="pSmartList2"><li><code class="cCode">FINE</code></li></div>
<a name="wp952195"> </a><div class="pSmartList2"><li><code class="cCode">FINER</code></li></div>
<a name="wp952197"> </a><div class="pSmartList2"><li><code class="cCode">FINEST</code></li></div>
<a name="wp952199"> </a><div class="pSmartList2"><li><code class="cCode">OFF</code></li></div>
</ul></div>
<a name="wp952201"> </a><div class="pSmartList1"><li>使用“其他属性”区域可以为任何应用程序日志程序配置日志级别。属性名是日志程序名称空间，其值为上述八个可能的级别之一。例如，属性名称可为 <code class="cCode">samples.logging.simple.servlet</code>，值可为 <code class="cCode">FINE</code>。</li></div>
<a name="wp952203"> </a><p class="pStepParaI1">
还可以使用此区域来更改子模块的日志级别，例如 CORBA 模块的传输子模块：
</p>
<a name="wp952205"> </a><code class="pCodelineIndent">
javax.enterprise.resource.corba.<em class="cEmphasis">ORBId</em>.transport
</code>
<a name="wp952207"> </a><div class="pSmartList1"><li>单击“保存”以保存更改，或者单击“装入默认值”以恢复默认值。</li></div>
</ol></div>
<a name="wp952209"> </a><p class="pParagraph">
对 <code class="cCode">System.out.println</code> 的调用均在 <code class="cCode">INFO</code> 级别使用日志程序名称 <code class="cCode">javax.enterprise.system.stream.out</code> 予以记录。对 <code class="cCode">System.err.println</code> 的调用均在 <code class="cCode">WARNING</code> 级别使用日志程序名称 <code class="cCode">javax.enterprise.system.stream.err</code> 予以记录。要从这些源关闭日志，请在“其他属性”区域中将日志程序名称的值指定为 <code class="cCode">OFF</code>。
</p>
<a name="wp952211"> </a><p class="pParagraph">
对日志级别设置所做的更改将立即生效。同时将在 <code class="cCode">domain.xml</code> 文件中保存这些更改，以供服务器重新启动时使用。
</p>
<a name="wp952245"> </a><h3 class="pHeading2">
查看服务器日志
</h3>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp952253"> </a><div class="pSmartList1"><li>在树组件中，展开要查看其日志的服务器实例的节点。</li></div>
<a name="wp952255"> </a><div class="pSmartList1"><li>在“常规信息”页面中，单击“查看日志文件”。</li></div>
</ol></div>
<a name="wp952257"> </a><p class="pParagraph">
使用“搜索条件”区域自定义和过滤日志查看器。使用如下所示的基本字段：
</p>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp952259"> </a><div class="pSmartList1"><li><b class="cBold">实例名称</b>：从下拉式列表中选择一个实例名称，以查看该服务器实例的日志。默认值为当前服务器实例。</li></div>
<a name="wp952261"> </a><div class="pSmartList1"><li><b class="cBold">日志文件</b>：从下拉式列表中选择一个日志文件名称，以查看该日志的内容。默认名称为 <code class="cCode">server.log</code>。</li></div>
<a name="wp952263"> </a><div class="pSmartList1"><li><b class="cBold">时间戳</b>：要查看最新的消息，请选择“最近”（默认值）。如果只查看特定时间段内的消息，请选择“特定范围”并在显示的“从”字段和“到”字段中键入日期和时间值。对于时间值，其语法必须采用以下格式（<em class="cEmphasis">SSS</em> 表示毫秒）：</li></div>
<a name="wp952265"> </a><code class="pCodelineIndent">
<em class="cEmphasis">hh</em>:<em class="cEmphasis">mm</em>:<em class="cEmphasis">ss</em>.<em class="cEmphasis">SSS</em>
</code>
</ul></div>
<div class="pParaIndent1"><ul class="pParaIndent1">
<a name="wp952267"> </a><p class="pParaIndent1">
例如：
</p>
<a name="wp952269"> </a><code class="pCodelineIndent">
17:10:00.000
</code>
<a name="wp952271"> </a><p class="pParaIndent1">
如果“从”字段中的时间值迟于“到”字段中的时间值，将显示错误消息。
</p>
</ul></div>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp952273"> </a><div class="pSmartList1"><li><b class="cBold">日志级别</b>：要按照日志级别过滤消息，请从下拉式列表中选择一种日志级别。默认情况下，将显示服务器日志中选定日志级别和更高日志级别的所有消息。选中标有“不包括更高级别的消息”的复选框将仅显示所选级别的消息。</li></div>
</ul></div>
<div class="pParaIndent1"><ul class="pParaIndent1">
<a name="wp952279"> </a><p class="pParaIndent1">
为确保您要查看的消息都显示在服务器日志中，请先在“日志级别”页面中设置适当的日志级别。请参见<a  href="logging.html#wp952165" tppabs="http://docs.sun.com/source/819-1553/logging.html#wp952165">配置日志级别</a>。 
</p>
<a name="wp952281"> </a><p class="pParaIndent1">
如果您选择基于日志级别过滤日志消息，则将只显示符合指定过滤条件的消息。不过，这种过滤不影响那些记录到服务器日志中的消息。 
</p>
</ul></div>
<a name="wp952283"> </a><p class="pParagraph">
将显示服务器日志中最新的 40 个条目以及在“日志记录设置”和“日志级别”页面中指定的设置。
</p>
<a name="wp952285"> </a><p class="pParagraph">
单击“时间戳”标题旁边的三角形对这些消息进行排序，以使最新的消息显示在最后。
</p>
<a name="wp952287"> </a><p class="pParagraph">
要查看任何消息的格式化版本，请单击标记的链接
</p>
<a name="wp952289"> </a><code class="pCodeline">
(details)
</code>
<a name="wp952291"> </a><p class="pParagraph">
将显示标有“日志条目详细资料”的窗口，该窗口包含了消息的格式化版本。
</p>
<a name="wp952293"> </a><p class="pParagraph">
在条目列表的末尾，单击按钮以查看日志文件中较早或较晚的条目。
</p>
<a name="wp952295"> </a><p class="pParagraph">
单击“搜索条件”区域中的“高级搜索”以进一步细化日志查看器的搜索条件。使用如下所示的“高级选项”字段：
</p>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp952297"> </a><div class="pSmartList1"><li><b class="cBold">日志程序</b>：要按模块过滤，请从下拉式列表中选择一个或多个名称空间。按住 Shift 键并单击或按住 Ctrl 键并单击来选择多个名称空间。</li></div>
</ul></div>
<div class="pParaIndent1"><ul class="pParaIndent1">
<a name="wp952299"> </a><p class="pParaIndent1">
选择较高级别的名称空间也就选择了该名称空间下的所有名称空间。例如，选择 <code class="cCode">javax.enterprise.system</code> 的同时也就选择了该名称空间下所有模块的日志程序：<code class="cCode">javax.enterprise.system.core</code>、<code class="cCode">javax.enterprise.system.tools.admin</code> 等等。
</p>
</ul></div>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp952301"> </a><div class="pSmartList1"><li><b class="cBold">自定义日志程序</b>：要查看特定于某个特定应用程序的日志程序中的消息，请在文本字段中键入日志程序的名称，每行键入一个。如果应用程序具有多个模块，您可以查看任何模块，也可以查看所有模块。例如，假定应用程序具有使用以下名称的日志程序：</li></div>
<a name="wp952303"> </a><code class="pCodelineIndent">
com.mycompany.myapp.module1<br />com.mycompany.myapp.module2<br />com.mycompany.myapp.module3
</code>
</ul></div>
<div class="pParaIndent1"><ul class="pParaIndent1">
<a name="wp952305"> </a><p class="pParaIndent1">
要查看应用程序中的所有模块的消息，请键入 <code class="cCode">com.mycompany.myapp</code>。如果只查看 <code class="cCode">module2</code> 的消息，则键入 <code class="cCode">com.mycompany.myapp.module2</code>。
</p>
<a name="wp952307"> </a><p class="pParaIndent1">
如果指定了一个或多个自定义日志程序，则仅当您在“日志程序”区域中明确地指定 Application Server 模块的消息之后，才会显示这些消息。
</p>
</ul></div>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp952309"> </a><div class="pSmartList1"><li><b class="cBold">名称-值对</b>：要查看特定线程的输出，请在文本字段中键入该线程的关键字名称和值。关键字名称为 <code class="cCode">_ThreadID</code>。例如：</li></div>
<a name="wp952311"> </a><code class="pCodelineIndent">
_ThreadID=13
</code>
</ul></div>
<div class="pParaIndent1"><ul class="pParaIndent1">
<a name="wp952313"> </a><p class="pParaIndent1">
假定 <code class="cCode">com.mycompany.myapp.module2</code> 在多个线程中运行。要限制日志查看器使其只显示单个线程的输出，请在“自定义日志程序”字段中指定该模块的日志程序，然后在此字段中指定线程 ID。
</p>
</ul></div>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp952315"> </a><div class="pSmartList1"><li><b class="cBold">显示</b>：要一次查看 40 条以上的消息（默认值），请从下拉式列表中选择其他可用的值（100、250 或 1000）。</li></div>
</ul></div>
<div class="pParaIndent1"><ul class="pParaIndent1">
<a name="wp952317"> </a><p class="pParaIndent1">
要查看堆栈追踪，请取消选中“限制过长的消息”复选框。默认情况下，查看器中不会显示堆栈追踪，要查看堆栈追踪，请单击消息的 <code class="cCode">(details)</code> 链接。
</p>
</ul></div>
<a name="wp952319"> </a><p class="pParagraph">
单击“基本搜索”可以隐藏“高级选项”区域。
</p>
<a name="wp952347"> </a><p class="pParagraph">

</p>

<!-- end chapter content -->




<!-- footer -->
<!-- navigation -->
<br />
<br />
  <table width="100%" border="0" cellspacing="4" summary="Footer navigation table">
    <tr><td>
    <p class="pNavigation">
    <a href="threadpools.html" tppabs="http://docs.sun.com/source/819-1553/threadpools.html">上一页</a>
    &#160;&#160;&#160;&#160;
 
    <a href="index.html" tppabs="http://docs.sun.com/source/819-1553/index.html">目录</a>
    &#160;&#160;&#160;&#160;

    <a href="monitor.html" tppabs="http://docs.sun.com/source/819-1553/monitor.html">下一页</a>
    &#160;&#160;&#160;&#160;
    </p>
    </td></tr>
  </table>
<!-- end navigation -->

<hr size="1" noshade="-1" />

<!-- copyright -->
<p class="pFooter">
 
<!-- start copyright -->
<span class="footer">
<a href="copyright.html" tppabs="http://docs.sun.com/source/819-1553/copyright.html" class="footer">版权所有</a> 2004 - 2005 <a href="javascript:if(confirm('http://sun.com/  \n\n该文件无法用 Teleport Ultra 下载, 因为 它是一个域或路径外部被设置为它的启始地址的地址。  \n\n你想在服务器上打开它?'))window.location='http://sun.com/'" tppabs="http://sun.com/" class="footer">Sun Microsystems, Inc.</a> 保留所有权利。
</span>
<!--  end copyright  -->

</p>
<!-- end copyright -->

<!-- <p class="pFooter" align="right">Last Updated <b>$Update;</b></p> -->
<!-- end footer -->

</blockquote>

</body>
</html>