メインコンテンツまでスキップ

On-premiseインストール及び起動_-_Linux

▶️ [exem-dotnet-agent] インストール (Linux On-Premise)​

1. パッケージ準備​

  • EXEM-DOTNET-AGENT-x.x.x.xという名前のパッケージを準備します。

▶️ 2) 解凍​

1-1. tar.gzの場合​

  • tar -xzf EXEM-DOTNET_AGENT-x.x.x.x.tar.gz

1-2. zipの場合​

  • unzip EXEM-DOTNET-AGENT-x.x.x.x.zip

▶️ 2) エージェント適用及び基本オプション設定​

1-1. 基本設定ファイル​

  • exem/dotnet/cfg/agent/net.conf
  • exem/dotnet/cfg/profile.conf
  • exem/dotnet/cfg/x.advice
  • exem/dotnet/cfg/x.callback.conf

1-2. 主に変更する項目​

  • exem/dotnet/cfg/agent/net.conf
設定名説明備考
EXEM_GROUP_IDWAS Group ID設定しない場合は"default"に設定される、環境変数入力サポート
EXEM_RECEIVER_ADDR収集サーバー(receiver)アドレス。ip:port形式で入力します。環境変数入力サポート
EXEM_DOTNET_AGENT_NAME画面に表示されるWAS name環境変数入力サポート

2. 必須環境変数の適用方法​

  • 基本設定以外に必須で環境変数として適用すべき設定です。
設定名説明
EXEM_DOTNET_HOMEエクセムワンDotNetエージェントパッケージの基本パス (ex: /exem/dotnet)
CORECLR_ENABLE_PROFILING.NET(CoreCLR)プロファイラーの有効化有無(1なら有効化)
CORECLR_PROFILERロードするプロファイラーのCLSID(Guid)
CORECLR_PROFILER_PATHプロファイラー(Exem.DotNet.Profiler.so)の絶対パス
DOTNET_STARTUP_HOOKS.NET起動時に先にロードするStartup Hook DLLパス(EXEM: Exem.DotNet.Startup.Hook.dll)
EXEM_DOTNET_PROFILE_TARGET_PROCESSモニタリング(プロファイリング)対象プロセス(DLL)名(ex: MyService.dll)

2-1 手動export方式​

export EXEM_DOTNET_HOME=/opt/exem/dotnet
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER='{cf0d821e-299b-5307-a3d8-b283c03916dd}'
export CORECLR_PROFILER_PATH="$EXEM_DOTNET_HOME/binary/Exem.DotNet.Profiler.so"
export DOTNET_STARTUP_HOOKS="$EXEM_DOTNET_HOME/binary/startup/Exem.DotNet.Startup.Hook.dll"
export EXEM_DOTNET_PROFILE_TARGET_PROCESS='MyService.dll'

cd /opt/apps/conduit
dotnet Conduit.dll

2-2 envファイル + source (現在のターミナルにのみ適用)​

source ./setenv.sh MyService.dll