log
- モード
- グローバルコンフィグモード
- カテゴリー
- 運用・管理 / ログ
構文
(config)# [no] log DESTINATION
コマンド説明
既定のログ出力先(bufferedログ、permanentログ、consoleログ)を有効にする。あるいは、任意設定のログ出力先(hostログ、emailログ)を新たに定義する。no形式で実行した場合は既定のログ出力先を無効にする。あるいは、任意設定のログ出力先を削除する。
hostログ、emailログを新規に定義した場合は、本コマンドの実行後、log(filter)コマンドでメッセージフィルターを追加し、どのようなメッセージを出力するかを指定する必要がある(メッセージフィルターを追加するまで実際にはメッセージが出力されない)。
一方、bufferedログ、permanentログ、monitorログ、consoleログは初期状態で定義済みかつ有効であり、メッセージフィルターも設定されている(monitorログはつねに有効であるため本コマンドの操作対象外)。
パラメーター
DESTINATION- ログメッセージの出力先。hostログとemailログの場合は、具体的な出力先(syslogサーバー、メールアドレス)も指定する
buffered- ランタイムメモリー。初期状態で有効に設定されている
permanent- フラッシュメモリー。初期状態で有効に設定されている
console- コンソール+仮想端末。初期状態で有効に設定されている
host {A.B.C.D|X:X::X:X} [vrf VRFNAME]- syslogサーバー。サーバーのIPv4アドレス(A.B.C.D)またはIPv6アドレス(X:X::X:X)を指定する。また非グローバルVRFインスタンス(作成したVRFインスタンス)上のsyslogサーバーを使用するときはvrfパラメーターでVRFインスタンス名を指定する(省略時はグローバルVRFインスタンスを使用する)
email TOADDRESS- 電子メールアドレス。TOADDRESSにメールアドレスを指定する
external FILEPATH- 外部メディア(USBメモリー)上のファイルパス。外部メディア上にないファイルパスは指定できない。指定したファイルやディレクトリーが存在しない場合は自動的に作成される。また、指定したファイルがすでに存在していた場合は、該当ファイルにログが追記されていく(log size、log rotateコマンドの設定により、既存ファイルの内容はローテート、削除される可能性があるので注意)。
使用例
コンソールポートへのログ出力を無効にする。awplus(config)# no log console
syslogサーバー192.168.10.2宛てのhostログを定義する。
awplus(config)# log host 192.168.10.2
電子メールアドレスadmin@example.com宛てのemailログを定義する。
awplus(config)# log email admin@example.com
USBメモリー上の/var/log/messages.txtファイルにログを出力する。
awplus(config)# log external usb:/var/log/messages.txt
注意・補足事項
monitorログは端末セッションごとに出力をオン・オフするものであるため(terminal monitorコマンド)、それ自体としては有効・無効といった状態を持たない。そのため、本コマンドでmonitorログの状態を操作することはできない。なお、monitorログの出力条件はlog(filter)コマンドで変更可能。emailログを使用する場合は、あらかじめメール送信のための基本設定を済ませておくこと(mail fromコマンド、mail smtpserverコマンド)。
emailログでは、VCSメンバーがLeave / Joinした際に出力されるログの一部が送信されない場合がある。
syslogサーバーを複数設定するときは、すべて同一のVRFインスタンス(グローバルVRFインスタンスを含む)所属のものを指定する必要がある。異なるVRFインスタンスに所属するsyslogサーバーを複数設定することはサポート対象外。