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

オンラインで編集する

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

ホストエージェントの設定に関する詳細については、 「ホストエージェントの設定」 を参照してください。

ホストエージェントの状態の確認

オンラインで編集する

ホストエージェントのインストール後、 Instana のUIにある「エージェント」ダッシュボードでステータスを確認できます。 「エージェント」ダッシュボードを表示するには、 Instana のUIにあるナビゲーションメニューから 「その他」 > 「エージェント」 をクリックします。

ホストエージェントのリストからホストエージェントを見つけるには、'Windowsような単純な文字列、またはホストの完全修飾ドメイン名（FQDN）、またはクエリ構文を使用するより複雑な文字列で検索バーを使用することができます。 詳細については、検索バーの (?) をクリックするか、 「動的フォーカスによるフィルタリング」 のトピックをご覧ください。

UNIX上でホスト・エージェントのステータスをチェックするには、以下のコマンドを実行する：

*instanaAgentDir*/bin/status

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

オンラインで編集する

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

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

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

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

エージェントの起動、停止、更新

オンラインで編集する

UNIX上でホスト・エージェントを起動、停止、更新する方法については、以下のセクションを参照してください：

エージェントの開始

オンラインで編集する

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

*instanaAgentDir*/bin/start

エージェントの停止

オンラインで編集する

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

*instanaAgentDir*/bin/stop

エージェントの更新

オンラインで編集する

ホストエージェントを更新する前に、以下の既存のエージェント設定ファイルのコピーを取ってください。 これらのファイルをアップグレードしたエージェントファイルに追加して、既存の設定を保持することができます。

  • /instana/com.instana.agent.main.config.Agent.cfg
  • /instana/com.instana.agent.bootstrap.AgentBootstrap.cfg
  • /instana/com.instana.agent.main.config.UpdateManager.cfg
  • /instana/configuration.yaml
  • /instana/bin/setenv

UNIX上でホスト・エージェントを更新するには、以下の手順を実行します：

  1. Instana UIのホームページで、 「エージェントとコレクター」 をクリックします。 [ Instana ] の [エージェント] タブで、 [エージェントのインストール] を選択します。

  2. UNIXというタイルをクリックする。

  3. 動的または静的エージェントをインストールするパッケージングオプションを選択します。

  4. ドロップダウンメニューで、プラットフォームアーキテクチャを選択します。

  5. ダウンロードリンクをクリックして、ホストエージェントの最新バージョンをダウンロードしてください。

  6. 以下のコマンドを実行して、既存のエージェントを停止する：

    *instanaAgentDir*/bin/stop

  7. 既存のエージェントパッケージディレクトリを削除します。

  8. Instana のUIからダウンロードした新しいパッケージを解凍してください。

  9. エージェント設定ファイルを新しいパッケージディレクトリにコピーし、設定を保持します。

  10. 以下のコマンドを実行してエージェントを開始します。

    *instanaAgentDir*/bin/start

エージェントは最新バージョンに更新されます。

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

オンラインで編集する

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

エージェント管理ダッシュボードを開くには、以下の手順を実行します：

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

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

オンラインで編集する

UNIX上の Instana エージェントの環境変数は、ファイル setenv を使用して設定または上書きできます。

*instanaAgentDir*/bin/フォルダで「setenvファイルを開く。 必要な環境変数を以下のフォーマットでファイルの最後に追加し、ファイルを保存する：

EXPORT <variable_name>="<value>"

setenvファイルの内容は、エージェントを更新すると上書きされます。 環境変数を保持するため、更新プロセスを開始する前に、必ず「setenvファイルのコピーを保存しておくこと。

一時ファイルの削除

オンラインで編集する

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