2019-07-16-0.md

title	description
Log Level Porting Guide between log4j and Syslog ～ log4j と Syslog 間での、ログレベル変換ガイド

Syslog と log4j のインターフェース定義

Syslog

参考にした日本語訳

• https://sawara.me/psr/2906/
• https://www.ritolab.com/entry/95

Log4j

https://www.tutorialspoint.com/log4j/log4j_logging_levels.htm

日本語は自分で訳した。

図

loglevels.puml

@startuml
left to right direction

namespace Syslog {
    card Emergency [
        Emergency
        システム全体が使用できない。
        通知を飛ばすシステムとかも含めてダウンしている。

        大抵の場合、システム開発者にもどうしようもなく、"災害"のようなもの。

        例： AWS ELB がダウン利用できない、リージョン全体がダウンした、DC が倒壊した、など。
    ]
    card Alert [
        Alert
        直ちに対応する必要がある。
        SMSアラートなどのすぐに気付く方法で通知する。
        ユーザ全体が利用できない規模。

        例：ウェブサイト全体がダウンしている、データベースが利用できない、など。
    ]
    card Critical [
        Critical
        早急に対応・修正する必要がある。
        Slack などの早急に気付く方法で通知する。
        一部のユーザが利用できない規模。

        例：アプリケーションのコンポーネントが利用できない、予期せぬ例外が発生した、など。
    ]
    card Error [
        Error
        即時のアクションを必要としないが、通常はログに記録して監視する必要があるランタイムエラー。
    ]
    card Warning [
        Warning
        エラーではないが、例外的なもの。
        現在はエラーではないが、エラーになる予定のものとか。

        例：廃止予定のAPIの使用、APIの不適切な使用、必ずしも間違っていないが望ましくないもの、など。
    ]
    card Notice [
        Notice
        正常だが、重要なもの。

        例：ログイン失敗、タスクを再試行した、など。
    ]
    card Information [
        Information
        開発者がデバッグ時や調査時に確認するような情報。

        例：ユーザログイン、SQL の実行、画面をクリックした、選んだ選択肢、など。
    ]
    card Debug [
        Debug
        デバッグ用の詳細なログ。
    ]
}
namespace log4j {
    card FATAL [
        FATAL
        アプリケーションが落ちるレベルの、深刻なエラー。
    ]
    card ERROR [
        ERROR
        アプリケーションの実行は継続できるが、エラーなもの。
    ]
    card WARN [
        WARN
        将来的に障害になりそうなもの。

        例：廃止予定のAPIの使用、APIの不適切な使用、必ずしも間違っていないが望ましくないもの、など。
    ]
    card INFO [
        INFO
        アプリケーションの進捗のハイライトなど、確認用の大雑把なメッセージ。

        例：ユーザログイン・ログイン失敗、SQL の実行、タスクを再試行した、など。
    ]
    card DEBUG [
        DEBUG
        デバッグ用の詳細なログ。
    ]
    card TRACE [
        TRACE
        デバッグ用の詳細なログ。
        DEBUG レベルよりも詳細なもの。
        call stack とかを一緒に表示するなど。
    ]

}

Emergency --> FATAL
Alert  --> FATAL
Critical --> FATAL
Error --> ERROR
Warning --> WARN
Notice --> INFO
Information --> INFO
Information --> DEBUG
Debug --> DEBUG
Debug --> TRACE
@enduml