# log rotate

モード
  グローバルコンフィグモード
カテゴリー
  運用・管理 / ログ

## 構文

コマンド構文

`(config)# log DESTINATION rotate <0-255>`

`(config)# no log DESTINATION rotate`

## コマンド説明

過去のexternalログを何世代まで保持するかを指定する。
no形式で実行した場合は初期値に戻る。
初期値は1。

## パラメーター

`DESTINATION`
  ログ出力先。次のいずれかを指定する
  `external`
    外部メディア（USBメモリー）上のファイル（logコマンドのexternalパラメーターで指定したファイル）
`<0-255>`
  過去のログファイルを何世代まで保持するか。初期値は1

## 使用例

過去のexternalログファイルを4世代まで保持するよう設定する。

    awplus(config)# log external usb:/sample.log
    awplus(config)# log external rotate 4

この場合、logコマンドのexternalパラメーターで指定したファイル名が「sample.log」のとき、過去のログファイルは「sample.log.1」、「sample.log.2」、「sample.log.3」、「sample.log.4」というファイル名で残される。
過去のログファイルは数字の小さいものほど新しい。
「sample.log」が既定サイズ(*)に達すると、次の方式で各ファイルがローテーションされる。

- 番号が一番大きい「sample.log.4」をいったん削除。
- 「sample.log.3」を「sample.log.4」にリネーム。
- 「sample.log.2」を「sample.log.3」にリネーム。
- 「sample.log.1」を「sample.log.2」にリネーム。
- 「sample.log」を「sample.log.1」にリネーム。
- 新しく「sample.log」を作成し、これ以降のログを出力。

(*) 既定サイズは、log sizeコマンドの設定値（KByte）÷ (設定世代数 + 1) となる。
たとえば、本コマンドの設定値が4で、log sizeコマンドの設定が初期値の場合（log size 50）、`50 ÷ 5 = 10 KByte` となるため、10KByteを超えるとローテーションされる。

## コマンドツリー

## 関連コマンド