Skip to main content

ログプロパティの構成オプション

この記事には、ログプロパティファイルの構成に関する情報が含まれます。ログ設定を変更する必要がない場合は、このセクションはスキップして飛ばすことができます。

ログプロパティファイルは、自動登録構成ユーティリティのログプロパティ設定を使用して指定します。以下は、デフォルトのプロパティファイルの内容を示したものです。

# A line starting with # is a comment and ignored.
# Define with log-level (DEBUG, INFO, WARN, or ERROR) and appender name
log4cpp.rootCategory=INFO, DAILY
# Configured appender type
log4cpp.appender.DAILY=DailyRollingFileAppender
# File name and path
# AE Server requires write permission, and directory must exist
log4cpp.appender.DAILY.fileName=C:\Program Files\DigiCert\AEServer\logs\AEServer.log
# Max days to keep the old log files
log4cpp.appender.DAILY.maxDaysKeep=30
# Output pattern (see http://log4cpp.sourceforge.net/#faq for format details)
log4cpp.appender.DAILY.layout=PatternLayout
log4cpp.appender.DAILY.layout.ConversionPattern=%d{%Y-%m-%d %H:%M:%S} %-5p [%t] %m%n
1. ログプロパティの詳細

プロパティキー

説明

log4cpp.rootCategory

構成に使用するログレベルとログ名を指定します。

値は次の形式になります。

<log_level>,<logger_name>

  • log_levelは、ロギングのレベルを記述したものです。

  • DEBUG(デバッグ)INFO(情報)WARN(警告)、またはERROR(エラー)に設定することができます。このうち、DEBUG(デバッグ)が最も冗長となります。

  • レベルをDEBUG(デバッグ)に設定すると、ログ出力量が大幅に増加しますので、プロダクション環境での使用には注意が必要です。

  • logger_name は設定名を記述したもので、他のプロパティキーでも使用されます。これには任意の値を指定できますが、デフォルトとしてデイリーが使用されます。

log4cpp.appender.<logger_name>

ログアペンダーのタイプを指定します。

現在は、DailyRollingFileAppenderとSyslogAppenderが対象です。DailyRollingFileAppenderアペンダーを使用するとログファイルが毎日00:00(現地時間)にローテーションし、<log_filename>.yyyy-MM-ddという名前のログファイルが作成されます。

注記

ログファイルのローテーションは、00:00(現地時間)以降に新しいログエントリがある場合にのみ発生します。

SyslogAppender アペンダーを使用すると、自動登録サーバは設定された syslog サーバにログメッセージをダンプできるようになります。このアペンダーの詳細については、Syslog 用のAutoenrollment Serverの構成を参照してください。

log4cpp.appender.<logger_name>.fileName

ログファイル名とパスを指定します。

デフォルトの場所は、<インストールディレクトリ>\AEServer.log になります。これは、Autoenrollment Serverがインストールされた場所によって変更されます。

注記

  • ログファイルディレクトリが存在していなければなりません。

  • 自動登録サービスには、このファイルに対する書き込み権限が必要です。

log4cpp.appender.<logger_name>.maxDaysKeep

ログファイルを保存する最大日数を指定します。

最大日数を超えたログエントリは、ファイルシステムから削除されます。

log4cpp.appender.<logger_name>.layout

ログのレイアウトクラスを指定します。

現在、PatternLayoutのみが対象です。

log4cpp.appender.<logger_name>.ConversionPattern

ログの出力形式を指定します。

カスタムログメッセージに使用可能なフォーマット文字の詳細については、http://log4cpp.sourceforge.net/#faq を参照してください。

デフォルトのログフォーマットは、“<Date{yyyy-mm-dd}> <Time{hh:mm:ss}> <LogLevel> [<TheadID>] <LogMessage>”.に設定されています。

以下の例:

2021-09-22 04:15:28 INFO [6176] pki-ws.symauth.com:443 で承認局(CA)バックエンドを使用。


注記

  • ファイルの内容を変更した場合は、自動登録サービスを再起動後に有効になります。

  • #で始まる行は無視されます。