Docker での Instana エージェントの管理
エージェントをインストールした後、必要に応じてエージェントを設定および管理します。 Docker で利用可能なエージェント構成オプションのすべてについては、以下のセクションを参照してください。
ホストエージェントの状態を確認する
ホストエージェントをインストールした後、 Instana のUIまたはホスト上で、ホストエージェントのステータスを確認できます。 詳細については、「ホストエージェントの状態の確認 」を参照してください。
エージェントの構成
必須の環境変数に加えて、起動時に追加の環境変数を設定することができます。 利用可能な変数に関する詳細については、 「ホストエージェントの環境変数」 を参照してください。
/root ディレクトリにメイン構成ファイルをマウントします。 エージェントアーカイブ（.tar）ファイルを解凍すると、ファイルがその場所にコピーされます。
ボリュームマウントでエージェント構成を上書きする
Docker のボリューム機能を使用することで、設定ファイルのスワップ設定を上書きすることができます。 イメージに付属するエージェント構成ファイル configuration.yaml は、デフォルト値を定義しており、上書きされない場合があります。 configuration-<custom-extension>.yaml というカスタム設定スニペットを使用して、ファイルを拡張することができます。以下にその方法を示します
--volume <host-path>/configuration-<custom-extension>.yaml:/opt/instana/agent/etc/instana/configuration-<custom-extension>.yaml
例： MySQL の認証情報用の configuration-mysql.yaml ファイルを設定し、コンテナの起動時にこの構成ファイルを追加することができます。
configuration-mysql.yaml
# Mysql
com.instana.plugin.mysql:
user: 'mysqlAdmin'
password: 'mysqlSecretPassword'
docker ボリュームのマウントを実行
--volume /opt/instana-agent/etc/instana/configuration-mysql.yaml:/opt/instana/agent/etc/instana/configuration-mysql.yaml
複数のバックエンドの設定
Instana エージェントは、複数のバックエンドにレポートを送信するように設定できます。 設定に関する一般的な注意事項については、 「複数のバックエンドの設定」 を参照してください。
Instana ホストエージェントにバックエンドを追加するには、. com.instana.agent.main.sender.Backend-2.cfg などのバックエンドファイルをマウントします。
コンテナ化エージェントの例については、以下の例を参照してください
--mount type=bind,source=<path-to-additional-backend-config>,target=/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend-2.cfg
エージェントリポジトリミラーの設定
INSTANA_SHARED_REPOSITORY_MIRROR_URLINSTANA_SHARED_REPOSITORY_MIRROR_USERNAMEINSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD
環境変数を使用して Maven リポジトリのミラーを設定する方法の詳細については、 「 Maven リポジトリのミラーの設定」 を参照してください。
エージェントのプロキシ設定
Instana エージェントは、2つの異なるエンドポイントに接続します。1つは、収集したすべてのデータを送信するための Instana バックエンドシステム、もう1つは、エージェントおよびセンサーの更新情報を取得するためのリポジトリです。 これらの両方のエンドポイントをプロキシ設定を使用するように構成することができます。 次の3つのアプローチが利用可能です
両方のエンドポイントでプロキシ設定なし — プロキシ設定の構成は不要。
バックエンドとリポジトリの両方で同じプロキシ設定を使用する — 「エージェント」プロキシ設定のみを構成する。
バックエンドとリポジトリのプロキシ設定が異なる — 両方のプロキシを個別に設定し、
INSTANA_REPOSITORY_PROXY_ENABLED=trueを設定してください。例えば、リポジトリのみにプロキシを設定する必要がある場合は、以下の設定を使用します
INSTANA_AGENT_PROXY_変数すべてを""(空ストリング) に設定します。- 設定
INSTANA_REPOSITORY_PROXY_ENABLED=true - 必要に応じて、
INSTANA_REPOSITORY_PROXY_のすべての変数をプロキシ構成に設定します。
同様に、エージェントプロキシ設定については、 INSTANA_AGENT_PROXY_ENABLED を有効にし、必要に応じてすべての INSTANA_AGENT_PROXY_ 変数をプロキシ構成に設定します。
更新とバージョンのピン留め
環境変数を使用することで、必要なエージェントの更新と固定バージョンを制御することができます。 詳細は、「コンテナ化エージェントのコントロールの更新 」を参照してください。
エージェント構成のカスタマイズ
ホストエージェントをインストールすると、以下の構成ファイルが作成されます
/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 バックエンドへの間接通信用にプロキシを設定したりすることができます。
エージェント構成のカスタマイズに関する詳細については、以下のトピックを参照してください
エージェントの開始および停止
エージェントの開始
ホストエージェントをインストールすると、システム起動時に自動的に起動するようになります。 この動作は、エージェントをインストールする際に環境変数 INSTANA_AGENT_AUTOSTART=false を設定することで無効にすることができます。
ホストエージェントを起動するには、次のコマンドを実行します
INSTANA_AGENT_FOLDER/bin/startお使いのオペレーティングシステムが
systemdをinitシステムとして使用している場合は、以下のコマンドを実行してくださいsystemctl start instana-agent.serviceお使いのオペレーティングシステムが
SysVinitをinitシステムとして使用している場合は、以下のコマンドを実行してくださいservice instana-agent start
エージェントの停止
エージェントを停止するには、次のコマンドを実行します
INSTANA_AGENT_FOLDER/bin/stop
エージェント管理ダッシュボードを使用してエージェントを管理する
Instana のUIにある「エージェント管理」ダッシュボードを使用すると、以下の操作を行うことができます：
エージェント管理ダッシュボードを開くには、以下の手順を完了します
- Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
- 特定の監視対象ホストをクリックします。
- ホストダッシュボードで、「エージェント管理を開く」 をクリックします。
GPUモニタリングの有効化
以下の NVIDIA グラフィック・カードがサポートされています。
| 商標 | モデル |
|---|---|
| Tesla | S1070, S2050, C1060, C2050/70, M2050/70/90, X2070/90, K10, K20, K20X, K40, K80, M40, P40, P100, V100 |
| Quadro | 4000、5000、6000、7000、M2070-Q、K シリーズ、M シリーズ、P シリーズ、RTX シリーズ |
| GeForce | さまざまなレベルのサポート。使用可能なメトリックの数は、Tesla と Quadro の製品よりも少ない。 |
前提条件
GPUの監視には、 Linux オペレーティングシステムが必要です。
また、以下のソフトウェアを必ずインストールしてください：
- Docker バージョン 以降。 19.03
- 最新の公式Nvidiaドライバー。 パッケージマネージャーを使用してインストールされたドライバーでは不十分です。
- NVIDIA コンテナツールキット。
GPU モニタリングを有効にするには、1 つ以上の GPU で Instana エージェント・コンテナーを開始します。 エージェントは特権コンテナーとして開始できます。
エージェントは、エージェントが実行する GPU の数に関係なく、システム全体で使用可能なサポート対象の GPU すべてのメトリックを収集します。
収集されるメトリクスの詳細な一覧については、 GPUドキュメントをご覧ください。
GPU を使用してエージェント・コンテナーを開始する方法は複数あります。
- 使用可能なすべての GPU で開始する場合は、
--gpus allフラグを指定します。 - 正確な数の GPU から開始するには、
--gpus <number of gpus to use>フラグを指定します。 - 目的の GPU で開始するには、
--gpus '"device=<gpu1-uuid>,<gpu2-uuid>"'フラグを指定します。