.NET Agent 常见故障排查方法

尊敬的 .NET Agent 用户,如您在使用过程中遇见问题,可以尝试通过如下方法进行故障排查。

步骤一:确认 .NET Agent 是否为最新版本

您可以通过「安装步骤」页面来下载最新版探针。或者,直接登录官网下载。

对于 Window 用户,可以通过“控制面板”来查询 Agent 版本,如果版本不是最新,请您进行更新。更新方法:

  • 前往「安装步骤」页面下载 32 位或 64 位安装文件。

  • 双击后直接安装。

  • 重启 IIS。

步骤二:确认系统环境和应用场景是否满足

请您确认系统环境和应用场景是否满足,您可以前往“安装指南->.NET ->兼容环境支持”进行查看。

步骤三:确认安装文件是否齐全

以默认安装路径 C 盘(系统为 64)为例,当您正确完成安装后,可以通过查询如下路径来确认安装文件是否齐全:

Agent 版本为 .NET Agent v1.0.0.7

  • 安装路径:C:\Program Files (x86)\OneAPM.net.Agent 共 14 个对象。如果 Blueware.Profiler.dll 文件加载失败,您可以前往故障排查文档查看解决方案。

004

  • 数据和配置路径:C:\ProgramData\OneAPM.net.Agent 共 5 个对象。(需要开启显示隐藏目录)

005

Agent 版本为 .NET Agent v1.0.0.8

  • 安装路径:C:\Program Files (x86)\OneAPM\OneAPM.Net.Agent共8个对象。

006

  • 数据和配置路径:C:\ProgramData\OneAPM\OneAPM.Net.Agent 共 5 个对象。(需要开启显示隐藏目录)

007

Agent 版本为 .NET Agent v1.2.0.0 以上

  • 安装路径:C:\Program Files (x86)\OneAPM.Net.Agent 共 12 个对象。

008

  • 数据和配置路径:C:\ProgramData\OneAPM.Net.Agent 共 5 个对象。(需要开启显示隐藏目录)

009

步骤四:确认 license key 是否写入

打开路径 C:\ProgramData\OneAPM.net.Agent(需要开启显示隐藏目录)下的 oneapm.config 文件,可以使用 Visual Studio 或者记事本打开。

如图所示,在节点 service 下,请确保 licenseKey 属性值不为空。如果 license key 未写入,您需要登录官网查询授权码并复制,然后手动黏贴进去。

010

写入 license key 值后,您需要重启 IIS。

步骤五:确认网络连通

当您确保上述步骤都没有问题时,但仍无法看到数据,您需要检查网络是否连通。您可以前往文档查看具体解决方案。

如您通过上述步骤,仍然无法解决问题,请收集日志信息,与我们联系。