호스트 에이전트 관리

필수 조건을 충족한다면 구성 관리를 시작할 수 있습니다.

활성화된 구성 관리가 없는 경우, ‘구성 관리’ 섹션에서 를 클릭하여 Initialize Git 기반 구성 관리를 초기화하십시오.

그런 다음, ‘구성 관리’ 대화 상자에 다음 정보를 입력하십시오:

• 원격 이름 : ‘ Git ’ 원격의 이름입니다.
• 원격 브랜치 : 업데이트에 사용할 브랜치의 이름입니다.
• 원격 URI : Git 저장소의 URI입니다.

‘초기화 및 재시작’을 클릭하여 설정에 따라 에이전트를 구성하고, 재시작하여 최신 구성을 가져오십시오.

구성 관리가 이미 활성화된 경우, ‘구성 관리 ’ 섹션에서 자세한 내용을 확인할 수 있습니다. 이 세부 정보에는 브랜치 이름 및 URI와 같은 구성된 원격 저장소에 대한 정보와, 해시 및 커밋 메시지와 같은 현재 사용 중인 커밋에 대한 정보가 포함됩니다.

구성을 업데이트하려면 [업데이트 ]를 클릭하고 구성 관리 대화 상자에 필요한 정보를 입력하십시오.

‘업데이트 및 재시작’을 클릭하여 설정에 따라 에이전트를 구성하고, 재시작하여 최신 구성을 가져오십시오.

Linux 시스템에서 호스트 에이전트의 힙 덤프를 생성하려면, Linux 셸에서 다음 명령을 실행하십시오:

TS=`date +%s` && /opt/instana/agent/jvm/bin/jmap -dump:file=/tmp/agent-dump-$TS.hprof `cat /opt/instana/agent/agent.pid` && gzip /tmp/agent-dump-$TS.hprof

이 명령은 힙 덤프를 생성하고 압축된 파일을. /tmp/agent-dump-<timestamp>.hprof.zip에 저장합니다.

Windows 시스템에서 호스트 에이전트의 힙 덤프를 생성하려면, PowerShell: 에서 다음 명령을 실행하십시오

$TS = [int][double]::Parse((Get-Date -UFormat %s)); C:\"Program Files"\Instana\instana-agent\jvm\bin\jmap -dump:file="$env:TEMP\agent-dump-$TS.hprof" (Get-Content "C:\Program Files\Instana\instana-agent\agent.pid"); Compress-Archive -Path "$env:TEMP\agent-dump-$TS.hprof" -DestinationPath "$env:TEMP\agent-dump-$TS.hprof.zip" -Force; Remove-Item "$env:TEMP\agent-dump-$TS.hprof"

이 명령은 힙 덤프를 생성하고 압축된 파일을. $TEMP\agent-dump-<timestamp>.hprof.zip에 저장합니다.

Linux 시스템에서 호스트 에이전트의 힙 덤프를 생성하려면 다음 단계를 수행하십시오:

임시 힙 덤프는 에이전트가 설정으로 -Dcom.ibm.tools.attach.enable=yes 실행될 때만 생성할 수 있습니다. 이 설정을 확인하려면 Instana UI에서 에이전트 관리 대시보드를 열고, 프로세스 대시보드 왼쪽에 있는 ‘ Instana ’ 에이전트 프로세스 엔터티로 이동한 다음, 프로세스 인자 목록에서 해당 com.ibm.tools.attach.enable 항목을 찾으십시오.

다음 단계는 Instana 에이전트가 기본 설치 경로인 에 설치되어 있으며 /opt/instana/agent , 에이전트가 Systemd 서비스로 실행 중이라고 가정합니다. Instana 에이전트를 다른 위치에 설치한 경우 경로를 수정해야 합니다.

1. Linux 호스트에 사용자로 root 로그인하거나 셸 세션을 사용자로 root 전환하십시오.
2. 파일을 /opt/instana/agent/bin/setenv 열어 편집하세요.
3. 로 시작하는 줄을 찾아서 EXTRA_JAVA_OPTS= 속성 을 -Dcom.ibm.tools.attach.enable=no 로 변경하십시오 -Dcom.ibm.tools.attach.enable=yes.
4. 에이전트를 다음 명령어로 다시 systemctl restart instana-agent시작하세요.
5. 힙 덤프가 생성되는 상황이 발생할 때까지 에이전트를 실행하십시오.
6. Linux 시스템에서 호스트 에이전트의 힙 덤프를 생성하려면 다음 명령을 실행하십시오:

   TS=`date +%s` && /opt/instana/agent/jvm/bin/jcmd `cat /opt/instana/agent/agent.pid` Heap.dump /tmp/agent-dump-$TS.phd  && gzip /tmp/agent-dump-$TS.phd

   이 명령은 힙 덤프를 생성하고 압축된 파일을. /tmp/agent-dump-<timestamp>.phd.zip에 저장합니다.

Windows 시스템에서 호스트 에이전트의 힙 덤프를 생성하려면 다음 단계를 수행하십시오:

임시 힙 덤프는 에이전트가 설정으로 -Dcom.ibm.tools.attach.enable=yes 실행될 때만 생성할 수 있습니다. 이 설정을 확인하려면 Instana UI에서 에이전트 관리 대시보드를 열고, 프로세스 대시보드 왼쪽에 있는 ‘ Instana ’ 에이전트 프로세스 엔터티로 이동한 다음, 프로세스 인자 목록에서 해당 com.ibm.tools.attach.enable 항목을 찾으십시오.

다음 단계는 Instana 에이전트가 기본 설치 경로인 에 설치되어 있으며 C:\Program Files\Instana\instana-agent , 에이전트가 Systemd 서비스로 실행 중이라고 가정합니다. Instana 에이전트를 다른 위치에 설치한 경우 경로를 수정해야 합니다.

1. Windows 호스트에 으로 로그인하십시오 Administrator.
2. 파일을 C:\Program Files\Instana\instana-agent\bin\setenv.bat 열어 편집하세요.
3. 로 시작하는 줄을 찾아서 SET EXTRA_JAVA_OPTS= 속성 을 -Dcom.ibm.tools.attach.enable=no 로 변경하십시오 -Dcom.ibm.tools.attach.enable=yes.
4. Microsoft 관리 콘솔(MMC)의 “서비스”에서 “ Instana 에이전트 서비스”를 찾아 서비스를 다시 시작하십시오.
5. 힙 덤프가 생성되는 상황이 발생할 때까지 에이전트를 실행하십시오.
6. 다음 컨텐츠를 사용하여 이 파일 C:\Users\Administrator\agent-dump.ps1을(를) 작성하십시오.

   $TS = [int][double]::Parse((Get-Date -UFormat %s))
   $AGENT_PID = (Get-Content "C:\Program Files\Instana\instana-agent\agent.pid")
   C:\"Program Files"\Instana\instana-agent\jvm\bin\jcmd $AGENT_PID Dump.heap C:\Windows\Temp\agent-dump-$TS.phd
   Compress-Archive -Path C:\Windows\Temp\agent-dump-$TS.phd -DestinationPath C:\Windows\Temp\agent-dump-$TS.phd.zip -Force
   Remove-Item C:\Windows\Temp\agent-dump-$TS.phd

7. 관리자 권한으로 실행되는 PowerShell 을 엽니다.
8. 다음 명령을 실행하여 계정으로 SYSTEM 힙 덤프를 수행하는 파일을 ScheduledTask 생성하고 실행하십시오:

   $SchedScript = New-ScheduledTaskAction -Execute "PowerShell.exe" -Argument '-ExecutionPolicy Bypass -file C:\Users\Administrator\agent-dump.ps1'
   Register-ScheduledTask -User SYSTEM -taskname !_AgentDump -Action $SchedScript | Out-Null
   Start-ScheduledTask -TaskName "!_AgentDump" 
   Unregister-ScheduledTask -TaskName "!_AgentDump" -Confirm:$false

   이 명령은 힙 덤프를 생성하고 압축된 파일을. C:\Windows\Temp\agent-dump-<timestamp>.phd.zip에 저장합니다.

에이전트 자체 프로파일러 기능을 사용하여 Instana 호스트 에이전트의 성능 지표를 분석할 수 있습니다.

자체 프로파일러는 x86_64-bit 아키텍처를 사용하는 Linux 시스템에서만 지원됩니다. {: note} 호스트 에이전트를 자체 프로파일링하려면 다음 단계를 수행하십시오

1. 에이전트 대시보드의 ‘지원’ 섹션에서 ‘에이전트 프로필’을 클릭합니다. 프로파일러는 10분 동안 실행됩니다. 에이전트 로그를 확인하면 프로파일러가 실행되었는지 확인할 수 있습니다. 다음 예를 참조하십시오.

   2025-03-19T14:21:48.077+00:00 | INFO  | instana-executor-thread-2-1      | ndRequestHandler | com.instana.agent-self-profiling - 1.0.0 | Starting Agent profiler for 10 minutes
   2025-03-19T14:21:52.998+00:00 | INFO  | instana-scheduler-thread-3-4     | Profiler         | com.instana.agent-self-profiling - 1.0.0 | Profiler installed
    

2. 프로파일러를 시작한 후 2분간 기다렸다가 대시보드를 새로 고침하세요. 에이전트 대시보드에 ‘프로필 분석 ’이라는 새 버튼이 나타납니다.

3. ‘프로필 분석’ 버튼을 클릭하면 ‘프로필 분석’ 페이지가 열립니다.

4. ‘프로필 분석 ’ 페이지에서 ‘모두 보기’를 클릭합니다. IBM 지원팀에서 에이전트 성능 분석을 위해 요청하는 추가 정보와 함께 플레임 그래프를 공유할 수 있습니다.

모니터링 문제 유형: agent_tmp_directory_missing

Instana 호스트 에이전트는 $TMP/.instana 디렉터리에 임시 JAR 파일을 생성합니다. 이 JAR 파일들은 JVM 모니터링에 필요합니다. 이 경고는 필요한 JAR 파일이 누락되었거나 Instanatmp 디렉터리에 접근할 수 없음을 나타내며, 이로 인해 Java 첨부 파일 관련 문제가 발생할 수 있습니다. Instana 에이전트는 Java 첨부 파일 전송 오류를 방지하기 위해 Instanatmp 디렉터리와 관련 JAR 파일의 상태를 주기적으로 모니터링합니다.

이 문제를 방지하려면 해당 tmp 위치에 읽기 및 쓰기 권한이 /tmp 있는지 확인하고, 불필요한 정리 작업을 피하십시오.

모니터링 문제 유형: insufficient-disk-space-for-tmp-directory

실행 시, Instana 에이전트 컨테이너는 $TMP/.instana 디렉터리에 임시 JAR 파일을 생성합니다. 이 JAR 파일들은 JVM 모니터링에 필요합니다. 이 경고는 임시 파일을 저장할 공간이 tmp 부족함을 나타내며, 이로 인해 Java 첨부 파일 전송에 실패할 수 있습니다. 이 문제를 해결하려면 컨테이너 배치에서 tmp 에 할당된 공간을 늘리십시오.

모니터링 문제 유형: pax_url_mvn_leak

OPS4J 의 Pax URL 버전에는 에이전트 업데이트의 일환으로 2.6.16 24시간마다 초기화되는 메모리 누수 현상이 있습니다. 이 기간 동안 중지 및 시작된 센서의 수에 따라 에이전트에서 오류가 OutOfMemoryError 발생할 수 있습니다. 이 문제를 해결하기 위해, 2025년 6월 18일 이후에 출시되는 에이전트 어셈블리에 수정 사항이 적용됩니다. 이러한 모니터링 문제가 발생하면, Instana 에이전트 어셈블리를 2025년 6월 18일 또는 그 이후에 출시된 버전으로 업데이트하십시오.

이 문제에 대한 자세한 내용은 pax-urlGitHub 저장소의 해당 이슈 와 풀 리퀘스트를 참조하십시오.

모니터링 문제 유형: agent_jvm_tls_1_3_missing

Instana 에이전트는 설치된 호스트에서 지원되어야 TLSv1.3 합니다. 이 기능이 TLSv1.3 지원되지 않으면 모니터링 성능이 저하됩니다.

이 문제를 해결하려면 Instana 에이전트 TLS 버전을 로 TLSv1.3업데이트하십시오. 다음 TLS 버전이 지원됩니다: TLSv1, TLSv1.1, TLSv1.2, TLSv1.3. 자세한 내용은 에이전트 엔드포인트에 대한 TLS 암호화 설정을 참조하십시오.

모니터링 문제 유형: solaris_jspawnhelper_executable_issue

이 모니터링 문제는 Solaris 호스트에 있는 jspawnhelperJVM 파일에 실행 권한이 없음을 나타냅니다.

Solaris 의 JVM 파일 권한 문제를 해결하려면, 다음 명령어를 사용하여 JVM 경로에 있는 jspawnhelperJVM 파일에 실행 권한을 부여하십시오:

chmod +x <jvm-path>/jspawnhelper
 

Java 9 이상에서는 JVM 경로를 다음과 같이 지정하십시오 *instanaAgentDir*/jvm/jre/lib/jspawnhelper. Java 의 이전 버전의 경우, JVM 경로를 다음과 같이 지정하십시오 *instanaAgentDir*/jvm/jre/lib/sparcv9/jspawnhelper.