エージェントのログファイルサイズの設定
IIB エージェントによって、実行グループごとに個別のログファイルが作成されます。これにより、実行グループがインストゥルメント化されていない場合でも、各ログは継続的に増大していきます。
したがって、インストゥルメント化されていない実行グループのログに対する更新のプッシュを停止する必要が生じます。IIB エージェントでは、要件に応じてログファイルサイズを設定できるようになりました。
構成ファイルの次の設定では、controller-info.xml でエージェントのログファイルサイズを設定できます。
<log-settings>
<log-setting broker="" execution-group="">
<max-file-size></max-file-size>
</log-setting>
</log-settings>
設定は次のように定義されています。
| 設定 | 説明 |
|---|---|
| <log-settings></log-settings> | ヘッダータグ |
| <log-setting broker="" execution-group=""> | ブローカー名と実行グループ名(文字列にする必要があります) |
| <max-file-size> </max-file-size> | ログファイルの最大サイズ。形式は <number><unit> です。たとえば、5 MB です。有効な単位は "MB" または "KB" です。KB 単位の許容範囲は [200KB、999KB]、MB 単位の許容範囲は [1MB、999MB] です。すべての実行グループに独自のログファイルがあります。 |
ただし、設定の際は次のガイドラインに注意する必要があります。
- ブローカーに名前が付けられていない場合、設定がすべてのブローカーに適用されます。
- 実行グループに名前が付けられていない場合、設定がすべての実行グループに適用されます。
- 実行グループ名には、ブローカー名を付ける必要があります。
たとえば、次の構成では、ログ設定の 3 つのインスタンスがあります。
<controller-info>
<controller-host></controller-host>
<controller-port></controller-port>
<controller-ssl-enabled></controller-ssl-enabled>
<account-name></account-name>
<account-access-key></account-access-key>
<application-name></application-name>
<tier-name></tier-name>
<user-exit></user-exit>
<log-level></log-level>
<enable-extended-logging></enable-extended-logging>
<controller-cert-file></controller-cert-file>
<controller-cert-dir></controller-cert-dir>
<log-settings>
<log-setting broker="" execution-group="">
<max-file-size>200KB</max-file-size>
</log-setting>
<log-setting broker="Broker1" execution-group="EG1">
<max-file-size>2MB</max-file-size>
</log-setting>
<log-setting broker="Broker1" execution-group="">
<max-file-size>3MB</max-file-size>
</log-setting>
</log-settings>
</controller-info>
次の表に、優先順位を示します。優先順位は 1 → 2 → 3 → 4 と定義されます。したがって、注文が無効または一致しない場合、次の有効な注文が考慮されます。
| 注文番号 | 設定 | 注文テンプレート |
|---|---|---|
| 1 | 実行グループ | <log-setting broker="Broker1" execution-group="EG1"> |
| 2 | ブローカー | <log-setting broker="Broker1" execution-group=""> |
| 3 | 複数のブローカー間 | <log-setting broker="" execution-group=""> |
| 4 | デフォルト | エージェントのデフォルト(10 MB)を適用 |
次に、上記の構成例で使用する場合のさまざまな実行グループに対する有効な値を示します。
| ブローカー名 | 実行グループ名 | 有効な値(max-file-size) |
|---|---|---|
| Broker1 | EG1 | 2MB |
| Broker1 | 他のすべての EG | 3 MB |
| 他のすべてのブローカー | 他のすべての EG | 200KB |