Log4j

Apache Log4j
開発元	Apacheソフトウェア財団
最新版	2.23.1 / 10 3月 2024年
リポジトリ	github.com/apache/logging-log4j2;
プラットフォーム	クロスプラットフォーム
種別	ロギングツール
ライセンス	Apache 2.0 ライセンス
公式サイト	logging.apache.org/log4j
	テンプレートを表示

Apache Log4jは、Javaベースのロギングユーティリティである。Ceki Gülcüによって書かれたもので、Apache Software FoundationのApache Logging Servicesプロジェクトの一部である。Log4jはいくつかのJavaロギングフレームワークの一つである。 Gülcüはその後、Log4jの後継製品を提供する意図で、SLF4J︵英語版︶とLogback^[3]プロジェクトを開始した。 Apache Log4jチームは、Log4j 1の後継となるバージョン2を作成した^[4]。Log4j 2は、Log4j 1.2、1.3、java.util.logging、Logbackの問題点に焦点を当てて開発され、これらのフレームワークに現れた問題に対処している^[5]。さらに、Log4j 2はプラグイン・アーキテクチャを提供し、前バージョンよりも拡張性が高くなっている。Log4j 2は、1.xバージョンとの後方互換性はない^[6]が、﹁アダプター﹂が利用できる。 2015年8月5日、Apache Logging Services Project Management Committeeは、Log4j 1が寿命に達したため、Log4j 1のユーザーはApache Log4j 2へのアップグレードを推奨すると発表した^[^7]。

機能[編集]

ログレベル[編集]

Log4jは、6つのログレベルを標準提供する。この他に利用者が任意のログレベルを追加することも可能である。ログレベルが高い︵情報量が少ない︶ものから低い︵情報量が多い︶ものへと順に並べると下表の通り。

FATAL	致命的なエラー。プログラムの異常終了を伴うようなもの。コンソール等に即時出力することを想定
ERROR	エラー。予期しないその他の実行時エラー。コンソール等に即時出力することを想定
WARN	警告。廃要素となったAPIの使用、APIの不適切な使用、エラーに近い事象など、実行時に生じた異常とは言い切れないが正常とも異なる何らかの予期しない問題。コンソール等に即時出力することを想定
INFO	情報。実行時の何らかの注目すべき事象（開始や終了など）。コンソール等に即時出力することを想定。従ってメッセージ内容は簡潔に止めるべき
DEBUG	デバッグ用の情報。システムの動作状況に関する詳細な情報。コンソールではなくログ上にだけ出力することを想定
TRACE	トレース情報。更に詳細な情報。コンソールではなくログ上にだけ出力することを想定

設定ファイル[編集]

Log4jは、二つの方法で設定が可能である。一つはプロパティファイル、もう一つはXMLファイルである。両者とも、3つの主要なコンポーネント︵ロガー、アペンダ、レイアウト︶について定義することができる。ファイルにより設定を行うため、Log4jを使用しているアプリケーションを変更することなく、ロギングをon/offできるという利点がある。たとえば、問題が発生するまではロギングをoffで動作させておき、設定ファイルを変更することで簡単にロギングを再開する、という使い方ができる。 ロガー (Loggers) は論理的なログファイル名であり、Javaアプリケーションはこれらの名前を意識する。個々のロガーにて取得するログのレベル︵FATAL、ERROR等々︶はロガー毎に独立に設定できる。古いバージョンのLog4jでは、これらは﹁カテゴリ﹂と﹁優先度﹂と呼ばれていたが、現バージョンではそれぞれ﹁ロガー﹂と﹁レベル﹂と呼んでいる。 アペンダ (Appenders) は具体的な出力処理を行う。アペンダには様々な種類があり、それぞれ内容を表す名前が付いている。例えばFileAppender、ConsoleAppender、SocketAppender、SyslogAppender、NTEventLogAppenderなどがあり、SMTPAppenderというものさえある。任意のロガーには複数のアペンダを付与できるので、同じログ情報を例えばローカルのファイルと他のコンピュータ上のソケット︵英語版︶リスナに同時に出力する、などという使い方が可能。 レイアウト (Layouts) は一件ずつのログを整形するためにアペンダによって参照される。例えば行単位に出力するログを整形する方法としてPatternLayoutというものがあり、これはC言語のprintf関数によく似た書式指定子を使える。他にもHTMLLayoutやXMLLayoutなどがあり、これらはそれぞれHTMLやXMLの書式に整形したい場合に使える。

設定例[編集]

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration PUBLIC
"http://logging.apache.org/log4j/docs/api/org/apache/log4j/xml/log4j.dtd">
<log4j:configuration>
    <!-- アペンダとは出力先のことであり、例えばコンソールやファイルを指す。
    アペンダの名前は好きに決めてよい。-->
    <appender name="stdout" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                value="%d{ABSOLUTE} %5p %c{1}:%L - %m%n" />
        </layout>
    </appender>
 
    <!-- 'org.springframework'カテゴリのロガーは、infoレベル以上のメッセージのみロギングする。
    もしロガーをクラス名で検索し（例：Logger.getLogger(AClass.class)）AClassが
    springframework.orgパッケージに属するなら、そのロガーはこのカテゴリに属する。-->
    <logger name="org.springframework">
        <level value="info"/>
    </logger>

    <!-- springは原則としてinfo以上のログしか取らないが、PropertyEditorRegistrySupportクラスについては
    デバッグログも欲しい-->
    <logger name="org.springframework.beans.PropertyEditorRegistrySupport">
        <level value="debug"/>
    </logger>
 
    <logger name="org.acegisecurity">
        <level value="info"/>
    </logger>
 
    <root><!-- rootカテゴリ -->
        <!-- 別途定義が無い限り、デバッグレベル以上の全てのメッセージをロギングする。-->
        <!-- 別途定義が無い限り、全てのログは「stdout」アペンダにてロギングされる。 -->
        <level value="debug" />
        <appender-ref ref="stdout" />
    </root>
</log4j:configuration>

（訳注：この設定例中に出現する「カテゴリ」という用語と、「ロガー」の旧称としての「カテゴリ」との関係は不詳。）

ログビューア[編集]

ApacheにはChainsaw（英語版）という別プロジェクトが存在しており、これはLog4jにて生成されたログファイルを利用する。ChainsawはJavaベースのGUIビューアであり、豊富な機能を持つ。ChainsawもLog4jに類似した設定ファイルを使用する。Log4j向けのビューアは他にもあるが（例：log2webオープンソースかつウェブベース）、Chainsawに比較して機能が少ない。

Log4Shell[編集]

詳細は「Log4Shell」を参照

2021年12月9日、Log4j 2のリモートコード実行ゼロデイ脆弱性Log4Shell︵CVE-2021-44228︶が表面化した^[8]。影響を受けるサービスには、iCloud、Minecraft、Steamなどがある^[9]^[10]。この脆弱性の原因となる機能は、その数日前に正式にリリースされたバージョン2.15.0ではデフォルトで無効化されている^[11]。Apache Software Foundationは、CVSSの深刻度評価を最高点の10に指定した^[12]。12月14日時点では脆弱性を利用した攻撃が観測されている^[8]。

脚注[編集]

[脚注の使い方]

(一)^ “Release 2.23.1” (10 3月 2024). 22 3月 2024閲覧。 (二)^ “Log4j – Changes - Apache Log4j 2”. apache.org. Apache Software Foundation. 2021年12月18日閲覧。 (三)^ “Logback Home”. Logback.qos.ch. 2014年7月24日閲覧。 (四)^ “Logback Home”. Logback.qos.ch. 2014年7月24日閲覧。 (五)^ Goers, Ralph (2019年12月15日). “Why was Log4j 2 created?” (英語). Ralph Goers. 2021年12月11日閲覧。 (六)^ “Log4j 2 Guide - Apache Log4j 2: News”. Logging.apache.org (2014年7月12日). 2014年7月24日閲覧。 (七)^ “Apache™ Logging Services™ Project Announces Log4j™ 1 End-Of-Life; Recommends Upgrade to Log4j 2”. blogs.apache.org (2015年8月5日). 2016年7月3日閲覧。 (八)^ ^a ^b日本放送協会. ““ログソフト”に深刻なぜい弱性 IPA 早急な対策呼びかけ”. NHKニュース. 2021年12月14日閲覧。 (九)^ Goodin (2021年12月9日). “Zeroday in ubiquitous Log4j tool poses a grave threat to the Internet”. Ars Technica. 2021年12月10日閲覧。 (十)^ “Worst Apache Log4j RCE Zero day Dropped on Internet”. Cyber Kendra (2021年12月9日). 2021年12月10日閲覧。 (11)^ “Apache Log4j Security Vulnerabilities”. 2021年12月10日閲覧。 (12)^ Mott, Nathaniel (2021年12月10日). “Countless Servers Are Vulnerable to Apache Log4j Zero-Day Exploit”. PC Magazine. 2021年12月10日閲覧。

外部リンク[編集]

ポータル FLOSS

Log4j公式サイト（英語）

ポート[編集]

Log4c - C言語用port
Log4perl - Perl用port
Log4net - .NET Framework用port
log4php - PHP用port
Log4js - JavaScript用port
Log4js-node - Node.js用port
Log4plsql - Oracle PL/SQL用port

[1]

[2]

[3]

[4]

[5]

[6]

[

[8]

[9]

[10]

[11]

[12]

表話編歴 Apacheソフトウェア財団
トップレベルプロジェクト	Accumulo（英語版） ActiveMQ Airflow Ambari（英語版） Ant Aries（英語版） Arrow（英語版） Apache HTTP Server APR Avro（英語版） Axis Axis2 Beam Bloodhound（英語版） Brooklyn（英語版） Buildr（英語版） Calcite（英語版） Camel（英語版） Cassandra Cayenne（英語版） Chemistry（英語版） CloudStack（英語版） Cocoon Cordova CouchDB cTAKES（英語版） CXF（英語版） Derby Directory（英語版） Drill Druid（英語版） Empire-db（英語版） Felix（英語版） Flex Flink（英語版） Flume（英語版） FreeMaker（英語版） Geronimo Giraph（英語版） Gump（英語版） Hadoop HBase Helix（英語版） Hive Impala（英語版） Jackrabbit（英語版） James Jena（英語版） Jini（英語版） JMeter（英語版） Kafka Kudu（英語版） Kylin（英語版） Lucene Mahout Maven MINA（英語版） mod_perl（英語版） MyFaces（英語版） NetBeans Nutch（英語版） NuttX（英語版） OFBiz（英語版） Oozie（英語版） OpenEJB OpenJPA OpenNLP OpenOffice ORC（英語版） PDFBox（英語版） Parquet（英語版） Phoenix（英語版） POI Pig（英語版） Pinot（英語版） Pivot Qpid（英語版） Roller RocketMQ（英語版） Samza（英語版） ServiceMix（英語版） Shiro（英語版） SINGA（英語版） Sling（英語版） Solr Spark Storm（英語版） SpamAssassin Struts 1 Struts 2（英語版） Subversion Apache Superset SystemDS（英語版） Tapestry Thrift Tika（英語版） Tomcat Traffic Server（英語版） Turbine（英語版） UIMA（英語版） Velocity Wicket Xalan Xerces XMLBeans Yetus（英語版） ZooKeeper
Commons	BCEL（英語版） BSF（英語版） Collections Daemon（英語版） DBUtils Email IO Jelly（英語版） Lang Apache Commons Logging（英語版） Math
Incubator	Apache MXNet（英語版） Apache Taverna（英語版）
その他のプロジェクト	Apache Batik Chainsaw（英語版） FOP Ivy（英語版） log4j
Attic	Abdera（英語版） Apache Apex（英語版） AxKit Beehive（英語版） Bluesky（英語版） iBATIS c++ Standard Library（英語版） Cactus（英語版） Click（英語版） Continuum（英語版） Apache Deltacloud（英語版） Apache Etch（英語版） Excalibur（英語版） Forrest（英語版） Hama（英語版） Harmony HiveMind（英語版） Jakarta Lenya（英語版） Marmotta（英語版） ODE（英語版） Shale Slide（英語版） Shindig Stanbol（英語版） Tuscany（英語版） Wave（英語版） Wink（英語版） XML
ライセンス	Apache License
Category Commons