大网数据广告活动
.NET 与 C# 开发

设置分析环境

· 52CE 我爱测

托管进程(应用程序或服务)启动时,将加载公共语言运行时 (CLR)。 初始化 CLR 时,将评估以下两个环境变量以决定进程是否应连接到探查器:

Note: 有了.NET Framework 4 中的分析功能的重大更改。

托管进程(应用程序或服务)启动时,将加载公共语言运行时 (CLR)。 初始化 CLR 时,将评估以下两个环境变量以决定进程是否应连接到探查器:

  • COR_ENABLE_PROFILING:仅当此环境变量存在并且设置为 1,CLR 将连接到探查器。

  • COR_PROFILER:如果 COR_ENABLE_PROFILING 检查通过,CLR 将连接到具有此 CLSID 或 ProgID,必须已事先存储在注册表中的探查器。 COR_PROFILER 环境变量被定义为字符串,如以下两个示例中所示。

    set COR_PROFILER={32E2F4DA-1BEA-47ea-88F9-C5DAF691C94A}  
    set COR_PROFILER="MyProfiler"  
    

若要分析 CLR 应用程序,必须在运行该应用程序之前设置 COR_ENABLE_PROFILING 和 COR_PROFILER 环境变量。 还必须确保已注册探查器 DLL。

Note: 从.NET Framework 4 开始,探查器不需要进行注册。

Note: 若要使用在.NET Framework 4 和更高版本的.NET Framework 版本 2.0、 3.0 和 3.5 探查器,必须设置 COMPLUS_ProfAPI_ProfilerCompatibilitySetting 环境变量。

环境变量范围

设置 COR_ENABLE_PROFILING 和 COR_PROFILER 环境变量的方式将决定其影响范围。 可以通过下列方式之一设置这些变量:

  • 如果设置中的变量icordebug:: Createprocess调用时,它们将仅应用于时正在运行的应用程序。 (它们将也应用于由继承环境的应用程序启动的其他应用程序。)

  • 如果在“命令提示符”窗口中设置变量,则它们将应用于从该窗口中启动的所有应用程序。

  • 如果在用户级别设置变量,它们将应用于用文件资源管理器启动的所有应用程序。 在设置变量后打开的“命令提示符”窗口将具有这些环境设置,从该窗口中启动的任何应用程序也将如此。 若要在用户级别设置环境变量,右键单击我的电脑,单击属性,单击高级选项卡上,单击环境变量,并添加到变量用户变量列表。

  • 如果在计算机级别设置变量,它们将应用于在该计算机上启动的所有应用程序。 在该计算机上打开的“命令提示符”窗口将具有这些环境设置,从该窗口中启动的任何应用程序也将如此。 这表示该计算机上的每个托管进程都将通过你的探查器启动。 若要在计算机级别设置环境变量,右键单击我的电脑,单击属性,单击高级选项卡上,单击环境变量,将变量添加到系统变量列表,然后再重新启动计算机。 重启后,变量将在系统范围内可用。

如果要分析 Windows 服务,必须在设置环境变量并注册探查器 DLL 之后重启计算机。 有关这些注意事项的详细信息,请参阅明分析 Windows 服务。

其他注意事项

  • 探查器类实现ICorProfilerCallback并ICorProfilerCallback2接口。 在 .NET Framework 2.0 版中,探查器必须实现 ICorProfilerCallback2。 否则,将不会加载 ICorProfilerCallback2。

  • 在给定环境中一次只能由一个事件探查器分析进程。 可以在不同环境中注册两个不同的探查器,但每个探查器必须分析单独的进程。 必须将探查器作为进程内 COM 服务器 DLL 实现,后者被映射到与正在被分析的进程相同的地址空间。 这表示探查器在进程内运行。 .NET Framework 不支持任何其他类型的 COM 服务器。 例如,如果探查器要监视远程计算机上的应用程序,则它必须在每台计算机上实现收集器代理。 这些代理将批处理结果,并将它们传递给中央数据收集计算机。

  • 由于探查器是在进程内实例化的 COM 对象,所以每个被分析的应用程序都将具有其自己的探查器副本。 因此,单个探查器实例不一定要处理来自多个应用程序的数据。 但是,必须向探查器的日志记录代码添加逻辑,以防日志文件从其他被分析的应用程序进行覆盖。

初始化探查器

如果两次环境变量检查均通过,CLR 就会以与 COM CoCreateInstance 函数类似的方式创建探查器实例。 直接调用 CoCreateInstance 不会加载探查器。 因此避免了调用 CoInitialize(需设置线程模型)。 CLR 将调用icorprofilercallback:: Initialize探查器中的方法。 此方法的签名如下。

HRESULT Initialize(IUnknown *pICorProfilerInfoUnk)  

探查器必须查询pICorProfilerInfoUnk有关ICorProfilerInfo或ICorProfilerInfo2接口指针,并将其保存,以便它可以请求更高版本在分析期间的详细信息。

设置事件通知

然后,探查器调用icorprofilerinfo:: Seteventmask方法,以指定它感兴趣的通知类别。 例如,如果探查器只关注函数进入和离开通知以及垃圾回收通知,它将指定以下内容。

ICorProfilerInfo* pInfo;  
pICorProfilerInfoUnk->QueryInterface(IID_ICorProfilerInfo, (void**)&pInfo);  
pInfo->SetEventMask(COR_PRF_MONITOR_ENTERLEAVE | COR_PRF_MONITOR_GC)  

通过以这种方式设置通知掩码,探查器可以限制它接收的通知。 此方法帮助用户构建简单探查器或具有特殊用途的探查器。 它还能减少发送探查器只会忽略的通知将浪费的 CPU 时间。

某些探查器事件是不可变的。 这表示,一旦在 ICorProfilerCallback::Initialize 回调中设置了这些事件,就不能将它们关闭,也不能打开新事件。 试图更改不可变事件将导致 ICorProfilerInfo::SetEventMask 返回失败的 HRESULT。

分析 Windows 服务

分析 Windows 服务与分析公共语言运行时应用程序相似。 两种分析操作都通过环境变量启用。 由于 Windows 服务已于操作系统启动时启动,本主题中之前所述的环境变量必须在系统启动前就已经存在并设置为所需的值。 此外,必须已在系统上注册了分析 DLL。

设置 COR_ENABLE_PROFILING 和 COR_PROFILER 环境变量并注册探查器 DLL 后,应重启目标计算机,以便 Windows 服务能够检测这些更改。

请注意,这些更改将在整个系统范围内启用分析。 若要防止对随后运行的每个托管应用程序进行分析,应在重启目标计算机后删除系统环境变量。

此技术也会导致对每个 CLR 进程进行分析。 探查器应将逻辑添加到其icorprofilercallback:: Initialize回调以检测当前进程是否感兴趣。 如果不相关,探查器可使回调失败而不执行初始化。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。