基调网络听云 ASP.NET 探针说明
ASP.NET 探针 1 入门 ASP.NET 探针说明系统构成 FAQs 2 安装与卸载 3 配置 4 故障排查 4.1 排除安装故障 4.2 检查守护进程 4.3 检查扩展模块 版权 4.4 查看日志 基调网络听云 ASP.NET 探针说明
ASP.NET 探针说明 本节描述 ASP.NET 探针所需的运行环境 兼容性信息, 以及介绍安装配置方法 使用 ASP.NET 探针 : 1 确认您的系统满足兼容性要求 2 如果您还没有听云帐户, 请注册 3 从帐户管理页面复制您的授权序号 4 安装 ASP.NET 探针 5 完成探针设置 6 重启 IIS 7 通过管理页面察看数据, 有问题请参考安装和排除故障章节 兼容性和要求 安装 ASP.NET Agent 之前, 请确保您的系统满足如下这些条件 需求.NET 版本 IIS 版本 4.0 及以上 6.0 及以上 操作系统 Windows Server 2012 Windows Server2008 Windows 8 Windows 7 Windows Vista Windows 2003 数据库 SQL Server Oracle MySQL
框架 MVC 2 MVC 3 MVC 4 ASP.NET Web API ASP.NET Web Forms WebServices 授权序号 对于每一份听云探针的安装, 都需要一个授权序号 这是听云为您提供的一个的字符串 关于授权序号, 请从您的帐户信息中获取
系统构成 ASP.NET Agent 由两部分组成 : IIS 数据采集模块 windows 系统服务 : TingYun ASP.NET Profiler windows 系统服务监听指定的网络端口, 并接收 IIS 模块捕获的性能数据, 汇总压缩后传送到听云系统后台 不启用 TingYun ASP.NET Profiler 服务, 就不会有数据发送到听云系统
常见问题 1. 探针会对服务器造成性能或其他影响吗? 影响面影响程度说明 IIS 性能对 IIS 应用性能的影响小于 3% 探针使用多级缓存和哈希表映射等机制, 尽量将算法复杂度控制在 O(1) 的级别 安装探针时需要在.NET 全局应用缓存 (GAC) 中部署一个程序集, 这要求使用管理员权限进行安装 如果使用受限权限用户安装, 可能会导致安装程序提示安装成功, 但是启用探针后, 当使用浏览器访问网站时, 由于找不到探针的组件导致页面提示失败 IIS 稳定性对服务器正常运行的影响几乎为 0 由于安装权限导致的网站运行失败是完全可以在安装之后立即访问网站来进行验证的, 当此情况发生时, 请立即卸载探针, 并使用管理员权限用户重新安装探针即可 当探针安装成功后, 在网站运行期间, 由于探针本身原因导致的 IIS 异常概率几乎为 0, 即使在某些特殊的环境下导致了 IIS 崩溃, 探针也能感知 IIS 的崩溃, 记录崩溃信息以备技术改进, 然后自动禁用探针并重启 IIS 网络带宽 内存占用 应用相关, 数据量通常在 50KB/ 分钟 应用相关,100M 左右 探针采集的数据是经过汇总处理并压缩为 gzip 格式上传的, 汇总数据每分钟上传一次到报表服务器 数据量大小和 IIS 上被访问的页面数量相关, 客户平均数据量在 10KB-300KB/ 分钟之间 内存占用与 IIS 上被访问的页面数量相关, 客户平均内存在 50M-200M 之间 CPU 占用 2% 以下
安装 1. 下载安装包 : tingyun-agent-dotnet-latest.exe 2. 双击安装包, 选择安装路径, 进行安装 3. 启动 "NBUI.exe", 配置 license 4. 如果您是 IIS7.0 及以上版本, 无需修改任何配置文件 5. 如果您是 IIS 6.0 版本, 或需要监控 IIS 7 的经典模式网站, 需要修改网站的配置文件 : 修改站点下的 Web.Config 文件 ( 例如 C:\inetpub\wwwroot\webSite1\Web.Config) 注意, 手工添加模块时, 必须确认网站使用的进程池是 4.0 版本, 并且当 web.config 中已存 在 httpmodules 节点时, 仅需添加 add 项 <configuration> <system.web> <httpmodules> <add name="networkbench" type="networkbench.httpmodule, NetworkBench, Version=1.0.0.0, Culture=neutral, PublicKeyToken=33f2aa5aa910e993" /> </httpmodules> </system.web> </configuration> 6. 点击 " 重启 IIS( 使用监控 )"
卸载 如果您在安装探针时手工修改了 Web.Config 配置文件 (IIS6.0 或经典模式的进程池 ), 添加了 name="networkbench" 的 httpmodules, 请先移除相应配置, 否则, 卸载探针后重启 IIS 网站会报配置错误 1) 方法 1 打开 " 控制面板 " 里面的 添加或删除程序, 找到 "TingYun ASP.NET Profiler", 卸载 2) 方法 2 打开安装路径, 通常在 C:\Program Files (x86)\networkbench.com\asp.net Profiler 下, 找
到 "Uninstall.exe", 双击卸载
探针配置 通过 NBUI.exe 进行参数配置, 对 IIS 进行控制, NBUI.exe 仅仅是一个配置管理界面, 启动监控后, 可以退出. license key: 授权码 通讯端口 : 数据采集模块和系统服务之间通过 socket 进行通讯, 不能和其他软件冲突 监控的程序集 : 除了默认的数据库性能和 ASP 页面性能, 用户可以指定监控特定字符串开头为标记的程序集. 监控的程序集名称区分大小写, 多个程序集以逗号分隔. 此设置更改后, 必须使用 " 重启 IIS( 使用监控 )" 重启 IIS 才能生效. 例如 : 设置为 MySite.tool.,MyApp.api., 会监控以 "mysite.tool." 开头和 "myapp.api." 开头的代码性能
配置应用名称 站点的性能数据默认汇总在 IIS 管理器配置的站点名称下, 也可以通过配置站点的 "nbs.app_name" 项更改应用名 称 1. 打开 "IIS 管理器 " 2. 选择网站, 双击 " 应用程序设置 ", 在更改设置前, 此站点的数据会汇总在 discuz 下 3. 点击 " 添加..." 操作, 添加名称为 "nbs.app_name" 的数据项, 将数值设置为您的站点名称, 更改设置后, 此站点的数据会汇总在 my site 下
如果 IIS 版本为 6.0, 您需要修改站点的 Web.Config 配置文件 <configuration> <appsettings> <add key="nbs.app_name" value="my Site" /> </appsettings> </configuration> 禁用某个站点的监测数据 如果为 IIS 6.0 或经典模式, 请删除站点 Web.Config 配置文件内对 NetworkBench 模块的引用 1. 打开 "IIS 管理器 " 2. 选择网站, 双击 " 模块 " 打开模块列表, 在列表内删除对 NetworkBench 模块的引用
排除安装故障 注意 : 安装探针时需要在.NET 全局应用缓存 (GAC) 中部署一个程序集, 这要求使用管理员权限进行安装 如果使用受限权限用户安装, 可能会导致安装程序提示安装成功, 但是启用探针后, 当使用浏览器访问网站时, 由于找不到探针的组件导致页面提示失败 失败页面通常如下所示 : 由于安装权限导致的网站运行失败是完全可以在安装之后立即访问网站来进行验证的, 当此情况发生时, 请立即卸载探针, 并使用管理员权限用户重新安装探针即可 如果按正常流程安装配置完成后, 仍然在基调后台看不到运行时性能数据, 请参考以下步骤排查 : 1 确认您的系统环境符合安装要求 (IIS 版本,Windows 版本,.Net 版本 ) 2 打开 NBUI, 确认 license 是否正确, 确认已通过 NBUI 重启 IIS 3 确认网站有用户访问 4 查看日志, 确认扩展模块与守护进程通信是否正常, 确认守护进程与听云后台通信正常. 5 经过以上步骤仍无法解决问题, 请联系技术支持.
检查守护进程 第一步 : 确认守护进程在运行, 打开 Windows 任务管理器, 查看 NBService.exe 和 NBProfiler.exe 是否存在, 如下图 : 确认上面的两个进程是否存在, 如果不存在那么请看第二步 第二步 : 确定 TingYun ASP.NET Profiler 服务是否启动, 如下图
如果 TingYun ASP.NET Profiler 启动了,NBService.exe 和 NBProfiler.exe 还没有运行, 那么请与技术支持联系
检查 HTTP 扩展模块 第一步 : 以管理员权限运行命令提示符, 然后进入 C:\Windows\System32\inetsrv 运行下面的命令 : appcmd list module NetworkBench 查看 NetworkBench 模块是否加载, 成功加载后的效果如下 若上述步骤没有 networkbench 模块信息, 那么进入第二步 请进入 NBUI.exe 的目录, 然后依次执行下面命令 : NBUI.exe -u NBUI.exe -i 执行第二步操作后, 再执行第一步, 如果仍未出现 NetworkBench 模块信息, 则很有可能您的 IIS 或 asp.net 进 程池版本不符合安装条件
查看日志 如果系统工作不正常或者没有数据, 通常可以从日志里获取更多的信息来定位问题. 默认守护进程日志位置 C:\Program Files (x86)\networkbench.com\asp.net Profiler\log\daemon.log 默认守护进程日志位置 C:\Program Files (x86)\networkbench.com\asp.net Profiler\log\agent.log 正常情况下会存在 daemon.log 和 agent.log 2 个文件, 且日志中不应该存在 Error, Critical 等关键字 默认情况下, 日志级别为 info, 审计模式是关闭的, 这种情况得到的信息量比较小. 通过 NBUI 配置日志级别为 debug, 并开启审计模式, 让守护进程和 IIS 扩展输出更多日志信息, 通过日志得到的信息定位问题. 当日志文件夹下面出现 *.dmp 文件时, 说明探针遇到了未经处理的异常, 请将整个 log 文件夹打包发送给听云技术支持人员进行排查
版权申明 本文档版权归北京基调网络系统有限公司所有 未经书面许可, 任何人不得复制 传播 北京基调网络系统有限公司 www.networkbench.com 总部地址 : 北京市朝阳区京顺路 5 号曙光大厦 C 座 207 室邮编 :100028 联系电话 :010-84440086