エージェント設定ファイルの設定
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 |
いいえ |
エージェントモードを設定します。 指定可能な値は、APM、INFRASTRUCTURE、AWS、および 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実行されます。