Link Agent設定ファイル

Link Agent設定ファイルの使用方法

Link Agentを設定するには、コマンドラインでオプションを渡す方法に加え、設定ファイルを使用することもできます。起動時に設定ファイルを読み込ませるには、次のコマンドライン引数のいずれかを使用します。

--config /path/to/config.json
# Or:
-c /path/to/config.json

設定ファイルの形式はJSONになっており、Link Agentディストリビューションのルートにあるconfig.example.jsonファイルを設定ファイルのサンプルとして参考にしていただけます。一般的に使用される設定オプションの例を以下に示します。

{
  "disableAutoUpdates": false,
  "httpProxy": {
    "host": "host",
    "port": 1234
  },
  "proxyAuth": {
    "password": "password",
    "username": "username"
  },
  "proxyExclusions": [
    "localhost",
    "127.0.0.1"
  ],
  "proxyMode": "all",
  "tunnels": [
    {
      "apiKey": "apiKey1",
      "name": "name1"
    },
    {
      "apiKey": "apiKey2",
      "name": "name2"
    }
  ]
}

Link Agentが複数のトンネルを管理するための設定

1つの設定ファイルで複数のトンネルを定義することが可能です。その場合、同じLink Agentインスタンスが、設定ファイルに指定されたすべてのトンネルを確立します。同じLink Agentに複数のトンネルを統合することで、管理するエージェントインスタンスの数を減らすことができ、特に小規模のトンネルが複数ある場合に便利です。複数のトンネルを同じLink Agentに統合する場合の注意事項については、以下の注記を参照してください。

🚧

複数のトンネルを統合するとパフォーマンスと安定性に影響を与えることがあります

同じLink Agentインスタンスに複数のトンネルを統合する場合には、注意が必要です。同じLink Agentで処理されるトラフィックが増えると、メモリやCPUの要件が上昇する可能性があります。同じLink Agentインスタンスに複数のトンネルを統合する前に、まずLink Agentが動作しているホストの現在のリソース使用量を把握しておくことをお勧めします。トンネルは一度に1つずつ追加します。各トンネルを追加した後で、エージェントログファイルでエラーを監視し、ホストのメモリやCPUの使用率が以前に比べてどのように変化したかを観察します。正確な測定を行うには、管理対象のすべてのトンネルでテストがアクティブになっているときにホストを監視することが重要です。リソース使用率の平均値とピーク値を観察し、必要に応じてホストのメモリとCPUリソースを増やします。また、JVMが利用できるメモリを増やすことが必要な場合もあります。