Windows でのホストエージェントの管理

オンラインで編集する

エージェントをインストールした後、必要に応じてエージェントを設定し、管理してください。 Windows で利用可能なエージェント設定オプションのすべてについては、以下のリストを参照してください：

ホストエージェント設定のカスタマイズ

オンラインで編集する

ホストエージェントをインストールすると、デフォルトで以下の設定ファイルが作成されます：

*agent-path*\etc\mvn-settings.xml
*agent-path*\etc\org.ops4j.pax.url.mvn.cfg
*agent-path*\etc\instana\com.instana.agent.bootstrap.AgentBootstrap.cfg
*agent-path*\etc\instana\com.instana.agent.main.config.Agent.cfg
*agent-path*\etc\instana\com.instana.agent.main.config.UpdateManager.cfg
*agent-path*\etc\instana\com.instana.agent.main.sender.Backend.cfg
*agent-path*\etc\instana\configuration.yaml

通常、 Windows におけるエージェントパスは. です C:\Program Files\Instana\instana-agent。

エージェントのコンフィギュレーションは、必要に応じてカスタマイズすることができます。 たとえば、ホストエージェントが接続する Instana バックエンドおよびサービスの TCP ポートやホスト名を変更したり、エージェントが複数のバックエンドに報告するように設定したり、ホストエージェントから Instana バックエンドへの通信を間接的に行うためのプロキシを設定したりすることができます。

エージェント設定のカスタマイズの詳細については、以下のトピックを参照してください：

エージェントの開始

オンラインで編集する

ホストエージェントをインストールすると、システム起動時に自動的に起動します。 この動作を無効にするには、インストール時に INSTANA_AGENT_AUTOSTART=false 環境変数を設定してください。

ホスト・エージェントを起動するには、以下のコマンドを実行する：

<instana-agent-install-dir>\bin\start.bat

エージェントの停止

オンラインで編集する

エージェントを停止するには、以下のコマンドを実行する：

<instana-agent-install-dir>\bin\stop.bat

ホストエージェントの更新

オンラインで編集する

Windows のホストエージェントは、インストール方法に応じて2つの方法で更新できます。

注： エージェントを正しく更新するには、元のインストールと同じパッケージングモードおよびランタイムを持つエージェントのバージョンを使用するようにしてください。

エージェントをインタラクティブに更新する（オンラインおよびエアギャップ環境）

オンラインで編集する

Windows インストーラを使用して対話形式でインストールされたホストエージェントを更新するには、以下の手順を実行してください：

  1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。
  2. 必要なパッケージタイルを選択する。 例えば、 Windows - Windows インストーラー 64Bit および Windows - エアギャップ環境用（アーカイブ、インストーラー）。
  3. Windows 用 - Windows インストーラー 64Bit のみ、パッケージングモードとランタイムは元のインストール時と同じものを選択してください。
  4. ダウンロードリンクをクリックして、「 Windows 」のインストーラーファイルを保存してください。
  5. Windows のホストコンピュータで、 Windows インストーラを実行してください。

インストールウィザードは、エージェントのアップグレードのプロセスをガイドします。

エージェントのサイレントアップデート

オンラインで編集する

Windows インストーラーを使用してサイレントインストールされたホストエージェントを更新するには、以下の手順を実行してください：

  1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。
  2. 必要なパッケージタイルを選択する。 例えば、 Windows - Windows Installer 64Bit (無人インストール) および Windows - Elastic Computing ( EC2 ) - Windows 64Bit。
  3. 元のインストールと同じパッケージング・モードとランタイムを選択します。
  4. ダウンロードリンクをクリックして、「 Windows 」のインストーラーファイルを保存してください。
  5. UIからコマンドラインをコピーし、 Windows のホストコンピュータで実行してください。

アップデートプロセスは、エージェントを最新バージョンにアップグレードするプロセスを通して静かに実行されます。

ZIPアーカイブを使用したエージェントのアップデート

オンラインで編集する

ZIPアーカイブを使用してインストールされたホストエージェントを更新するには、以下の手順を実行します：

  1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。
  2. 必要なパッケージタイルを選択する。 例えば、 Windows - Zipアーカイブ。
  3. 元のインストールと同じパッケージモードを選択します。
  4. 32ビット版または64ビット版の Windows のダウンロードリンクをクリックして、ファイルを .zip 保存してください。
  5. ダウンロードした .zip ファイルを、 Windows のホストコンピュータ上の任意のフォルダ（<instana-agent-install-dir>）に解凍してください。

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

オンラインで編集する

Instana のUIにある「エージェント管理」ダッシュボードを使用すると、以下の操作を行うことができます：

エージェント管理ダッシュボードを開くには、以下の手順に従ってください：

  1. Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。 あるいは、ホストの概要画面で、 「 Instana エージェント 」の下にあるエージェントをクリックします。
  2. 特定の監視ホストをクリックします。
  3. ホストダッシュボードで、[エージェント管理を開く]をクリックします。

環境変数の設定とオーバーライド

オンラインで編集する

「 Windows 」のレジストリエディタを使用すると、 Windows 上の Instana エージェントの環境変数を設定または上書きできます。

環境変数を設定、変更、または上書きするには、 Windows のレジストリエディタで「 InstanaComputer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\instana-agent-service 」のレジストリキーに移動し、新しい環境変数を追加するか、既存の環境変数を編集します。

一時ファイルの削除

オンラインで編集する

Instana ホストエージェントは、必要なファイルを ディレクトリ /Temp/instana/ にインストールします。 これらのファイルがホストの稼働時間中に削除されると、更新時に問題が発生する可能性があります。

Instana エージェントをアンインストールすると、すべての一時ファイルが自動的に削除されます。 手動で一時ファイルを消去するには、「Windows/Temp/instanaフォルダの内容を削除する。