エージェントのログファイルサイズの設定

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] です。すべての実行グループに独自のログファイルがあります。

ただし、設定の際は次のガイドラインに注意する必要があります。

  • ブローカーに名前が付けられていない場合、設定がすべてのブローカーに適用されます。
  • 実行グループに名前が付けられていない場合、設定がすべての実行グループに適用されます。
  • 実行グループ名には、ブローカー名を付ける必要があります。
注: ログの設定を含める場合は、log-rotation を 1 に設定します。それ以外の場合は、デフォルト値の 5 がログローテーションと見なされます。

たとえば、次の構成では、ログ設定の 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