ロギング・プロパティ・ファイル

Dgraph HDFSエージェントには、ロギング・プロパティを設定するデフォルトのLog4j構成ファイルがあります。

このファイルは、log4j.propertiesという名前が付けられ、$DGRAPH_HOME/dgraph-hdfs-agent/libディレクトリにあります。

ログ・ファイルはローリング・ログ・ファイルです。ファイルのデフォルト・バージョンは次のとおりです:

log4j.rootLogger=INFO, ROLLINGFILE
#
# Add ROLLINGFILE to rootLogger to get log file output
#    Log DEBUG level and above messages to a log file
log4j.appender.ROLLINGFILE=oracle.core.ojdl.log4j.OracleAppender
log4j.appender.ROLLINGFILE.ComponentId=DgraphHDFSAgent
log4j.appender.ROLLINGFILE.Path=${logfilename}
log4j.appender.ROLLINGFILE.Format=ODL-Text
log4j.appender.ROLLINGFILE.MaxSegmentSize=10485760
log4j.appender.ROLLINGFILE.MaxSize=1048576000
log4j.appender.ROLLINGFILE.Encoding=UTF-8
log4j.appender.ROLLINGFILE.layout = org.apache.log4j.PatternLayout
log4j.appender.ROLLINGFILE.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

このファイルでは、ルート・ロガーのROLLINGFILE appendersを定義し、ファイルのログ・レベルも設定します。

このファイルには、次のプロパティがあります:

ロギング・プロパティ	説明
`log4j.rootLogger`	ルート・ログ出力のレベルは`INFO`として定義され、`ROLLINGFILE` appenderがアタッチされます。ログ・レベルは変更できますが、`ROLLINGFILE` appenderは変更できません。
`log4j.appender.ROLLINGFILE`	アペンダを`OracleAppender`に設定します。これにより、ODL (「Oracle Diagnosticsロギング)」形式のログ・エントリ)が定義されます。このプロパティは変更しないでください。
`log4j.appender.ROLLINGFILE.ComponentId`	ログ・メッセージを生成するコンポーネントの名前として`DgraphHDFSAgent`を設定します。このプロパティは変更しないでください。
`log4j.appender.ROLLINGFILE.Path`	ログ・ファイルのパスを設定します。 `${logfilename}`変数は、起動時に使用されるDgraph HDFSエージェント`--out`フラグからパスを取得します。このプロパティは変更しないでください。
`log4j.appender.ROLLINGFILE.Format`	変換パターンで指定された書式設定文字列として`ODL-Text`を設定します。このプロパティは変更しないでください。
`log4j.appender.ROLLINGFILE.MaxSegmentSize`	ログ・ファイルの最大サイズ(バイト単位)を設定します。 `dgraphHDFSAgent.out`ファイルがこのサイズに達すると、ロールオーバー・ファイルが作成されます。デフォルトは10485760 (約10 MB)です。
`log4j.appender.ROLLINGFILE.MaxSize`	`dgraphHDFSAgent.out`ファイルおよびロギング・ロールオーバー・ファイルによって使用される最大ディスク領域を設定します。デフォルトは1048576000 (約1GB)です。
`log4j.appender.ROLLINGFILE.Encoding`	ログ・ファイルの文字エンコーディングを設定します。デフォルトの`UTF-8`値では、ファイルにUTF-8文字が出力されます。
`log4j.appender.ROLLINGFILE.layout`	レイアウトの`org.apache.log4j.PatternLayout`クラスを設定します。
`log4j.appender.ROLLINGFILE.layout.ConversionPattern`	ログ・エントリ変換パターンを定義します。変換文字については、を参照してください : https://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/PatternLayout.html

ロギング・レベル

ログ・レベルを変更するには、プロパティ・ファイルをテキスト・エディタで開き、log4j.rootLoggerプロパティのレベルをJavaログ・レベルに次の表から変更します。次の例では、ログ・レベル設定をERRORに変更する方法を示します:

log4j.rootLogger=ERROR

ただし、ログ・メッセージを書き込むと、ロギング・システムはJavaレベルをODLの同等のレベルに変換します。下の表ログ・レベル(重大度の高い順に表示)は、次のとおりです:

Javaのログ・レベル	ODLログ・レベル	意味
`OFF`	該当なし	ランクが最大で、ロギングをオフにするために使用されます。
`FATAL`	`INCIDENT_ERROR`	製品のバグに起因して、Oracle Supportに報告する必要がある重大な問題を示します。一般に、これらのメッセージは、かなり重要なイベントを説明し、これによって通常のプログラム実行を妨げることがあります。
`ERROR`	`ERROR`	管理者からの即座の対処が必要で、製品の不具合によるものではない重大な問題を示しています。
`WARN`	`WARNING`	管理者が確認する必要のある潜在的な問題を示します。
`INFO`	`NOTIFICATION`	情報メッセージのメッセージ・レベル。このレベルは、通常、主要サブコンポーネントや機能のアクティブ化または非アクティブ化などの、主要なライフサイクル・イベントを示します。これはデフォルトのレベルです。
`DEBUG`	`TRACE`	管理者にとって意味のある、パブリックAPIエントリや終了ポイントなどのイベントのデバッグ情報。

これらのレベルでは、関連しないメッセージに負荷をかけることなく、適切な粒度で関心のあるイベントを監視できます。開発環境でアプリケーションを最初に設定するときは、INFOレベルを使用してほとんどのメッセージを取得し、より詳細なレベル(本番)に変更できます。