.NET Agent 自定义插桩管理器工具
APM Insight .NET Agent 自定义插桩管理器是一款专为自定义插桩设计的配置工具,作为 .NET agent 2.9 及以上版本的一部分发布。它可帮助您配置 Web 应用程序的方法(包括框架方法和用户自定义方法)以实现插桩,只需 几 次点击即可完成。
该工具的设计目标
- 为您提供 对您自身应用程序 DLL 的可见性,显示必要的 类 及其方法
- 帮助您 配置 自定义插桩方法, 例如添加或删除方法以及为每个方法重命名组件
- 回收正在运行的应用程序池,使自定义插桩生效
安装自定义插桩管理器工具
自定义插桩管理器已捆绑在 .NET Agent MSI 安装包中,将随 agent 一起安装。
- 有关下载和安装 agent 的详细信息,请参阅 安装说明
- 在功能选择页面中,确保选中"Custom Instrumentation" 功能以进行安装

使用自定义插桩管理器工具
从 Windows 开始菜单或开始屏幕(Windows 8/Windows Server 2012)启动 Custom Instrumentation Manager 工具。
从 Web 应用程序的 bin 目录加载应用程序 DLL。下图演示了 DLL 的加载过程。

从左侧面板选择所需的方法、类或整个程序集 并将其添加到右侧面板进行监控。 已选择的方法数量将显示在 底部。

可通过单独编辑组件文本框来设置组件名称。
或者,您也可以选择一组组件,右键单击并选择"Set Component Name"选项,为多个方法批量指定组件。

点击"保存"按钮。保存后,状态栏将显示消息 "Recycle the application pools to take effect"(回收应用程序池以使设置生效)。 请注意,只有当一个或多个 w3wp 进程正在运行时,该消息才会出现。

点击"Recycle App pools",将在不重置 的情况下回收正在运行的应用程序池 IIS。这可以避免应用程序宕机时间。
回收应用程序池后,通知消息将消失。

完成!在下一个轮询间隔中,所选 Web 应用程序方法将被追踪,并显示在 Site24x7 客户端的追踪标签页中。
已添加的方法将与文本 [custom] 一起显示。

注意: 使用此工具无需重启 IIS, 可在应用程序运行期间完成操作,不会造成宕机时间。
