Syslog-ng - 版の履歴

Kusanaginoturugi: /* 外部リンク */ add TranslationStatus.

2024-08-28T10:47:52Z

外部リンク: add TranslationStatus.

← 古い版		2024年8月28日 (水) 19:47時点における版
441行目:		441行目:
	** [[RFC:5428\|RFC 5428]] - PacketCable および IPCablecom 準拠デバイスの MIB		** [[RFC:5428\|RFC 5428]] - PacketCable および IPCablecom 準拠デバイスの MIB
	* [[RFC:3339\|RFC 3339]] - インターネット上の日付と時刻: タイムスタンプ		* [[RFC:3339\|RFC 3339]] - インターネット上の日付と時刻: タイムスタンプ

			{{TranslationStatus\|Syslog-ng\|2024-08-28\|803632}}

Kusanaginoturugi: 校正（でき・出来）

2024-07-10T11:36:17Z

校正（でき・出来）

← 古い版		2024年7月10日 (水) 20:36時点における版
96行目:		96行目:
	filter <identifier> { expression; };		filter <identifier> { expression; };

	expression には関数を使うことができます。例えばファシリティコードによってメッセージを選り分ける {{ic\|facility()}} 関数などです。Linux カーネルには少数ながらログに使うことが出来る facility がいくつかあります。それぞれの facility にはログレベルが存在します。debug は最も情報量が多く、panic は深刻なエラーのみを表示します。facility, ログレベル, プライオリティの名前は {{ic\|/usr/include/sys/syslog.h}} で確かめることができます。''<nowiki>May 11 23:42:31 mimosinnet su(pam_unix)[18569]: session opened for user root by (uid=1000)</nowiki>'' のような authorization からのメッセージを取り出すには、以下を使います:		expression には関数を使うことができます。例えばファシリティコードによってメッセージを選り分ける {{ic\|facility()}} 関数などです。Linux カーネルには少数ながらログに使うことができる facility がいくつかあります。それぞれの facility にはログレベルが存在します。debug は最も情報量が多く、panic は深刻なエラーのみを表示します。facility, ログレベル, プライオリティの名前は {{ic\|/usr/include/sys/syslog.h}} で確かめることができます。''<nowiki>May 11 23:42:31 mimosinnet su(pam_unix)[18569]: session opened for user root by (uid=1000)</nowiki>'' のような authorization からのメッセージを取り出すには、以下を使います:
	filter f_auth { facility(auth); };		filter f_auth { facility(auth); };

Kgx: /* 参照 */ 同期

2023-12-06T18:30:28Z

参照: 同期

@@ 421行目: / 421行目: @@
 * [[Netconsole]] ユーザー空間 (syslogd など) を介さずに、すべてのカーネルログメッセージ (つまり [[dmesg]]) をネットワーク経由で別のコンピューターに送信するカーネルモジュール。
-== 参照 ==
+== 外部リンク ==
-* [http://www.balabit.com/support/documentation/ syslog-ng ドキュメントポータル]
+* [https://github.com/syslog-ng/syslog-ng syslog-ng Project Page on GitHub]
-** [http://www.balabit.com/sites/default/files/documents/syslog-ng-ose-3.4-guides/en/syslog-ng-ose-v3.4-guide-admin/html/index.html syslog-ng 3.4 管理者ガイド]
+* [https://www.syslog-ng.com/products/open-source-log-management/ syslog-ng OSE Main Page from syslog-ng.com]
-* [http://freshmeat.net/projects/syslog-ng/ syslog-ng Project Page on Freshmeat]
+* [https://www.syslog-ng.com/community/ syslog-ng Blogs]
-* [https://wiki.gentoo.org/wiki/Syslog-ng Gentoo syslog-ng wiki]
+* [https://axoflow.com/blog/ Axoflow Blogs about syslog-ng]
-** [https://tools.ietf.org/html/rfc5425 RFC 5426] - Transmission of Syslog Messages over UDP
+* [[RFC:5424|RFC 5424]] - The Syslog プロトコル

Kgx: /* ログレベル */ 翻訳

2023-12-06T18:27:35Z

ログレベル: 翻訳

← 古い版		2023年12月7日 (木) 03:27時点における版
326行目:		326行目:
	=== ログレベル ===		=== ログレベル ===

			ログレベルは、syslog-ng config でログに記録される機能ごとに個別に定義されます。利用可能なログレベルは {{ic\|/usr/include/sys/syslog.h}} にリストされています:
	Log levels are defined separately for each logged facility in syslog-ng config. Available log levels are listed in /usr/include/sys/syslog.h :

	define LOG_EMERG 0 /* system is unusable */		define LOG_EMERG 0 /* system is unusable */

Kgx: /* ヒントとテクニック‎ */ 関連項目を翻訳して追加

2023-12-06T18:26:03Z

ヒントとテクニック‎: 関連項目を翻訳して追加

← 古い版		2023年12月7日 (木) 03:26時点における版
128行目:		128行目:

	== ヒントとテクニック‎ ==		== ヒントとテクニック‎ ==

	syslog-ng の背後にあるロジックを理解したら、様々な設定、複雑な設定をすることが可能になります。以下はほんの一例です。		syslog-ng の背後にあるロジックを理解したら、様々な設定、複雑な設定をすることが可能になります。以下はほんの一例です。

136行目:		137行目:

	=== ログ出力をリモートホストにフェイルオーバー ===		=== ログ出力をリモートホストにフェイルオーバー ===

	以下の設定は標準ポート (514) と代替ポートを使って、TCP と UDP プロトコル両方でデフォルトの暗号化されていない syslog パケットを送信します。同一の出力を同一のマシンに4回試行して、確実にパケットを送信します。再起動できないリモートサーバーをデバッグするときに特に便利です。様々なポートとプロトコルを使うことで、ファイアウォールフィルターなどのネットワークの問題を通過できるようにしています。また、ポートフォワーディングやトンネルを使う場合にも有用です。このような設定は、逆接続で開始される ssh 接続のトンネルにうってつけでしょう。		以下の設定は標準ポート (514) と代替ポートを使って、TCP と UDP プロトコル両方でデフォルトの暗号化されていない syslog パケットを送信します。同一の出力を同一のマシンに4回試行して、確実にパケットを送信します。再起動できないリモートサーバーをデバッグするときに特に便利です。様々なポートとプロトコルを使うことで、ファイアウォールフィルターなどのネットワークの問題を通過できるようにしています。また、ポートフォワーディングやトンネルを使う場合にも有用です。このような設定は、逆接続で開始される ssh 接続のトンネルにうってつけでしょう。

174行目:		176行目:

	=== ログを別のファイルに移動 ===		=== ログを別のファイルに移動 ===

	ログを {{ic\|/var/log/messages}} から他のファイルに移動するには:		ログを {{ic\|/var/log/messages}} から他のファイルに移動するには:

183行目:		186行目:

	=== loghost として設定 ===		=== loghost として設定 ===

	システムを loghost として設定することはとても簡単です。設定に以下のように記述を行い、必要なディレクトリを作成してください。このシンプルな設定では、ログのファイル名はリモートホストの [[Wikipedia:ja:Fully Qualified Domain Name\|FQDN]] に基づいて名付けられ、{{ic\|/var/log/remote/}} にファイルが配置されます。remote ディレクトリを作成した後、syslog-ng の設定をリロードしてください。		システムを loghost として設定することはとても簡単です。設定に以下のように記述を行い、必要なディレクトリを作成してください。このシンプルな設定では、ログのファイル名はリモートホストの [[Wikipedia:ja:Fully Qualified Domain Name\|FQDN]] に基づいて名付けられ、{{ic\|/var/log/remote/}} にファイルが配置されます。remote ディレクトリを作成した後、syslog-ng の設定をリロードしてください。

230行目:		234行目:
	filter f_messages { level(info..warn) and not facility(cron, auth, authpriv, mail, news); };		filter f_messages { level(info..warn) and not facility(cron, auth, authpriv, mail, news); };

	=== PostgreSQL ~~Destination~~ ===		=== PostgreSQL の宛先 ===

	このセクションでは2つのロールを使います: {{ic\|syslog}} と {{ic\|logwriter}} です。{{ic\|syslog}} は {{ic\|syslog}} データベースの管理者であり、{{ic\|logwriter}} だけが {{ic\|logs}} テーブルにレコードを追加することができることにします。		このセクションでは2つのロールを使います: {{ic\|syslog}} と {{ic\|logwriter}} です。{{ic\|syslog}} は {{ic\|syslog}} データベースの管理者であり、{{ic\|logwriter}} だけが {{ic\|logs}} テーブルにレコードを追加することができることにします。

411行目:		416行目:
	** 構造化された [https://axoflow.com/docs/axosyslog-core/chapter-concepts/concepts-message-structure/syslog-ng-message-format/ EWMM パーサー]		** 構造化された [https://axoflow.com/docs/axosyslog-core/chapter-concepts/concepts-message-structure/syslog-ng-message-format/ EWMM パーサー]
	** その他のアプリケーションアダプター (Splunk Common Information Model (CIM)、iptables、または sudo)		** その他のアプリケーションアダプター (Splunk Common Information Model (CIM)、iptables、または sudo)

			=== 関連項目 ===

			* [[Netconsole]] ユーザー空間 (syslogd など) を介さずに、すべてのカーネルログメッセージ (つまり [[dmesg]]) をネットワーク経由で別のコンピューターに送信するカーネルモジュール。

	== 参照 ==		== 参照 ==

Kgx: /* ヒントとテクニック‎ */ 一般的な syslog メッセージを受信して解析するを翻訳して追加

2023-12-06T18:22:06Z

ヒントとテクニック‎: 一般的な syslog メッセージを受信して解析するを翻訳して追加

@@ 397行目: / 397行目: @@
 YEAR_DAY=148
 </nowiki>}}
 == 参照 ==

Kgx: /* マクロと変数 */ 翻訳

2023-12-06T18:05:39Z

マクロと変数: 翻訳

← 古い版		2023年12月7日 (木) 03:05時点における版
333行目:		333行目:

	=== マクロと変数 ===		=== マクロと変数 ===

	Macros can be used in both templates, and in destination file names. [http://www.balabit.com/sites/default/files/documents/syslog-ng-ose-3.4-guides/en/syslog-ng-ose-v3.4-guide-admin/html/reference-macros.html Macros of syslog-ng OSE].
			マクロは、テンプレートと宛先ファイル名の両方で使用できます。[http://axoflow.com/docs/axosyslog-core/chapter-manipulating-messages/customizing-message-format/reference-macros/ syslog-ng OSE のマクロ]

	以下のコードは {{ic\|<nowiki>macroname=value@</nowiki>}} の形式でログを {{ic\|/var/log/test.log}} に書き出します。		以下のコードは {{ic\|<nowiki>macroname=value@</nowiki>}} の形式でログを {{ic\|/var/log/test.log}} に書き出します。
345行目:		346行目:
	</nowiki>}}		</nowiki>}}

			syslog-ng を再起動すると、次のように独自の値リストを作成できます:
	You can create your own value list as below once syslog-ng is restarted with:
	{{ic\|<nowiki>tail /var/log/test.log\|tr "@" "\n"</nowiki>}}		{{ic\|<nowiki>tail /var/log/test.log\|tr "@" "\n"</nowiki>}}

Kgx: /* パフォーマンスの向上 */ 翻訳

2023-12-06T18:03:24Z

パフォーマンスの向上: 翻訳

← 古い版		2023年12月7日 (木) 03:03時点における版
191行目:		191行目:

	=== パフォーマンスの向上 ===		=== パフォーマンスの向上 ===

	いくつかの方法を使って syslog-ng のパフォーマンスを上げることができます:		いくつかの方法を使って syslog-ng のパフォーマンスを上げることができます:

	==== ときどき書き込ませる ====		==== ときどき書き込ませる ====

	旧 {{ic\|sync(X)}} '''オプション'''は現在 {{ic\|flush_lines(X)}} と呼ばれるようになっており、これによってファイルへの書き込みを {{ic\|X}} 行にバッファします。デフォルトは0です (バッファしません)。		旧 {{ic\|sync(X)}} '''オプション'''は現在 {{ic\|flush_lines(X)}} と呼ばれるようになっており、これによってファイルへの書き込みを {{ic\|X}} 行にバッファします。デフォルトは0です (バッファしません)。

			==== ソースのバッチ処理制限を増やす ====

			syslog-ng は、さまざまなソースメカニズムを使用してメッセージのストリームを受信するため、メッセージ処理を並行して実行します。一方のソース接続が他方のソース接続に対して枯渇することを避けるために、syslog-ng はスレッドを使用し、単一のソース接続から一度に処理するメッセージの量に制限を課します。

			これは、ソースアプリケーションがタイトなループで 1000 個のメッセージを送信したとしても、syslog-ng は一度に 100 個のメッセージを処理することを意味します (正確な制限は {{ic\|log-fetch-limit()}} で指定されます) 100 回ごとに、他の接続も処理が必要かどうかを再チェックします。これにはある程度のオーバーヘッドがあり、{{ic\|log-fetch-limit()}} を増やすことで syslog-ng のパフォーマンスを大幅に向上させることができます。

			特定のユースケースに基づいて調整を使用できるもう 1 つのメカニズムは、バックプレッシャーの伝播に使用されるウィンドウサイズ設定です。これは、宛先が確認応答するまでに送信可能なメッセージの数を制御する {{ic\|log-iw-size()}} パラメータです。{{ic\|log-iw-size()}} を増やすことで、送信先がメッセージを消費できるよう停止する前に、より多くのメッセージを処理できるようになります。

			{{ic\|log-iw-size()}} を増やすと、syslog-ng がメッセージをどこかに置く必要があるため、メモリ/ディスクバッファの使用量が増加します。

	==== 処理やディスク領域の重複を避ける ====		==== 処理やディスク領域の重複を避ける ====

	一つのログメッセージが別々のログファイルに複数回送信されるということがあります。例えば、初期設定では、以下のような定義があります:		一つのログメッセージが別々のログファイルに複数回送信されるということがあります。例えば、初期設定では、以下のような定義があります:

208行目:		221行目:
	}}		}}

	~~The same message from the~~ {{ic\|cron}} ~~facility will end up in both the~~ {{ic\|cron.log}} ~~and~~ {{ic\|messages}} ~~files. To change this behavior we can use the~~ {{ic\|final}} ~~flag,~~		{{ic\|cron}} 機能からの同じメッセージは、{{ic\|cron.log}} と {{ic\|messages}} の両方のファイルに保存されます。この動作を変更するには、{{ic\|final}} フラグを使用します。
			最終的にはメッセージのさらなる処理が終了します。したがって、この例では、{{ic\|cron}} 機能からのメッセージが
	ending up further processing with the message. Therefore, in this example, if we want messages from the {{ic\|cron}} facility not ending up in the
			メッセージファイルでは、cron のログ文を次のように変更する必要があります:
	messages file, we should change the cron's log sentence by:

	log { source(src); filter(f_cron); destination(cron); flags(final); };		log { source(src); filter(f_cron); destination(cron); flags(final); };

	{{ic\|f_messages}} フィルターから {{ic\|cron}} ~~ファシリティ~~を除外する~~方法もありま~~す:		別の方法は、{{ic\|f_messages}} フィルタから {{ic\|cron}} 機能を除外することです:
	filter f_messages { level(info..warn) and not facility(cron, auth, authpriv, mail, news); };		filter f_messages { level(info..warn) and not facility(cron, auth, authpriv, mail, news); };

Kgx: /* インストール */ systemd/ジャーナルとの統合を翻訳して追加

2023-12-06T17:56:15Z

インストール: systemd/ジャーナルとの統合を翻訳して追加

← 古い版		2023年12月7日 (木) 02:56時点における版
24行目:		24行目:

	== インストール ==		== インストール ==

	{{Pkg\|syslog-ng}} パッケージを[[インストール]]してください。syslog-ng を使用開始するには、{{ic\|syslog-ng@default.service}} を[[起動]]・[[有効化]]してください。		{{Pkg\|syslog-ng}} パッケージを [[インストール]] してください。syslog-ng を使用開始するには、{{ic\|syslog-ng@default.service}} を [[起動]]・[[有効化]] してください。

			=== systemd/ジャーナルとの統合 ===

			syslog-ng は、デフォルトで systemd ジャーナルからメッセージを取得します。ソケットに関連するオーバーヘッドを回避し、[https://github.com/syslog-ng/syslog-ng/issues/314 ログに不要なエラーメッセージが記録されるために]、/etc/systemd/journald.conf で {{ic\|1=ForwardToSyslog=no}} を維持することをお勧めします。一方、ログを 2 回保存したくない場合、''journald'' の {{ic\|1=Storage=none}} を設定する場合は、syslog-ng が ''journald'' ジャーナルファイルをたどろうとするため、{{ic\|1= ForwardToSyslog=yes}} が必要になります。

			詳細については、[[syslog-ng#syslog-ng と systemd journal]] を参照してください。

	== Source ==		== Source ==

Kgx: 序文を更新

2023-12-06T17:48:41Z

序文を更新

← 古い版		2023年12月7日 (木) 02:48時点における版
4行目:		4行目:
	{{Related articles start}}		{{Related articles start}}
	{{Related\|rsyslog}}		{{Related\|rsyslog}}
	{{Related\|Netconsole}}
	{{Related articles end}}		{{Related articles end}}
			[[Wikipedia:ja:syslog-ng\|syslog-ng]] は、強力なフィルターディレクティブに基づいて、ソースからログメッセージを取得し、宛先に転送できる [[Wikipedia:ja:syslog\|syslog]] 実装です。その起源は syslog ですが、これは非常に汎用的なログ管理ツールであり、構造化および非構造化ログメッセージを使用し、必要に応じて解析および変換することができます。

	{{Note\|systemd にアップグレードした後は、systemd の journal でログを見ることができるので、journalctl で足りる場合は、syslog-ng は必要なくなりアンインストールすることができます。}}		{{Note\|systemd にアップグレードした後は、systemd の journal でログを見ることができるので、journalctl で足りる場合は、syslog-ng は必要なくなりアンインストールすることができます。}}

← 古い版		2024年8月28日 (水) 19:47時点における版
441行目:		441行目:
	** [[RFC:5428\|RFC 5428]] - PacketCable および IPCablecom 準拠デバイスの MIB		** [[RFC:5428\|RFC 5428]] - PacketCable および IPCablecom 準拠デバイスの MIB
	* [[RFC:3339\|RFC 3339]] - インターネット上の日付と時刻: タイムスタンプ		* [[RFC:3339\|RFC 3339]] - インターネット上の日付と時刻: タイムスタンプ

			{{TranslationStatus\|Syslog-ng\|2024-08-28\|803632}}