Asterisk ログファイル - 版の履歴

2020年8月23日 (日) 05:24にTakatyanによる

2020-08-23T05:24:34Z

← 古い版		2020年8月23日 (日) 14:24時点における版
5行目:		5行目:
	デフォルトの設定では/var/log/asterisk/messagesに、ログレベルnotice, warning, errorが出力されます。<br>		デフォルトの設定では/var/log/asterisk/messagesに、ログレベルnotice, warning, errorが出力されます。<br>
	ログファイルの設定は/etc/asterisk/logger.confで行います。		ログファイルの設定は/etc/asterisk/logger.confで行います。
	<nowiki># /etc/asterisk/logger.conf		<nowiki>; /etc/asterisk/logger.conf
	[logfiles]		[logfiles]
	messages => notice,warning,error</nowiki>		messages => notice,warning,error</nowiki>
19行目:		19行目:
	また、ログレベルの前に[json]を付与するとJSON出力が可能です。		また、ログレベルの前に[json]を付与するとJSON出力が可能です。

	<nowiki>full-json => [json]debug,verbose,notice,warning,error,dtmf,fax</nowiki>		<nowiki>; /etc/asterisk/logger.conf
			[logfiles]
			full-json => [json]debug,verbose,notice,warning,error,dtmf,fax</nowiki>

	'''警告：debugログレベル及びこれを含む*ログレベルを使用すると、極めて多量のログが出力されます。運用モードではdebugログを出力しないことを強く勧めます！'''<br>		'''警告：debugログレベル及びこれを含む*ログレベルを使用すると、極めて多量のログが出力されます。運用モードではdebugログを出力しないことを強く勧めます！'''<br>
30行目:		32行目:
	===ローテートの仕方の設定===		===ローテートの仕方の設定===
	ログのローテートのファイル名の付け方をlogger.confの[general]セクションで設定できます。<br>		ログのローテートのファイル名の付け方をlogger.confの[general]セクションで設定できます。<br>
	<nowiki>[general]		<nowiki>; /etc/asterisk/logger.conf
			[general]
	rotatestrategy=sequential</nowiki>		rotatestrategy=sequential</nowiki>

53行目:		56行目:
	古いログファイルを4世代保持しておき、古いファイルから消していくためには、[general]セクションで次のように設定します。<BR>		古いログファイルを4世代保持しておき、古いファイルから消していくためには、[general]セクションで次のように設定します。<BR>

	<nowiki>[general]		<nowiki>; /etc/asterisk/logger.conf
			[general]
	rotatestrategy=rotate		rotatestrategy=rotate
	exec_after_rotate=rm -f $["${filename}" : "(.+)\.0$"].4</nowiki>		exec_after_rotate=rm -f $["${filename}" : "(.+)\.0$"].4</nowiki>
76行目:		80行目:
	[Service]		[Service]
	Type=simple		Type=simple
			# root以外のユーザーでAsteriskを実行している場合は下2行でAsteriskの実行ユーザーに合わせてください
	#User=asterisk		#User=asterisk
	#Group=asterisk		#Group=asterisk

Takatyan: /* 古いファイルを自動で消す */

2020-08-20T16:12:11Z

古いファイルを自動で消す

← 古い版		2020年8月21日 (金) 01:12時点における版
53行目:		53行目:
	古いログファイルを4世代保持しておき、古いファイルから消していくためには、[general]セクションで次のように設定します。<BR>		古いログファイルを4世代保持しておき、古いファイルから消していくためには、[general]セクションで次のように設定します。<BR>

	~~''記載途中''~~		<nowiki>[general]
			rotatestrategy=rotate
			exec_after_rotate=rm -f $["${filename}" : "(.+)\.0$"].4</nowiki>

	設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。		設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

			: 解説：上記の設定ファイルではAsterisk expressionsの記法が使用されています。${filename}は、rotatestrategy=rotateにおいては「/var/log/asterisk/messages.0」のような文字列になります。
			: これに正規表現 "(.+)\.0$" をマッチ（:演算子は正規表現をマッチさせる演算子ですが、暗黙の「^」により文字列の先頭にマッチされます）させ、Asterisk expressionsの正規表現は他の多数の言語でいう$1を返す仕様のため、
			: これに".4"を付与したものを削除することで、最も古いログファイルを削除します。
			: 詳細は[[Asterisk expressions]]を参照してください。

	===ローテートの実行===		===ローテートの実行===

2020年8月20日 (木) 15:27にTakatyanによる

2020-08-20T15:27:31Z

@@ 27行目: / 27行目: @@
 ==自動でログをローテートする==
-Asteriskには、内蔵のログローテート機構があり、追加の設定なしにログローテートを実行可能です。<br>
+Asteriskには、内蔵のログローテート機構があります。<br>
 ログのローテートそのものは、[[Asterisk CLI]]でlogger rotateを行うと実行されます。<br>

Takatyan: /* 自動でログをローテートする */

2020-08-20T07:41:14Z

自動でログをローテートする

← 古い版		2020年8月20日 (木) 16:41時点における版
27行目:		27行目:

	==自動でログをローテートする==		==自動でログをローテートする==
	~~まず、ログのローテートそのものは、~~[[Asterisk CLI]]でlogger rotateを行うと実行されます。<br>		Asteriskには、内蔵のログローテート機構があり、追加の設定なしにログローテートを実行可能です。<br>
			ログのローテートそのものは、[[Asterisk CLI]]でlogger rotateを行うと実行されます。<br>

	~~systemdの下で定期的にログローテートを行うためのユニットファイルの一例を示します。~~		そこで、systemdの下で定期的にログローテートを行うためのユニットファイルの一例を示します。
	<nowiki># /etc/systemd/system/asterisk-logrotate.service		<nowiki># /etc/systemd/system/asterisk-logrotate.service
	[Unit]		[Unit]

Takatyan: /* ログファイル */

2020-08-20T06:26:54Z

ログファイル

← 古い版		2020年8月20日 (木) 15:26時点における版
3行目:		3行目:
	Asteriskのログファイルについて		Asteriskのログファイルについて
	==ログファイル==		==ログファイル==
	~~デフォルトの設定ではmessagesログとして、notice~~, warning, errorが出力されます。<br>		デフォルトの設定では/var/log/asterisk/messagesに、ログレベルnotice, warning, errorが出力されます。<br>
	ログファイルの設定は/etc/asterisk/logger.confで行います。		ログファイルの設定は/etc/asterisk/logger.confで行います。
	<nowiki># etc/asterisk/logger.conf		<nowiki># /etc/asterisk/logger.conf
	[logfiles]		[logfiles]
	messages => notice,warning,error</nowiki>		messages => notice,warning,error</nowiki>

Takatyan: ページの作成:「カテゴリ:Asterisk Asteriskのログファイルについて ==ログファイル== デフォルトの設定ではmessagesログとして、notice, warning, error...」

2020-08-20T06:23:05Z

ページの作成:「カテゴリ:Asterisk Asteriskのログファイルについて ==ログファイル== デフォルトの設定ではmessagesログとして、notice, warning, error...」

新規ページ

[[カテゴリ:Asterisk]]

Asteriskのログファイルについて
==ログファイル==
デフォルトの設定ではmessagesログとして、notice, warning, errorが出力されます。 
ログファイルの設定は/etc/asterisk/logger.confで行います。
<nowiki># etc/asterisk/logger.conf
[logfiles]
messages => notice,warning,error</nowiki>

noticeレベルログとして認証失敗も記録されるため、Asteriskをインターネットに公開していると、膨大なログが出力されます。 
[[SIP-Fail2ban|Fail2ban]]を使用していても、しつこい攻撃者がいると、ログが増えていきます。 
ログファイルを置くvarパーティションが溢れないようにログファイルの管理を行う必要があります。

==ログの記録レベルを変更する==
必要がなければ、ログの記録レベルを落として出力を減らすのも、1つの手段です。 
/etc/asterisk/logger.confのlogfilesセクションにて、上記の例にならいログレベルをカンマ区切りで記載します。 
レベルとしてはdebug, trace, notice, warning, error, verbose, dtmf, fax, securityが記載できます。ログレベルとして「*」を使用すると、全ログレベルを意味します。 
また、ログレベルの前に[json]を付与するとJSON出力が可能です。

<nowiki>full-json => [json]debug,verbose,notice,warning,error,dtmf,fax</nowiki>

'''警告：debugログレベル及びこれを含む*ログレベルを使用すると、極めて多量のログが出力されます。運用モードではdebugログを出力しないことを強く勧めます！''' 
'''Fail2banを使用している場合は、ログ出力のレベルを変更すると動作に影響を及ぼす恐れがあります。注意して変更してください。'''

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

==自動でログをローテートする==
まず、ログのローテートそのものは、[[Asterisk CLI]]でlogger rotateを行うと実行されます。 

systemdの下で定期的にログローテートを行うためのユニットファイルの一例を示します。
<nowiki># /etc/systemd/system/asterisk-logrotate.service
[Unit]
Description=Asterisk log rotate
Requires=asterisk.service

[Service]
Type=simple
#User=asterisk
#Group=asterisk
ExecStart=/usr/sbin/asterisk -rx 'logger rotate'</nowiki>

<nowiki># /etc/systemd/system/asterisk-logrotate.timer
[Unit]
Description=Asterisk log rotate timer

[Timer]
OnCalendar=Mon *-*-* 04:00:00
RandomizedDelaySec=300
Persistent=true

[Install]
WantedBy=timers.target</nowiki>

設定したら、systemdにユニットファイルをリロードさせ、タイマーを始動します。
<nowiki># systemctl daemon-reload
# systemctl start asterisk-logrotate.timer
# systemctl enable asterisk-logrotate.timer</nowiki>

手動で1回ローテートしてみようと思う場合、次を実行します。
<nowiki># systemctl start asterisk-logrotate.service</nowiki>

==外部の機構によりログをローテートする==
上記はAsterisk内蔵のログローテート機構によるローテートを説明しました。logrotate等、外部のログローテートツールを使用してログローテートを行う方法もあります。 
その場合の詳細は割愛しますが、[https://www.voip-info.org/logrotate/ voip-info.org]等には参考となる情報があるようです。 
外部のログローテートツールによる場合でも、ローテート後にはCLIからlogger reloadを実行すればAsteriskはログを開き直すようです。