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

オンラインで編集

Instana に報告するすべてのエージェントは、 [エージェント] ページを使用して表示および管理できます。

エージェントページを開くには、 Instana UIのナビゲーションメニューから、 [データソース ] > [ Instana エージェント ] を選択します。

Instana エージェントタブには、以下の情報が表示されます：

  • エージェント総数 : Instana テナント単位で設定されているエージェントの総数を表示します（ レポート対象および非対象を含む）。
  • 報告エージェント ：選択した期間内に Instana テナントユニットに報告する全エージェントのチャートを提供します。 選択した期間中に報告しないエージェントは除外されます。 バーを選択して詳細を拡大表示したり、全チャートで詳細をハイライト表示したり、データを JSON および CSV 形式でエクスポートできます。
  • エージェント詳細 ：全エージェントの概要を迅速に提供します。主要な特性とステータスを含みます。
注： ページ上の検索バーを使用して、エージェントの詳細を一部に絞り込んでください。 詳細については、 動的フォーカス クエリを参照してください。

さらに、 エージェントページから直接以下の操作を実行できます：

  • すべてのエージェントの更新: すべてのレポート・エージェントを最新バージョンに更新します。
  • すべてのエージェントのリセット: すべてのレポート・エージェントをリセットします。
  • エージェントのインストール： エージェントのデプロイページを開きます。 必要なエージェントをグリッドから選択すると、そのインストールページが開きます。
  • エージェントベースの統合をインストール:ワンライナーインストールを使用して、 IBM 監視統合サービスをインストールします。 詳細については、 エージェントベースの統合を参照してください。
注: これらのオプションを表示するには、ユーザーアカウントに Configuration of agents 権限を持つロールが必要です。 ユーザー、ロール、および権限の詳細については、 「ユーザーアクセスの管理」 を参照してください。

エージェントダッシュボードを使用したエージェント管理

オンラインで編集

個々のエージェントを管理するには、そのダッシュボードを開く必要があります。 エージェントダッシュボードを使用することで、重要な指標に関するリアルタイム情報を確認し、必要に応じてエージェントを設定できます。

エージェントの詳細テーブルからエージェントを選択すると、そのエージェントのダッシュボードが開きます。

または、 Instana UI のナビゲーションメニューで 「Infrastructure」 をクリックしてください。 必要なホストを選択し、 「ダッシュボードを開く」 をクリックしてください。 ホストダッシュボードで、一番下までスクロールし、 「エージェント管理を開く」 をクリックします。

エージェントダッシュボードを使用して、以下のタスクを実行できます：

エージェントモードの変更

オンラインで編集

ホストベースのライセンスには、ホストエージェントモードを指定する必要があります。 ホストエージェントモードは、エージェントがインフラストラクチャエージェントかAPMエージェントかを識別するために使用されます。

エージェントモードを変更するには、 [エージェントモードの変更] をクリックしてください。 変更エージェントモードダイアログで、ドロップダウンリストから必要なエージェントモードを選択します。 リストでは以下のモードが利用可能です：

  • APM : APM ホストエージェントモードを示します。
  • インフラストラクチャ : INFRASTRUCTURE ホストエージェントモードを示します。
  • 無効 : OFF ホストエージェントモードを示します。
注: モードを に設定した場合 Disabled、エージェントはデータを一切報告せず、管理対象の Virtual Servers （ MVS ）のカウントに含まれません。

ログレベルの変更

オンラインで編集

ログレベルを設定することで、エージェントログに含まれる詳細レベルを指定できます。

ログレベルを変更するには、 [ログレベルを変更] をクリックしてください。 変更ログレベルダイアログで、ドロップダウンリストから必要なレベルを選択してください。 リストでは以下のレベルが利用可能です：

  • INFO : 通常レベルの詳細を提供します。
  • DEBUG : トラブルシューティングのための詳細情報を提供します。

エージェントの更新

オンラインで編集

「エージェントの更新 」をクリックすると、動的エージェントの更新を手動で開始できます。 詳細については、 「動的ホストエージェントの更新設定」 を参照してください。

注： 更新中は、ホストエージェントは一切のデータを提供できません。

リセット剤

オンラインで編集

エージェントとセンサーをリセットするには、 [エージェントをリセット] と [センサーをリセット] をクリックします。

エージェントのリセットはエージェントの再起動プロセスと似ていますが、現在のプロセスはアクティブなままです。 これは、OSレベルの監視プロセスやサービススクリプトがプロセス識別子（pidPID）の変化を検知しないことを意味します。

注記： リセット中は、ホストエージェントは一切のデータを提供できません。

再起動エージェント

オンラインで編集

エージェントを再起動すると、現在のエージェントプロセスを停止し、新しいプロセスを作成できます。

使用される起動スクリプトのプロセスは変更されませんが、監視対象に応じて、オペレーティングシステムレベルの監視プロセスやサービススクリプトは変更されたプロセス識別子（pidPID）を検知する可能性があります。

注記: 再起動中は、ホストエージェントは一切のデータを提供できません。

エージェントとセンサー情報の表示

オンラインで編集

エージェントによって使用されるセンサーおよびホスト・エージェント・コンポーネントのリストを表示するには、「センサー情報」をクリックします。

エージェント設定を表示するには、 [エージェント設定] をクリックしてください。

エージェントログをダウンロードするには、 [エージェントログ] をクリックしてください。

Git ベースの構成管理の有効化

オンラインで編集

エージェントダッシュボードの 「構成管理 」セクションから、 Git ベースの構成管理を有効化および設定できます。

構成管理には以下の前提条件が必要です：

  • お使いのマシンにはバージョン 1.2.11 以降 agent-bootstrap がインストールされています。
  • あなたのユーザーアカウントには、[権限名] 権限 Configuration of agents を持つロールが割り当てられています。 ユーザー、ロール、および権限の詳細については、 「ユーザーアクセスの管理」 を参照してください。

構成管理の初期化

オンラインで編集

前提条件を満たしている場合、構成管理を初期化できます。

構成管理がアクティブでない場合、 [構成管理] セクション Initialize の をクリックして、 Git ベースの構成管理を初期化します。

次に、構成管理ダイアログに以下の情報を入力します：

  • リモート名 : Git リモートの名前。
  • リモートブランチ : 更新に使用するブランチの名前。
  • リモート URI : Git リポジトリの URI。

「初期化と再起動」 をクリックすると、設定に基づいてエージェントが構成され、最新の設定を取得するために再起動されます。

構成管理の更新

オンラインで編集

構成管理が既に有効になっている場合、その詳細は「 構成管理 」セクションで確認できます。 詳細には、設定済みリモートの情報（ブランチ名やURIなど）と、現在使用中のコミットの情報（ハッシュやコミットメッセージなど）が含まれます。

設定を更新するには、 [更新] をクリックし、[構成管理]ダイアログに必要な詳細情報を入力してください。

「更新と再起動」 をクリックして、設定に基づいてエージェントを構成し、最新の設定を取得するために再起動します。

エージェントの監視

オンラインで編集

Instana エージェントは、自身を監視し、パフォーマンスとリソース消費に関するメトリクスを収集します。 これらのメトリクス（監視対象の問題、CPU負荷、ガベージコレクション、ネットワークなど）は、エージェントダッシュボードで確認できます。 メトリクスには、センサーおよびエージェントのログ出力に関する情報も含まれます。

エージェントによって収集されるメトリクスに関する詳細については、 エージェントのメトリクスを参照してください。

エージェントのデバッグ

オンラインで編集
エージェントが使用している Java ランタイムを特定してください。 エージェントは、 HotSpot-based Java のランタイムまたは OpenJ9-based Java のランタイムのいずれかで動作します。 エージェントの基盤となる Java ランタイムを特定するには、 Instana UIのエージェント管理ダッシュボードに移動し、 設定ウィンドウの「 Java ランタイム」プロパティを確認してください：
  • HotSpot-based Java ランタイムは自身を識別する OpenJDK
  • OpenJ9-based Java ランタイムは. OpenJ9 として識別される

Linux 上のホストエージェント向けに、 HotSpot-based Java ランタイムを使用したヒープダンプを作成する

オンラインで編集

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 上のホストエージェント向けに、 HotSpot-based Java ランタイムを使用したヒープダンプを作成する

オンラインで編集

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 上のホストエージェントに対して、 OpenJ9-basedJava ランタイムでヒープダンプを作成する

オンラインで編集

Linux システム上でホストエージェントのヒープダンプを作成するには、次の手順を完了してください：

アドホックなヒープダンプは、エージェントが設定 -Dcom.ibm.tools.attach.enable=yes で実行されている場合にのみ作成できます。 この設定を確認するには、 Instana UI でエージェント管理ダッシュボードを開き、プロセスダッシュボードの左側にある「 Instana 」エージェントプロセスエンティティに移動し、プロセス引数リスト内の com.ibm.tools.attach.enable を確認してください。

以下の手順は、 Instana エージェントがデフォルトの場所（ /opt/instana/agent /usr/local/lib/lib64/lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64- Instana エージェントを別の場所にインストールした場合は、パスを設定する必要があります。

注： エージェントが既に設定 -Dcom.ibm.tools.attach.enable=yes で実行されている場合は、手順1から4をスキップできます。
  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 上のホストエージェントに対して、 OpenJ9-basedJava ランタイムでヒープダンプを作成する

オンラインで編集

Windows システム上でホストエージェントのヒープダンプを作成するには、次の手順を完了してください：

アドホックなヒープダンプは、エージェントが設定 -Dcom.ibm.tools.attach.enable=yes で実行されている場合にのみ作成できます。 この設定を確認するには、 Instana UI でエージェント管理ダッシュボードを開き、プロセスダッシュボードの左側にある「 Instana 」エージェントプロセスエンティティに移動し、プロセス引数リスト内の com.ibm.tools.attach.enable を確認してください。

以下の手順は、 Instana エージェントがデフォルトの場所（ C:\Program Files\Instana\instana-agent /usr/local/lib/lib64/lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64-lib64- Instana エージェントを別の場所にインストールした場合は、パスを設定する必要があります。

注： エージェントが既に設定 -Dcom.ibm.tools.attach.enable=yes で実行されている場合は、手順1から4をスキップできます。
  1. WindowsAdministratorホストにとしてログインしてください。
  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 エージェントサービス」を探し、サービスを再起動します。
  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グラフを共有できます。

Instana エージェントが /tmp ディレクトリを欠いています

オンラインで編集

監視対象の問題タイプ： agent_tmp_directory_missing

Instana ホストエージェントは、ディレクトリ $TMP/.instana 内に一時的なJARファイルを作成します。 これらのJARファイルは、 JVM の監視に必要です。 この警告は、必要なJARファイルが欠落しているか、 Instanatmp ディレクトリが利用できないことを示しており、これにより Java の添付ファイルに関する問題が発生する可能性があります。 Instana エージェントは、 Java の添付失敗を防ぐため、 Instanatmp ディレクトリとその関連JARファイルの状態を定期的に監視します。

この問題を回避するには、対象 tmp の /tmp 場所に対して読み取りおよび書き込み権限があることを確認し、不要なクリーンアップを避けてください。

ディレクトリ /tmp に十分なディスク容量がありません

オンラインで編集

監視対象の問題タイプ： insufficient-disk-space-for-tmp-directory

実行時、 Instana エージェントコンテナはディレクトリ内に一時的なJARファイルを作成します $TMP/.instana 。 これらのJARファイルは、 JVM の監視に必要です。 この警告は、一時ファイルを収容するのに十分な空き容量が tmp 指定された場所にないことを示しており、 Java の添付ファイル送信に失敗する可能性があります。 この問題に対処するには、コンテナデプロイメント内の tmp に割り当てられたスペースを増やしてください。

Paxにおけるメモリリーク URL 2.6.16

オンラインで編集

監視対象の問題タイプ： pax_url_mvn_leak

OPS4J Pax URL バージョンには、エージェント更新の一環として24時間 2.6.16 ごとにリセットされるメモリリークが存在します。 この期間中に停止および起動されるセンサーの数によっては、エージェントがエラー OutOfMemoryError に遭遇する可能性があります。 この問題に対処するため、 2025年6月18日以降にリリースされるエージェントアセンブリに修正が追加されます。 この監視の問題に気付いた場合は、 Instana エージェントアセンブリを2025年6月18日以降にリリースされたバージョンに更新してください。

この問題に関する詳細は、 GitHub pax-url リポジトリ内の該当する問題とプルリクエストを参照してください。

Instana エージェントに対する TLSv1.3 サポートが不足しています

オンラインで編集

監視対象の問題タイプ： 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 JVM ファイル権限の問題

オンラインで編集

監視対象の問題タイプ： solaris_jspawnhelper_executable_issue

この監視問題は、 jspawnhelperSolaris ホスト上の JVM ファイルに実行権限がないことを示しています。

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。

このトラブルシューティングセクションで問題が解決しない場合は、ご使用環境に関する情報を添えて IBM Instana サポートまでお問い合わせください。