运行环境

Size: px

Start display at page:

Download "运行环境"

隙秒常
4 years ago
Views:

1 听云 DotNET 探针说明

2 DotNET 探针 1 入门 DotNET 探针说明 FAQs 2 安装与卸载 3 配置 4 故障排查 4.1 排除安装故障 4.3 查看日志版权听云 DotNET 探针说明

3 运行环境本节描述 ASP.NET 探针所需的运行环境兼容性信息使用 DotNET 探针 : 1 确认您的系统满足兼容性要求 2 如果您还没有听云帐户, 请注册 3 从帐户管理页面复制您的授权序号 4 安装 DotNET 探针 5 完成探针设置 6 重启 IIS 7 通过管理页面察看数据, 有问题请参考安装和排除故障章节兼容性和要求安装探针之前, 请确保您的系统满足如下这些条件.NET 版本 IIS 版本操作系统数据库 NOSQL 2.0 及以上 6.0 及以上 Windows Server 2012 Windows Server2008 Windows 8 Windows 7 Windows Vista Windows 2003 SQL Server Oracle MySQL PostgreSQL MongoDB ServiceStack.Redis StackExchange.Redis Memcache

4 框架 MVC 2 MVC 3 MVC 4 ASP.NET Web API ASP.NET Web Forms WebServices

5 常见问题问 : 在 win2003 部分机器上, 日志内出现下面错误 ERROR tid:6 POST getredirecthost?app= -> System.Net.WebException: The operation has timed out 或 ERROR tid:10 POST getredirecthost?app= -> System.Net.WebException: 基础连接已经关闭 : 未能为 SSL/TLS 安全通道建立信任关系 ---> System.Security.Authentication.AuthenticationException: 根据验证过程, 远程证书无效答 : 根据 WebTrust CA/B 成员计划及 Microsoft 根证书成员计划的要求,2017 年 1 月 1 日起不再签发 SHA1 算法的服务器证书, 听云探针使用安全性更高的 SHA256 算法证书与服务器进行 SSL 通讯, 但部分 win2003 机器不支持 SHA256 的证书算法, 请对操作系统打相应的补丁 ( 如果找不到补丁, 请联系听云技术支持, 或在探针配置界面内禁用 SSL 通讯

6 安装 1. 下载安装包 tingyun-agent-dotnet- 版本.exe 2. 双击安装包, 选择安装路径, 进行安装 3. 启动 "NBUI.exe", 配置 license 4. 点击 " 启用监控 " 卸载如果监控了自托管宿主的 WCF 应用 ( 见配置一节 ), 必须首先停止批处理下的 WCF 应用, 然后使用普通模式启动 WCF, 最后才能卸载探针, 否则会因为探针被 WCF 应用占用不能完全卸载方法 1) 打开 " 控制面板 " 里面的添加或删除程序, 找到 "TingYun DotNET Profiler", 卸载

7 方法 2) 打开安装路径, 通常在 C:\Program Files (x86)\networkbench.com\dotnet Profiler 下, 找到 "Uninstall.exe", 双击卸载

8 探针配置通过 NBUI.exe 进行参数配置, 对 IIS 或 WCF 服务进行控制, NBUI.exe 仅仅是一个配置管理界面, 启动监控后, 可以退出. license key: 授权码用户程序集 / 代码 : 探针默认不监控用户函数的性能我们可以使用这个配置项指定监控用户程序集及代码监控的程序集和代码名称区分大小写, 此设置更改后, 必须重新点击 " 启用监控 " 按钮才能生效. 监控的 WCF 服务 : WCF 的典型宿主包括以下四种 : 1 "Self-Hosting" in a Managed Application( 自托管宿主 ) 2 Managed Windows Services(Windows Services 宿主 ) 3 Internet Information Services(IIS 宿主 )

9 4 Windows Process Activation Service(WAS 宿主 ) 探针默认仅监控 IIS 宿主和 WAS 宿主的应用性能如果想监控 Windows Services 宿主的 WCF 应用, 请点击右侧的... 按钮添加需要监控的服务名称. 如果想监控自托管宿主的 WCF 应用, 您需要写一个批处理文件启动 WCF 或改写现有的批处理启动文件, 将以下内容写入到批处理文件的第一行 : SET Cor_Enable_Profiling=1 例如您的自托管宿主的 WCF 应用是 d:\app\consolewcf.exe, 批处理文件应该类似 : SET Cor_Enable_Profiling=1 d:\app\consolewcf.exe 当通过 NBUI 配置界面修改配置选项后, 需要手动停止和启动自托管宿主的 WCF 应用, 否则配置选项不会生效机器学习 : 探针默认不监控用户函数的性能, 机器学习是从当前活动的线程堆栈中学习需要监控的用户函数为了保证学习效果, 请在学习过程中, 尽量多的访问应用中常用的页面, 或者在压测的同时进行学习学习完毕后, 需要重新 " 启用监控 " 才能监控学习结果内的用户函数配置应用名称默认情况下, 应用名称和站点名称一致, 如果同一网站部署在多个服务器上, 报表中会以存在一个应用的多个实例, 如果想直接将多个实例区分为多个应用, 可以通过配置站点的 "nbs.app_name" 项更改应用名称 1. 打开 "IIS 管理器 " 2. 选择网站, 双击 " 应用程序设置 ", 在更改设置前, 此站点的数据会汇总在 discuz 下

10 3. 点击 " 添加..." 操作, 添加名称为 "nbs.app_name" 的数据项, 将数值设置为您的站点名称, 更改设置后, 此站点的数据会汇总在 my site 下

11 如果 IIS 版本为 6.0, 您需要修改站点的 Web.Config 配置文件 <configuration> <appsettings> <add key="nbs.app_name" value="my Site" /> </appsettings> </configuration> 配置代理首先退出 NBUI 配置界面, 然后打开探针安装路径下的配置文件 TingYun.ini, 指定代理服务器 nbs.proxy_host = nbs.proxy_port = nbs.proxy_user = nbs.proxy_password =

$NET 全局应用缓存 (GAC) 中部署一个程序集, 这要求使用管理员权限进行安装安装成功后, 可以在 C:\Windows\assembly 找到探针的程序集 TingYun.$ $dll 安装时, 某些杀毒软件可能会直接禁止了对 C:\Windows\assembly 的操作, 请确认杀软的行为如果使用受限权限用户安装, 或被杀软拦截,$

12 排除安装故障注意 : 安装探针时需要在.NET 全局应用缓存 (GAC) 中部署一个程序集, 这要求使用管理员权限进行安装安装成功后, 可以在 C:\Windows\assembly 找到探针的程序集 TingYun.dll 安装时, 某些杀毒软件可能会直接禁止了对 C:\Windows\assembly 的操作, 请确认杀软的行为如果使用受限权限用户安装, 或被杀软拦截, 可能会导致安装程序提示安装成功, 但是启用探针后, 当使用浏览器访问网站时, 由于找不到探针的组件导致页面提示失败失败页面通常如下所示 : 由于安装权限导致的网站运行失败是完全可以在安装之后立即访问网站来进行验证的, 当此情况发生时, 请立即卸载探针, 并使用管理员权限用户重新安装探针或更改杀软的拦截规则, 允许对 GAC 进行操作后重新安装探针

13 如果按正常流程安装配置完成后, 仍然在基调后台看不到运行时性能数据, 请参考以下步骤排查 : 1 确认您的系统环境符合安装要求 (IIS 版本,Windows 版本,.Net 版本 ) 2 打开 NBUI, 确认 license 是否正确, 确认已通过 NBUI 重启 IIS 3 确认网站有用户访问 4 查看日志, 确认与听云后台通信是否正常. 5 经过以上步骤仍无法解决问题, 请联系技术支持.

14 查看日志如果探针工作不正常或者没有数据, 通常可以从日志里获取更多的信息来定位问题. 默认性能采集日志位置 C:\Program Files (x86)\networkbench.com\dotnet Profiler\log\agent.log 正常情况下 agent.log 日志中不应该存在 Error, Critical 等关键字默认情况下, 日志级别为 info, 审计模式是关闭的, 这种情况得到的信息量比较小. 通过 NBUI 配置日志级别为 debug, 并开启审计模式, 输出更多日志信息, 通过日志得到的信息定位问题.

15 版权申明本文档版权归北京基调网络股份有限公司所有未经书面许可, 任何人不得复制传播北京基调网络股份有限公司总部地址 : 北京市朝阳区京顺路 5 号曙光大厦 C 座 207 室邮编 : 联系电话 :

内容

基调网络听云 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