[index] AT-AR1050V コマンドリファレンス 5.5.4

運用・管理 / ログ

Note

本製品はリアルタイムクロックを内蔵していないため、コマンドによる再起動、もしくは電源断による再起動が発生するたびに時刻をあわせる必要があります。これは、clock setコマンドを使って手動で行うこともできますが、NTPサーバーにアクセスできる環境では、NTPの利用をおすすめします。詳細は「運用・管理」/「NTP」をご覧ください。

ログメッセージ

<date> <time> <facility>.<severity> <program[<pid>]>: <message>

Note

本製品はリアルタイムクロックを内蔵していないため、コマンドによる再起動、もしくは電源断による再起動が発生するたびに時刻をあわせる必要があります。これは、clock setコマンドを使って手動で行うこともできますが、NTPサーバーにアクセスできる環境では、NTPの利用をおすすめします。詳細は「運用・管理」/「NTP」をご覧ください。

Note

一度も時刻合わせをしていない場合は、デフォルトの時刻「2010-01-01 00:00:00」からシステム時計がスタートします。

ファシリティー

ログレベル

ログ出力先

既定のログ出力先

任意設定のログ出力先

Note

emailログを使用する場合は、あらかじめメール送信のための基本設定を済ませておく必要があります（mail fromコマンド、mail smtpserverコマンド）。詳しくは「運用・管理」の「メール送信」をご覧ください。

ログの閲覧

Note

これらのコマンドは、グローバルコンフィグモードでも実行可能です。

awplus# show log ↓
awplus# show log permanent ↓
awplus# show log external ↓

awplus# show log tail ↓
awplus# show log permanent tail ↓
awplus# show log external tail ↓

awplus# show log tail 50 ↓
awplus# show log permanent tail 50 ↓
awplus# show log external tail 50 ↓

awplus# show log | include FAILED ↓
2012 Jan 14 00:57:25 authpriv.notice login: FAILED LOGIN 1 FROM (null) FOR manag
er, Authentication failure

awplus# clear log buffered ↓
awplus# clear log permanent ↓
awplus# clear log external ↓
awplus# clear log ↓

awplus# terminal monitor ↓
01:09:10 syslog: 2. init app syslog-ng sessPt=268908776, addr=805392384
01:09:35 login: pam_unix(login:auth): authentication failure; logname= uid=0 eui
d=0 tty=pts/1 ruser= rhost=localhost  user=manager
01:09:36 login: FAILED LOGIN 1 FROM localhost FOR manager, Authentication failur
e
01:09:38 login: pam_unix(login:session): session opened for user manager by (uid
=0)
01:09:38 login: LOGIN ON pts/1 BY manager FROM localhost
...

01:09:38 login: pam_unix(login:session): session opened for user manager by (uid
=0)
01:09:38 login: LOGIN ON pts/1 BY manager FROM localhost
...
awplus# terminal no monitor ↓

Note

ターミナルモニターは現行のログインセッションにおいてのみ有効なので、ログアウトすると無効になります。

ログ設定のカスタマイズ

1. 出力先の定義
   出力先には、既定4種と任意2種の合計6種類があります。さらに任意の2種類に関しては、それぞれ複数の出力先を定義できます。
   
   各出力先において設定できる項目は以下のとおりです。
   
   

   表 6：出力先ごとの設定可能項目

   名称	種別（数）	出力先指定	状態設定	保存量設定	時差設定
   buffered	既定（1）	－	○ 有効/無効	○	－
   permanent	既定（1）	－	○ 有効/無効	○	－
   monitor	既定（1）	－	△ ターミナルモニターをオン/オフ	－	－
   console	既定（1）	－	○ 有効/無効	－	－
   host	任意（複数）	IPv4/IPv6アドレス	△ 作成/削除	－	○
   email	任意（複数）	メールアドレス	△ 作成/削除	－	○
   external	任意（1つ）	外部メディア（USBメモリー）上のファイルパス	△ 作成/削除	○	－

   
   
   • 既定のログ出力先のうち、buffered、permanent、consoleに関しては、有効（出力する）・無効（出力しない）の設定変更が可能です。
     
     
   • 既定のログ出力先のうち、monitorに関しては、管理端末ごとにターミナルモニターをオン・オフすることで出力する・しないを制御するため、monitorログ総体としての有効・無効設定はありません。
     
     
   • 既定のログ出力先のうち、buffered、permanent、および、任意設定のログ出力先のうち external に関しては、保存するメッセージの最大量（KByte）を変更可能です。
     また、external に関しては、過去ログファイルを何世代まで残すか（ログローテーション数）の設定も可能です。
     
     
   • 任意設定のログ出力先（host、email、external）に関しては、syslogサーバーのIPv4/IPv6アドレスや電子メールアドレス、外部メディア上のファイルパスを指定することで、新規出力先を定義できます。
     なお、host、email は複数の出力先を定義できますが、external は1つしか定義できません。
     
     
   • 任意設定のログ出力先のうち、host、emailに関しては、出力先（syslogサーバーや電子メール受信者）との時差を設定できます。時差を設定した場合、ログメッセージ中の時刻情報が受信側の時刻に変換された上で送信されます。
     
   
   
2. メッセージフィルターの設定
   各出力先定義に対してメッセージフィルターを設定することで、該当出力先への出力条件を指定します。
   
   メッセージフィルターでは、個々のログメッセージの内容（ログレベル、ファシリティー、生成元プログラム、メッセージ内容）に応じて、出力する・しないを決定します。出力先定義にメッセージフィルターを関連付けることによって、初めてログメッセージが出力されるようになります。
   
   さらに、メッセージフィルターによって出力対象となったログメッセージの中から、特定の条件に当てはまるものを除外する設定も可能です（ログ出力抑制機能）。出力抑制の条件や設定方法は、メッセージフィルターとほぼ同じです。
   

出力先の定義

awplus(config)# no log buffered ↓
awplus(config)# no log permanent ↓
awplus(config)# no log console ↓

awplus# terminal monitor ↓
...
awplus# terminal no monitor ↓

awplus(config)# log buffered size 200 ↓

awplus(config)# log host 192.168.10.2 ↓

Note

hostログの出力先を定義したら、次にメッセージフィルターを作成して該当syslogサーバーへのログ出力条件を指定してください。出力先にメッセージフィルターを関連付けるまで、ログメッセージは出力されません。詳しくは次項「メッセージフィルターの設定」をご覧ください。

Note

syslogサーバーへのログ送信時に使う始点IPv4/IPv6アドレスは、log host sourceコマンドで明示的に指定することができます。なお、同コマンドの設定はすべてのsyslogサーバーに対して適用されます。

awplus(config)# log email admin@example.com ↓

Note

emailログを使用する場合は、あらかじめメール送信のための基本設定を済ませておく必要があります（mail fromコマンド、mail smtpserverコマンド）。詳しくは「運用・管理」の「メール送信」をご覧ください。

Note

emailログの出力先を定義したら、次にメッセージフィルターを作成して該当メールアドレスへのログ出力条件を指定してください。出力先にメッセージフィルターを関連付けるまで、ログメッセージは出力されません。詳しくは次項「メッセージフィルターの設定」をご覧ください。

awplus(config)# log host 192.168.10.2 time local-offset plus 3 ↓

awplus(config)# log host 192.168.10.2 time utc-offset plus 12 ↓

awplus(config)# log host 192.168.10.2 time local ↓

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

Note

• externalログの出力先に指定できるのは、外部メディア（USBメモリー）上のファイルだけです。
  
• 指定したファイルが存在しない場合は自動的に作成されます。また、指定したファイルがすでに存在していた場合は、そのファイルにログメッセージが追記されていきます。
  
• 外部メディアの空き容量が2%になると、一番古いログファイルが削除されます。
  
• ログ出力先として使用する外部メディアのファイルシステム（フォーマット）は ext3 または ext4 を推奨します。
  
• 外部メディアにログを出力している場合は、外部メディアを取りはずす前や、システムを再起動または停止（電源オフ）する前に、必ずunmountコマンドを実行してください。
  

awplus(config)# no log email admin@example.com ↓

メッセージフィルターの設定

• buffered：noticesレベル以上（レベル0～5）のメッセージを出力
  
• permanent：warningsレベル以上（レベル0～4）のメッセージを出力
  
• monitor：debuggingレベル以上（レベル0～7）のメッセージ（すべてのメッセージ）を出力
  
• console：criticalレベル以上（レベル0～2）のメッセージを出力
  
• external：noticesレベル以上（レベル0～5）のメッセージを出力
  

awplus(config)# log buffered level warnings ↓
awplus(config)# no log buffered level notices ↓

awplus(config)# log host 192.168.10.2 level debugging ↓

awplus(config)# log host 192.168.10.2 level errors ↓

awplus(config)# log host 192.168.10.2 level 3 ↓

awplus(config)# log host 192.168.10.2 facility auth ↓
awplus(config)# log host 192.168.10.2 facility authpriv ↓

awplus(config)# log host 192.168.10.2 msgtext FAILED LOGIN ↓

Note

msgtextパラメーターは、msgtextキーワード以降行末までが値と見なされるため、例のように値に空白が含まれていてもかまいません。ただし、必ずコマンドラインにおける最後のパラメーターとして指定してください。

awplus(config)# log host 192.168.10.2 level warnings program epsr ↓

Note

複数の条件を同時に指定する場合でmsgtextパラメーターを使用する場合は、必ずmsgtextパラメーターを最後に記述してください。msgtextパラメーターは、msgtextキーワード以降行末までが値と見なされるためです。

awplus(config)# no log host 192.168.10.2 msgtext FAILED LOGIN ↓

出力したくないメッセージを除外する（ログ出力抑制機能）

awplus(config)# log buffered exclude msgtext martian ↓

出力時のファシリティー固定設定

awplus(config)# log facility local1 ↓

awplus(config)# no log facility ↓

初期値への復帰

awplus(config)# default log buffered ↓
awplus(config)# default log permanent ↓
awplus(config)# default log monitor ↓
awplus(config)# default log console ↓

awplus(config)# default log host 192.168.10.2 ↓
awplus(config)# default log email admin@example.com ↓
awplus(config)# default log external ↓

ログ設定の確認

awplus(config)# show log config ↓

Buffered log:
  Status ......... enabled
  Maximum size ... 50kb
  Filters:
  1   Level ...... warnings
      Program .... any
      Facility ... any
      Msg text ... any
      Type ....... include
  Statistics ..... Not available
Permanent log:
  Status ......... enabled
  Maximum size ... 50kb
  Filters:
 *1   Level ...... warnings
      Program .... any
      Facility ... any
      Msg text ... any
      Type ....... include
  Statistics ..... Not available
Host 192.168.10.2
  Time offset .... +0:00
  Filters:
  1   Level ...... warnings
      Program .... rip
      Facility ... any
      Msg text ... any
      Type ....... include
  2   Level ...... any
      Program .... any
      Facility ... auth
      Msg text ... any
      Type ....... include
  3   Level ...... any
      Program .... any
      Facility ... authpriv
      Msg text ... any
      Type ....... include
  Statistics ..... Not available
Monitor log:
  Filters:
 *1   Level ...... debugging
      Program .... any
      Facility ... any
      Msg text ... any
      Type ....... include
  Statistics ..... Not available
Console log:
  Status ......... enabled
  List of consoles:
  1 .............. ttyS0
  Filters:
 *1   Level ...... critical
      Program .... any
      Facility ... any
      Msg text ... any
      Type ....... include
  Statistics ..... Not available
External log:
  Status ......... enabled
  Log file ....... usb:/sample.log
  Rotation ....... 4
  Maximum size ... 1024kb
  Filters:
 *1   Level ...... notices
      Program .... any
      Facility ... any
      Msg text ... any
      Type ....... include
  Statistics ..... 225960 messages received, 219939 accepted, 0 excluded (2017 J
un 19 03:04:18 sysl)

設定例

syslogサーバーへのログ送信

1. logコマンドでhostログの出力先を定義します。ここでは、syslogサーバーのIPアドレスとして192.168.10.2を指定しています。
   

   awplus(config)# log host 192.168.10.2 ↓
   

   
   
2. log(filter)コマンドですべてのログメッセージを出力するメッセージフィルターを設定します。
   

   awplus(config)# log host 192.168.10.2 level debugging ↓
   

電子メールでのログ送信

1. メール送信機能の基本設定をします。詳しくは「運用・管理」の「メール送信」をご覧ください。
   

   awplus(config)# mail from manager@bulbul.example.com ↓
   awplus(config)# mail smtpserver 172.17.28.1 ↓
   

   
   
2. logコマンドでemailログの出力先を定義します。ここでは、宛先メールアドレスとしてadmin@example.comを指定しています。
   

   awplus(config)# log email admin@example.com ↓
   

   
   
3. log(filter)コマンドでcriticalレベル（レベル0～2）の重大なメッセージと「FAILED LOGIN」という文字列を含むメッセージだけを出力するメッセージフィルターを設定します。
   

   awplus(config)# log email admin@example.com level critical ↓
   awplus(config)# log email admin@example.com msgtext FAILED LOGIN ↓
   

外部メディアへのログ出力

Note

• externalログの出力先に指定できるのは、外部メディア（USBメモリー）上のファイルだけです。
  
• 指定したファイルが存在しない場合は自動的に作成されます。また、指定したファイルがすでに存在していた場合は、そのファイルにログメッセージが追記されていきます。
  
• 外部メディアの空き容量が2%になると、一番古いログファイルが削除されます。
  
• ログ出力先として使用する外部メディアのファイルシステム（フォーマット）は ext3 または ext4 を推奨します。
  
• 外部メディアにログを出力している場合は、外部メディアを取りはずす前や、システムを再起動または停止（電源オフ）する前に、必ずunmountコマンドを実行してください。
  

1. logコマンドで出力先のファイルパスを指定し、externalログの出力先を定義します。ここでは、USBメモリー上の/var/log/messages.txtファイルにログを出力するものとします。
   

   awplus(config)# log external usb:/var/log/messages.txt ↓
   

   
   
2. externalログの初期状態では、保存メッセージ量が50KByteに設定されています。これを1024KByteに増やすにはlog sizeコマンドを使って次のようにします。
   

   awplus(config)# log external size 1024 ↓
   

   
   
3. externalログの初期設定では、過去ログファイルを1世代分だけ保持する設定が行われており、ログメッセージをカレントログファイル（messages.txt）と過去ログファイル1つ（messages.txt.1）の2ファイルに分割して保存、ローテーションするよう設定されています。過去ログファイルを4つに変更するにはlog rotateコマンドを使って次のようにします。
   

   awplus(config)# log external rotate 4 ↓
   

   
   
4. externalログの初期設定では、noticesレベル以上（レベル0～5）のメッセージを出力するログフィルターが設定されています。informational以上（レベル0～6）のメッセージを出力するよう変更するには、log(filter)コマンドを使って次のようにします。
   

   awplus(config)# no log external level notice ↓
   awplus(config)# log external level informational ↓
   

(C) 2019 - 2024 アライドテレシスホールディングス株式会社

PN: 613-002735 Rev.AD