ホスト・エージェントの管理

前提条件を満たしている場合は、構成管理を開始できます。

構成管理が有効になっていない場合は、 「構成管理 」セクションの をクリック 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 を探してください。

以下の手順では、 /opt/instana/agentInstana エージェントがデフォルトのインストール先である にインストールされており、Systemdサービスとして実行されていることを前提としています。 Instana エージェントを別の場所にインストールした場合は、パス設定を行う必要があります。

1. Linuxroot ホストにユーザーとしてログインするか、シェルセッションをユーザー 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 を探してください。

以下の手順では、 C:\Program Files\Instana\instana-agentInstana エージェントがデフォルトのインストール先である にインストールされており、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 Management Consoleの「サービス」で、「 Instana Agent Service」を探し、そのサービスを再起動します。
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. 以下のコマンドを実行して、`root` アカウント 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 サポートからエージェントのパフォーマンス分析のために求められた追加情報とともに、 Flameグラフを共有することができます。

監視対象の種類： 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 バージョンには、エージェントの更新の一環として24時間 2.6.16 ごとにリセットされるメモリリークが存在します。 この期間中に停止および起動されるセンサーの数によっては、エージェントでエラー OutOfMemoryError が発生する可能性があります。 この問題に対処するため、 2025年6月18日以降にリリースされるエージェント・アセンブリに修正が追加されます。 この監視に関する問題が発生した場合は、 Instana エージェントのアセンブリを、2025年6月18日以降にリリースされたバージョンに更新してください。

この問題に関する詳細については、 GitHub pax-url リポジトリ内の当該イシュー および対応するプルリクエストをご覧ください。

監視対象の種類： 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 ホスト上の JVMjspawnhelper ファイルに実行権限が設定されていないことを示しています。

Solaris の JVM ファイルの権限の問題を解決するには、次のコマンドを使用して、 JVM パスにある JVMjspawnhelper ファイルに実行権限を付与してください：

chmod +x <jvm-path>/jspawnhelper
 

Java 9 以降では、 JVM*instanaAgentDir*/jvm/jre/lib/jspawnhelperのパスを次のように指定します。 Java の以前のバージョンでは、 JVM*instanaAgentDir*/jvm/jre/lib/sparcv9/jspawnhelperのパスを次のように指定してください。