Cloud Foundry での.NET トレースの設定

オンラインで編集

Cloud Foundry で.NET Core のトレースを設定するには、アプリケーションがトレースデータを生成するように設定し、Diegoセル上で実行されている Instana エージェントに接続します。

.NET の監視機能の詳細については、 「.NET の監視機能の仕組み」を参照してください。

準備

オンラインで編集

Cloud Foundry で.NET のトレースを有効にする前に、以下の前提条件が満たされていることを確認してください：

  • Instana エージェントは、 Cloud Foundry 財団のDiegoセル上で実行されています。 Instana エージェントの設定および関連する Cloud Foundry やPivotal Platformの機能に関する詳細については、 Cloud Foundry およびPivotal Platform のドキュメントを参照してください。
  • サポート情報を確認してください。
注： この設定は、 Cloud Foundry 上の非スタンドアロン型.NET アプリケーションにのみ適用されます。

.NET のトレース機能を有効にする

オンラインで編集

Cloud Foundry でホストされている .NET Core アプリケーションでトレース機能を有効にするには、以下の手順を実行してください：

手順 1: 「 Instana 」パッケージ（ NuGet ）を追加する

オンラインで編集

次のコマンドを実行して、 Cloud Foundry アプリケーションに Instana トレースパッケージを追加します

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

を実際のプロジェクトファイル名に置き換えて myproject.csproj ください。

ステップ2：公開に向けた申請の準備

オンラインで編集

次のコマンドを実行して、.NET アプリケーションを公開できるように準備してください：

dotnet publish -c Release

このコマンドは、指定された構成で Release アプリケーションを公開します。 必要に応じて、別の設定を使用することもできます。

ステップ 3: 環境変数の設定（設定Release ファイルを使用しない場合）

オンラインで編集

これ以外の Release 構成を使用する場合は、アプリケーションマニフェスト（manifest.yml）内で必要な環境変数を定義してください。

---
applications:
- name: <application_name>
  path: bin/Release/<TargetFramework>/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"

を実際のアプリケーション名に置き換えて <application_name> ください。

注： 使用する.NET SDKや、コマンドの dotnet publish フラグ -c （Release 例：）を通じて渡される構成名によっては、変 path 数の値が変わる場合があります。

ステップ4：アプリケーションを Cloud Foundry にデプロイする

オンラインで編集

次のコマンドを実行して、アプリケーションを Cloud Foundry にデプロイしてください：

cf push
注： このコマンドは、アプリケーション manifest.yml ファイルがコマンド cf push を実行するフォルダと同じフォルダにあることを前提としています。

この cf push コマンドをマニフェストファイルと組み合わせて使用する方法の詳細については、 「App Manifests を使用したデプロイ」 を参照してください。

ステップ5：トレースが正常に動作していることを確認する

オンラインで編集

アプリケーションをデプロイした後、トレースが収集されていることを確認してください：

  1. Instana のUIにあるナビゲーションメニューから、 「アプリケーション 」>「 サービス」 を選択します。
  2. 監視対象のサービスを選択して、収集されたトレースと分析結果を確認してください。