본문으로 건너뛰기

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엑셈원 닷넷 에이전트 패키지의 기본 경로 (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