エージェント設定ファイルの設定

Instana のホストエージェントの動作は、ファイル com.instana.agent.main.config.Agent.cfg の設定を変更することで構成します。

エージェントの設定ファイルは、ネットワーク設定、動作モード、連携機能など、エージェントの中核となる機能を制御します。 これらの設定は、監視要件やインフラ環境に合わせてカスタマイズできます。

ファイルの場所: <instana-agent-dir>/etc/instana/com.instana.agent.main.config.Agent.cfg

構成パラメーター

backchannel.enabled

タイプ Default 必須
ブール true いいえ

エージェントが、 Instana のUIからのコマンド(エージェントの再起動やエージェントからのログのダウンロードなど)に応答できるようにします。

http.listen

タイプ Default 必須
ストリング なし いいえ

エージェントが監視対象のアプリケーションからの着信トラフィックを待機するネットワークインターフェースのIPアドレスを設定します。 詳細については、 「ネットワークリファレンス」 を参照してください。

http.threads

タイプ Default 必須
整数 4 いいえ

監視対象のアプリケーションからのデータを含む、 HTTP への着信トラフィックを処理するスレッド数を設定します。

mode

タイプ Default 必須
ストリング APM いいえ

エージェントモードを設定します。 指定可能な値は、APMINFRASTRUCTUREAWS、および OFFです。

mode.web-override.allowed

タイプ Default 必須
ブール true いいえ

Instana のUIからエージェントモードを変更できるようにします。

scheduler.threads

タイプ Default 必須
整数 4 いいえ

エージェントが実行する各種のスケジュールされたタスクや非同期タスクに使用可能なスレッド数を設定します。

source.download.enabled

タイプ Default 必須
ブール true いいえ

エージェントが監視対象プロセスのソースコードを Instana のUIにアップロードできるようにし、そのソースコードをトレースデータに関連付けることができます。

uniqueAgentId

タイプ Default 必須
ストリング なし いいえ

静的なエージェントIDを設定します。 詳細については、 「MACアドレスの重複によるエージェントIDの競合」 を参照してください。

use-cloud-provider-id

タイプ Default 必須
ブール false いいえ

エージェントに対し、クラウドプロバイダーから提供されたIDをエージェントIDとして使用するよう指示します。

注:
use-cloud-provider-id: のデフォルト値に関しては、既知の不整合があります:
  • use-cloud-provider-id = falseが指定されていない場合 use-cloud-provider-id 、エージェントはデフォルトで に設定されます。
  • エージェントのインストール中、エージェントインストーラーは、拡張子が use-cloud-provider-id = true. であるデフォルト com.instana.agent.main.config.Agent.cfg のファイルを作成します。
  • コンテナ化された動的エージェントはデフォルトで を使用して use-cloud-provider-id = true 実行されますが、コンテナ化された静的エージェントはデフォルトで を使用して use-cloud-provider-id = false 実行されます。