このページは機械翻訳したものです。

5.5.3 エラーログコンポーネント

このセクションでは、個々のエラーログコンポーネントの特性について説明します。 エラーロギングの構成に関する一般情報は、セクション5.4.2「エラーログ」 を参照してください。

ログコンポーネントには、フィルタまたはシンクを指定できます:

• フィルタは、ログイベントを処理し、イベントフィールドを追加、削除または変更したり、イベント全体を削除します。 結果のイベントは、有効なコンポーネントのリスト内の次のログコンポーネントに渡されます。

• シンクは、ログイベントの宛先 (ライター) です。 通常、シンクはログイベントを特定の形式のログメッセージに処理し、これらのメッセージをファイルやシステムログなどの関連出力に書き込みます。 シンクは、パフォーマンススキーマ error_log テーブルに書き込むこともできます。セクション27.12.19.1「error_log テーブル」 を参照してください。 イベントは、有効なコンポーネントのリスト内の次のログコンポーネントに未変更で渡されます (つまり、シンクはイベントをフォーマットして出力メッセージを生成しますが、イベントは次のコンポーネントに内部的に渡されるため変更されません)。

log_error_services システム変数値には、有効なログコンポーネントがリストされます。 リストに指定されていないコンポーネントは無効になります。

次の各セクションでは、コンポーネントタイプ別にグループ化された個々のログコンポーネントについて説明します:

• エラーログコンポーネントのフィルタ

• シンクエラーログコンポーネント

コンポーネントの説明には、次のタイプの情報が含まれます:

• コンポーネント名と目的。

• コンポーネントが組み込まれているか、ロードする必要があるか。 ロード可能なコンポーネントの場合、説明には、INSTALL COMPONENT および UNINSTALL COMPONENT ステートメントを使用してコンポーネントをロードおよびアンロードするために使用する URN を指定します。

• コンポーネントを log_error_services 値に複数回リストできるかどうか。

• シンクコンポーネントの場合、コンポーネントが出力を書き込む宛先。

• シンクコンポーネントの場合、パフォーマンススキーマ error_log テーブルへのインタフェースをサポートするかどうか。

エラーログコンポーネントのフィルタ

エラーログフィルタコンポーネントは、エラーログイベントのフィルタリングを実装します。 フィルタコンポーネントが有効になっていない場合、フィルタリングは行われません。

有効なフィルタコンポーネントは、log_error_services 値の後半にリストされているコンポーネントのログイベントにのみ影響します。 特に、フィルタコンポーネントより前の log_error_services にリストされているログシンクコンポーネントでは、ログイベントのフィルタリングは行われません。

log_filter_internal コンポーネント

• 目的: log_error_verbosity および log_error_suppression_list システム変数と組み合せて、ログイベントの優先度およびエラーコードに基づいてフィルタリングを実装します。 セクション5.4.2.5「優先度ベースのエラーログのフィルタリング (log_filter_internal)」を参照してください。

• URN: このコンポーネントは組み込まれており、使用する前に INSTALL COMPONENT とともにロードする必要はありません。

• 複数使用の許可: No.

log_filter_internal が無効になっている場合、log_error_verbosity および log_error_suppression_list は無効になります。

log_filter_dragnet コンポーネント

• 目的: dragnet.log_error_filter_rules システム変数設定で定義されたルールに基づいてフィルタリングを実装します。 セクション5.4.2.6「ルールベースのエラーログのフィルタリング (log_filter_dragnet)」を参照してください。

• URN: file://component_log_filter_dragnet

• 複数使用の許可: No.

シンクエラーログコンポーネント

エラーログシンクコンポーネントは、エラーログ出力を実装するライターです。 シンクコンポーネントが有効になっていない場合、ログ出力は発生しません。

シンクコンポーネントの説明の中には、デフォルトのエラーログの宛先を参照するものがあります。 これはコンソールまたはファイルであり、セクション5.4.2.2「デフォルトのエラーログ保存先の構成」 で説明されているように、log_error システム変数の値によって示されます。

log_sink_internal コンポーネント

• 目的: 従来のエラーログメッセージ出力形式を実装します。

• URN: このコンポーネントは組み込まれており、使用する前に INSTALL COMPONENT とともにロードする必要はありません。

• 複数使用の許可: No.

• 出力先: デフォルトのエラーログの宛先に書き込みます。

• パフォーマンススキーマのサポート: error_log テーブルに書き込みます。 以前のサーバーインスタンスによって作成されたエラーログファイルを読み取るためのパーサーを提供します。

log_sink_json コンポーネント

• 目的: JSON 形式のエラーロギングを実装します。 セクション5.4.2.7「JSON 形式でのエラーロギング」を参照してください。

• URN: file://component_log_sink_json

• 複数使用の許可: Yes.

• 出力先: このシンクは、log_error システム変数で指定されたデフォルトのエラーログの宛先に基づいて出力先を決定します:

  • log_error がファイルに名前を付ける場合、シンクはそのファイル名に加えて、NN が 00 から始まる番号付き .NN.json 接尾辞に基づいて出力ファイルの名前を付けます。 たとえば、log_error が file_name の場合、log_error_services 値で指定された log_sink_json の連続するインスタンスは file_name.00.json、 file_name.01.json などに書き込まれます。

  • log_error が stderr の場合、シンクはコンソールに書き込みます。 log_sink_json の名前が log_error_services 値で複数回指定されている場合は、コンソールに書き込まれるため、役に立たない可能性があります。

• パフォーマンススキーマのサポート: error_log テーブルに書き込みます。 以前のサーバーインスタンスによって作成されたエラーログファイルを読み取るためのパーサーを提供します。

log_sink_syseventlog コンポーネント

• 目的: エラーロギングをシステムログに実装します。 これは、Windows ではイベントログ、Unix および Unix に似たシステムでは syslog です。 セクション5.4.2.8「システムログへのエラーロギング」を参照してください。

• URN: file://component_log_sink_syseventlog

• 複数使用の許可: No.

• 出力先: システムログに書き込みます。 デフォルトのエラーログの保存先は使用しません。

• パフォーマンススキーマのサポート: error_log テーブルには書き込まれません。 以前のサーバーインスタンスによって作成されたエラーログファイルを読み取るパーサーを提供しません。

log_sink_test コンポーネント

• 目的: 本番での使用ではなく、テストケースの記述での内部使用を目的としています。

• URN: file://component_log_sink_test

複数使用が許可されているかどうかや、出力先が log_sink_test に指定されていないかどうかなどのシンクプロパティ。これは、前述のように内部使用のためです。 そのため、その動作はいつでも変更される可能性があります。