在 Windows 上排查 .NET Framework 跟踪问题

症状： 应用程序显示指标但无追踪记录，部分服务会报告数据，而其他服务则不会，或者在部署或更新后追踪功能停止工作。

故障诊断步骤：

1. 请确认该应用程序的.NET 版本是否受支持：

   • .NET Framework 4.5.2 或更高版本
2. 请确认代理 configuration.yaml 文件中已启用跟踪功能。
3. 使用 Log Collector 或通过手动收集方式收集跟踪日志。

4. 检查 Instana 的跟踪日志并分析结果：

   • 如果日志为空或未显示任何跟踪信息，则说明该应用程序未生成跨度。
   • 如果日志中存在跟踪记录但缺少某些信息（例如主机名），则问题出在.NET 的跟踪层上。
   • 如果日志中存在相关记录，且其中包含用户界面中缺失的信息，则说明问题发生在 Instana 后端或代理端。

症状： 当 Instana 代理正在运行时，应用程序在启动时崩溃。

故障诊断步骤：

1. 请确认该应用程序的.NET 版本是否受支持：

   • .NET Framework 4.5.2 或更高版本
2. 使用 “日志收集器 ”或通过手动收集方式收集“事件查看器”日志。

3. 请检查 Instana 事件查看器的日志 ：

   • 确定日志中是否出现了错误或警告。 一个事件包含详细信息，包括时间戳和错误代码，这些信息有助于诊断问题。
   • InstanaPCP.exe如果出现提示错误的信息，则表示 InstanaPCP 已崩溃。 请查看之前的事件，并进一步调查该问题。
4. 收集该应用程序的崩溃转储文件。

症状：Instana 代理未对 .NET 应用程序进行监控，且该应用程序未显示在用户界面中。

故障诊断步骤：

1. 请确认 Instana 代理程序是以管理员身份运行的。
2. 请确认 Instana 代理具有访问该应用程序的权限。

3. 请确认 Instana PCP 是否正在运行：

   • InstanaPCP在 Windows 上打开任务管理器，然后搜索。

4. 使用 Log Collector 或手动收集方式收集 Instana 代理日志。

   • 在 Instana 代理日志中，必须包含以下行：

     com.instana.agent-process-handling - <version> |  | InstanaPCP.exe passed early window; marked RUNNING

5. 请在代理日志中确认传感器已成功激活：

   com.instana.sensor-clr - <version> |  | Activated Sensor

6. 请确保在启动 Instana 代理后，再启动.NET 进程。

症状： 启用跟踪功能后， InstanaPCP 或 .NET 应用程序的 CPU 使用率异常升高。

故障诊断步骤：

1. 请通过查看“任务管理器”来确定该问题是与应用程序相关，还是与 InstanaPCP 相关。

2. 如果问题出在 InstanaPCP:

   • 为 InstanaPCP 启用调试日志。 请参阅 “收集日志”。
   • 检查日志中是否存在关于缺少性能计数器或异常的重复消息。

3. 如果问题是应用程序内存突增：

   • 使用 “日志收集器 ”或手动收集日志 ，以收集事件日志和.NET 日志。
   • 检查事件日志和.NET 日志中是否存在与内存相关的异常。
   • 请确认该问题是否由 Instana 的监控功能引起。
   • 请收集一个.NET 转储文件，以便进一步分析。

Log Collector 是一款用于从 Instana 收集日志的独立应用程序。 您可以在以下位置触发日志收集器：

• Instana 用户界面
• 控制台

日志收集器会收集以下日志：

• 应用程序跟踪日志
• Instana PCP日志
• CLR 调试日志
• 事件查看器日志
• Instana 代理调试日志
• Instana 代理记录日志

或者，您可以手动收集日志。 完成以下步骤：

1. 启用调试日志：

   1. 请使用以下选项之一添加环境变量：

      注意： 请确保路径有效、进程或应用程序能够访问，且路径正确。

      • 请在系统级别手动设置以下环境变量：

        INSTANA_NET_LOG_PATH: "C:\dc_net_log"
        INSTANA_NET_LOG_LEVEL: DEBUG
        INSTANA_NET_FF_LOG_LEVEL: DEBUG
        INSTANA_NET_PCP_LOG_LEVEL: DEBUG
        INSTANA_TRACER_ENTEREXIT_LOGGING: 1
        INSTANA_EXTENDED_DEBUG: 1

      • 以管理员身份打开命令提示符，并运行以下命令以添加环境变量：

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_FF_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_PCP_LOG_LEVEL "DEBUG" /M
        setx INSTANA_TRACER_ENTEREXIT_LOGGING "1" /M
        setx INSTANA_EXTENDED_DEBUG "1" /M

   2. 请配置以下注册表项： Windows ：

      CLRDebugLog: "C:\dc_clr_debug_log\clr_"

   3. 请重新启动应用程序。

2. 收集 Instana 代理日志：

   1. 停止代理 <instana_install_dir>/bin/stop.sh 程序；或者，如果代理程序是以服务形式启动的，则停止该服务。

   2. 清除日志：运行以下命令，删除日志目录中的所有文件，以便重新开始：

      rm -rf <instana_install_dir>/data/log/*

   3. 将日志级别设置为“调试”：在代理 configuration.yaml 程序文件中更改日志级别的严重性。 如需了解更多信息，请参阅 “设置代理配置文件”。
   4. 启动代理 <instana_install_dir>/bin/start.sh 程序 或 启动服务。
   5. 重现问题：让问题自然发生，并让代理程序运行约15分钟。

   6. 收集日志：运行以下命令，将日志目录压缩以便提交：

      cd <instana_install_dir>/data/logs
      zip -r instana_agent_debug_logs.zip *

      PowerShell:

      Compress-Archive * instana_agent_debug_logs.zip

3. 收集 Instana 的跟踪日志：

   1. com.instana.agent.main.sender.File.cfgGo 转到 [agent-dir]\etc\instana 并打开该文件。

   2. 在文件中添加以下几行：

      prefix=instanaTraces
      type=traces

      此配置将生成一个日志文件，其中 [agent-dir]/data/log 包含所有带有 "instanaTraces" 前缀的跟踪记录。

   3. 重新启动 instana 代理程序。
   4. 重新启动应用程序，并运行约15分钟。

   5. 从以下路径收集日志：

      • 由该变量指定的路径 INSTANA_NET_LOG_PATH
      • instana-agent-installation-folder/data/log

4. 收集 CLR 调试日志：

   1. 打开注册表编辑器。
   2. 转至 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Instana\
   3. C:\temp\clr_将该注册表键 CLRDebugLog 作为字符串（带值）添加，例如：

   4. 或者，以管理员身份打开命令提示符，并运行以下命令：

      reg add "HKLM\SOFTWARE\Instana" /v CLRDebugLog /t REG_SZ /d "C:\temp\clr_" /f

5. 收集 Windows 事件查看器日志：

   1. 打开“事件查看器”：

      1. 按下 Win + R。
      2. 输入 eventvwr.msc.
      3. 按下 Enter 键。

   2. Go 在您要导出的日志中：

      • Windows 日志： Windows 日志 > 应用程序
      • 应用程序和服务日志
   3. 在 “操作” 面板中，选择 “将所有事件另存为 ”。
   4. 选择一个位置并保存为 .evtx.