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 Agent の下にあるエージェントをクリックします。
  2. 特定の監視ホストをクリックします。
  3. ホストダッシュボードで、[ エージェント管理を開く] をクリックします。

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

オンライン編集

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

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

EXPORT <variable_name>="<value>"

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

一時ファイルの削除

オンライン編集

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