Monitoring .NET 及 .NET Core 型應用程式

對在 Kubernetes 上執行的應用程式啟用追蹤

Instana AutoTrace WebHook 是 Kubernetes 轉換 WebHook 許可控制器的實作，它會在整個 Kubernetes 叢集中自動設定使用 Instana 監視 .NET 應用程式所需的一切。

如果 Instana AutoTrace WebHook 安裝在 Kubernetes 叢集上，則會針對在那些叢集裡執行的 .NET 應用程式自動啟用追蹤。

如果 .NET 應用程式及 Instana 代理程式由 Kubernetes管理，請參閱 Kubernetes 網路存取 ，以取得必要配置的相關資訊。

對 Linux 上執行的應用程式啟用追蹤

對於在 Linux 上執行的應用程式 ( Alpine Linux除外) ，請安裝 Instana.Tracing.Core.Rewriter.Linux 套件。 您可以在發佈之前將套件新增至專案或新增套件。 在啟動程序之前，請提供環境變數給您的程序，如下列範例所示:

DOTNET_STARTUP_HOOKS=[path-to-your-app]/Instana.Tracing.Core.dll
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
CORECLR_PROFILER_PATH=[Path_to_your_app]/instana_tracing/CoreProfiler.so

如果您的應用程式在儲存器內執行，請定義環境，讓程序在執行時期聯絡 Instana 代理程式:

INSTANA_AGENT_HOST=[address_where_the_agents_listens_and_is_reachable_from_inside_the_container]
INSTANA_AGENT_PORT=42699 (or any other port of configured differently)

對 Alpine Linux 上執行的應用程式啟用追蹤

安裝 Instana.Tracing.Core.Rewriter.Alpine 套件。 您可以在發佈之前將套件新增至專案或新增套件。 然後，在啟動處理程序之前，將環境變數提供給處理程序，如下列範例所示:

DOTNET_STARTUP_HOOKS=[path-to-your-app]/Instana.Tracing.Core.dll
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
CORECLR_PROFILER_PATH=[Path_to_your_app]/instana_tracing/CoreProfiler.so

如果您的應用程式是在儲存器中執行，請定義環境，讓程序在執行時期聯絡 Instana 代理程式:

INSTANA_AGENT_HOST=[address_where_the_agents_listens_and_is_reachable_from_inside_the_container]
INSTANA_AGENT_PORT=42699 (or any other port of configured differently)

對在 Windows 上執行的應用程式啟用追蹤

安裝 Instana.Tracing.Core.Rewriter.Windows 套件。 您可以在發佈之前將套件新增至專案或新增套件。

啟用處理程序的追蹤

安裝套件之後，請先提供環境變數給程序，然後再啟動程序，如下列範例所示:

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
CORECLR_PROFILER_PATH_64=[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll
CORECLR_PROFILER_PATH_32=[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll

對 Windows 服務啟用追蹤

如果您是執行 Windows-Services，則也可以根據每個服務，將這些設定放入登錄中，這可讓您更妥善地控制選擇要追蹤的服務。

移至 HKLM\System\CurrentControlSet\Services\<ServiceName> 目錄中的「登錄編輯器」，並新增 MULTI_SZ 作為 Environment的值。 如果 Environment 不存在，則將變數 CORECLR_ENABLE_PROFILING=1 和 CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3} 複製到檔案中。

若要設定 MULTI_SZ 值的內容，請每行輸入一個鍵值組，如下列範例所示:

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}

在您輸入最後一行之後，按 Enter 鍵。

對 IIS 管理的應用程式啟用追蹤

當透過 IIS管理應用程式時，最佳作法是在應用程式的 web.config 檔中，以下列格式設定環境變數:

<aspNetCore ...>
  <environmentVariables>
    <environmentVariable name="CORECLR_ENABLE_PROFILING" value="1" />
    <environmentVariable name="CORECLR_PROFILER" value="{FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}" />
    <environmentVariable name="CORECLR_PROFILER_PATH_64" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll" />
    <environmentVariable name="CORECLR_PROFILER_PATH_32" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x32.dll" />
    <environmentVariable name="DOTNET_STARTUP_HOOKS" value="[Path_to_your_app]/Instana.Tracing.Core.dll" />
  </environmentVariables>
</aspNetCore>

在 Cloud Foundry

附註: 僅當 Instana 代理程式在 Cloud Foundry 基礎的 Diego Cell 上執行時，此區段才適用。 如需設定 Instana 代理程式及相關 Cloud Foundry 或 Pivotal Platform 功能的相關資訊，請參閱 Cloud Foundry 及 Pivotal Platform 文件。

在 Cloud Foundry上，若要監視 非自行包含 .NET 應用程式，請遵循下列步驟:

• 若要將 Instana NuGet 套件新增至 Cloud Foundry 應用程式，請執行下列指令:

  dotnet add myproject.csproj package Instana.Tracing.Core.Rewriter.Linux
  

• 若要準備要發佈的 .NET 應用程式，請執行下列指令:

  dotnet publish -c Release
  

• 若要使用 Release以外的 configuration ，請將下列環境變數新增至應用程式資訊清單:

  ---
  applications:
  - name: <application_name>
    path: bin/Release/netcoreapp2.1/publish/
    env:
      DOTNET_STARTUP_HOOKS:[path-to-your-app]/Instana.Tracing.Core.dll
      CORECLR_ENABLE_PROFILING: 1
      CORECLR_PROFILER: "{cf0d821e-299b-5307-a3d8-b283c03916dd}"
      CORECLR_PROFILER_PATH: "/home/vcap/app/instana_tracing/CoreProfiler.so"
      LD_LIBRARY_PATH: "/home/vcap/app/instana_tracing"
  

  附註: 視使用的 .NET SDK 以及透過 -c 旗標 (範例中的Release ) 傳遞至 dotnet publish -c Release 指令的配置名稱而定， path 變數的值可能會變更。

• 若要推送 Cloud Foundry 應用程式，請執行下列指令:

  cf push
  

  附註: 上述指令假設應用程式的 manifest.mf 檔案位於您執行 cf push 指令的相同資料夾中。

如需如何搭配使用 cf push 指令與資訊清單檔的相關資訊，請參閱 使用應用程式資訊清單部署。

適用於 Linux 儲存器的 IL-rewriter 及 Instrumentation 程式庫

新增 nuget-package ，並確保新增環境變數以連接至代理程式。

設定容器以進行自動追蹤

下列範例顯示 Docker 檔:

### your docker-image and application-build/-publish here

# set CoreCLR tracing environment variables
ENV DOTNET_STARTUP_HOOKS=/app/Instana.Tracing.Core.dll
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={cf0d821e-299b-5307-a3d8-b283c03916dd}
ENV CORECLR_PROFILER_PATH=/app/instana_tracing/CoreProfiler.so

# provide agent-endpoint
ENV INSTANA_AGENT_HOST=host_or_other_container_name_or_ip
ENV INSTANA_AGENT_PORT=42699
ENTRYPOINT ["dotnet", "YourApp.dll","some","parameters"]

驗證是否已安裝追蹤程式

請檢查應用程式日誌中的下列項目:

Error getting agent-info, make sure the agent is running and reachable:One or more errors occurred. (Connection refused)

這一行指出追蹤程式已安裝且在執行中。 您可以看到數個具有下列文字的項目:

Process Announcement:One or more errors occurred. (Connection refused)

如果您在範例中看不到含有文字的項目，請確定符合下列必要條件:

• 在主機代理程式的 configuration.yaml 檔中啟用 .NET 追蹤。
• 遵循 追蹤 文件中的所有必要步驟。

如果 .NET 應用程式在 Kubernetes上執行，請嘗試 Instana AutoTrace WebHook，這會自動且透通地將 .NET 檢測新增至 Pod。

如果您無法使用列出的其他疑難排解步驟來修正問題，請嘗試下列提示來解決網路問題:

驗證追蹤程式可以連接至主機代理程式

如果已安裝 .NET 追蹤程式，請驗證 .NET 處理程序可以連接至埠 42699 上相同主機上的主機代理程式。 如需網路可見性的相關資訊，請參閱 Instana 主機代理程式的 網路需求 。

在儲存器化平台中，應用程式儲存器與 Instana 主機代理程式之間可能會發生網路可見性問題。 由於部分套版網路設定，應用程式的儲存器可能無法連接至相同主機上的 Instana 代理程式儲存器。

.NET 追蹤程式可能使用錯誤的 IP 位址或 DNS 名稱來與 Instana 代理程式進行通訊。 您可以使用 INSTANA_AGENT_HOST 環境變數，將 .NET 追蹤程式設為使用特定的網址。

在某些情況下，如果您已設定網路，則問題可能不是與網址相關，但問題可能與追蹤程式所使用的埠相關。

如果主機代理程式在 42699 以外的其他埠上接聽，請使用 INSTANA_AGENT_PORT 環境變數重新對映追蹤程式的埠。

如果您無法對問題進行疑難排解，請開啟 支援案例。