配置 .NET 代理日志记录选项

以下部分介绍如何在详细模式下运行 .NET 代理以及如何为代理设置日志文件选项。为实现这些功能，Introscope 的 .NET 代理使用了 Log4net 功能。如果要使用其他 Log4net 功能，请参阅 Log4net 文档，网址为 http://logging.apache.org/log4net/release/features.html。

以详细模式运行 .NET 代理

以详细模式运行 .NET 代理，可将大量详细信息记录到日志文件中，这在调试时会很有帮助。

以详细模式运行 .NET 代理：

停止 .NET 代理。
打开 logging.config.xml 文件。

将 level value 属性更改为 VERBOSE。默认值为 INFO。

<root>
<level value="VERBOSE" />
<appender-ref ref="logfile" />
<appender-ref ref="console" />
</root>

保存 logging.config.xml 文件并重新启动 .NET 代理。

更改 .NET 代理日志文件的位置

默认情况下，日志文件会写入 <Agent_Home>\logs 目录，通常是 C:\Program Files\CA Wily\Introscope<version>\wily\logs，其中 <version> 是所安装的 Introscope 的版本。为了方便使用，您可能希望更改 .NET 代理日志文件的位置。

更改 .NET 代理日志文件的位置：

停止 .NET 代理。
打开 logging.config.xml 文件。
将 file value 属性更改为日志文件的目标位置，例如：
```
<file value="c:\introscope_logs\IntroscopeAgent.log" />
```
保存 logging.config.xml 文件。
重新启动 .NET 代理。

如果已经为代理配置了名称，则已命名的代理日志会写入 logs 目录（默认位置或者您刚刚指定的新位置）。

.NET 代理日志文件和自动代理命名

默认情况下，.NET 代理会自动获取名称。自动找到 .NET 代理名称后，还将使用相同的信息自动命名与该代理关联的日志文件。代理生成的日志文件记录有关所使用的 PBD 以及在检测过程中插入的探测器的信息。默认情况下，如果使用自动命名，创建的日志文件最初使用文件名中的时间戳进行命名。例如：

AutoProbe20060928-175024.log

一旦代理名称可用，日志文件将重命名以包含代理名称。例如，如果代理名称是 MyDomain//MyAgent，其中 MyDomain 是域，MyAgent 是实例：

AutoProbeMyDomain_MyStuff.log

如果您的日志文件的名称是时间戳而不是日志的实际名称，则在获取代理名称之前进程可能已超时。此外，如果使用了 Log4Net 高级功能，自动命名功能可能无法正常工作。

注意：在加载某个类路径上的资源中的 .NET 代理配置文件时，NativeProfiler 无法写入日志文件，因为 IntroscopeAgent.profile 文件位于资源内部。

如果要禁用日志文件自动命名，请在代理配置文件中将 introscope.agent.disableLogFileAutoNaming 属性设置为 true。

默认域日志

默认域不会连接到企业管理器以报告度量标准，也不会自行运行任何应用程序。但是，由于 .NET 代理会处理默认域承载的所有应用程序域的所有字节代码检测，因此驻留在默认域上的 .NET 代理仍会生成日志文件。其中一个文件 AutoProbe.DefaultDomain.log 包含有关默认域中的字节代码检测的信息。由于所有字节码检测都是在默认域中进行的，因此这些日志文件包含与检测有关的重要信息。

默认域还会为 .NET 代理生成 IntroscopeAgent.DefaultDomain.log 文件。