IBM Tivoli Access Manager Java Runtime の一部としてインストールされるコンポ ーネントの場合は、トレースとメッセージ・ロギングは、異なる方法で制御されま す。
これらのコンポーネントに関するトレースとメッセージ・ロギングは、
<java-home-dir>/etc ディレクトリーにある PDJLog.properties という名前のイン ストール済みファイルを介して制御されます。
このファイルの内容により、ユーザーは以下を制御することができます。
v それぞれの Tivoli Access Manager Java Runtime コンポーネントごとにトレース をオンまたはオフにするかどうか
v それぞれの Tivoli Access Manager Java Runtime コンポーネントごとにどのトレ ース・レベルを実行するか
v トレース出力の宛先をどこにするか
v それぞれの Tivoli Access Manager Java Runtime コンポーネント内のどの Java クラスをトレースするか
v メッセージのクラス (FATAL、ERROR、WARNING、NOTICE、または
NOTICEVERBOSE) ごとにメッセージ・ロギングをオンまたはオフのいずれにす
るか
v メッセージのクラスごとのメッセージ・ログ出力の宛先をどこにするか
PDJLog.properties ファイルは、いくつかの「ロガー」を定義するためのもので
す。これらのロガーのそれぞれは、Tivoli Access Manager Java Runtime によってイ ンストールされるいずれかのコンポーネントに関連付けられます。ロガーは次のと おりです。
v PDJadminTraceLogger v PDJasn1TraceLogger v PDJutilTraceLogger v PDJtsTraceLogger v PDJauthzTraceLogger v PDJsvrsslcfgTraceLogger
トレース・ロガーごとに、PDJLog.properties ファイルを使用して、 isLogging 属 性を定義します。この属性の値が ″true″ に設定されると、該当の Tivoli Access Manager Java Runtime コンポーネントのトレースが可能になります。値が ″false″
に設定されると、該当のコンポーネントはトレースされなくなります。
PDJLog.properties ファイルは、PDJTraceLogger と呼ばれる「親」ロガーを定義 するために使用します。この親ロガーも isLogging 属性を含んでいます。個別のロ ガーのそれぞれの isLogging 属性が ″false″ に設定されている場合は、
PDJTraceLogger の isLogging 属性を使用して、すべての Tivoli Access Manager
Java Runtime コンポーネントのトレースを同時に使用可能にしたり使用不可にした
りすることができます。
トレース・ロガーごとに、PDJLog.properties ファイルを使用して、どのレベルの トレースを使用可能にするかを決定するマスク属性を定義します。有効なマスク値 は 1 〜 9 です。前述のように、特定のマスク値の意味は重要ではありません。通 常は、より小さいマスク値からより大きいマスク値 (たとえば、1 から 2) へと値が 大きくなると、ログに記録される詳細情報のレベルが上がることを示すためです。
ロガーのマスク値を特定のレベルに設定することは、指定されたレベルまでのすべ てのトレース・レベルが使用可能になることを意味します。たとえば、ユーザーが マスク・レベルを 4 に設定した場合は、トレース・レベル 1、2、3 も使用可能に なります。
PDJLog.properties ファイルは、PDJTraceAllMaskFilter 属性を定義するためのも のです。この属性を使用して、マスク値 1 〜 9 を割り当てることもできます。個 別のロガーのそれぞれのマスク属性が設定されていない場合は、
PDJTraceAllMaskFilter 属性を使用して、すべての Tivoli Access Manager Java
Runtime コンポーネントに対して同じトレース・レベルを同時に定義することがで
きます。
PDJLog.properties ファイルには、Tivoli Access Manager Java Runtime コンポーネ ントごとに class 属性も含まれます。この属性により、ユーザーは、該当のコンポ ーネントのどの Java クラスをトレースするかを指定することができます。リストが 指定されていない場合は、該当のコンポーネントのすべてのクラスがトレースされ ます。各クラス名はスペースで区切る必要があります。
Tivoli Access Manager Java Runtime コンポーネントのメッセージ・ロギングは、同 様の方法で制御されます。メッセージのクラス (FATAL、ERROR、
WARNING、NOTICE、または NOTICEVERBOSE) ごとに、PDJLog.properties フ ァイルを使用して、該当のメッセージ・クラスをログに記録するかどうかをユーザ ーが指定できるようにする属性を定義します。ユーザーは、これらのメッセージを 記録する場所を指定することもできます。
デフォルトで、Tivoli Access Manager Java Runtime トレース出力は下記のファイル に送られます。
Windows の場合:
<base-install-dir>¥log¥trace__amj.log UNIX の場合:
/var/PolicyDirector/log/trace__amj.log
デフォルトで、Tivoli Access Manager Java Runtime メッセージ・ログ出力は下記の ファイルに送られます。
Windows の場合:
<base-install-dir>¥log¥msg__amj_fatal.log
<base-install-dir>¥log¥msg__amj_error.log
<base-install-dir>¥log¥msg__amj_warning.log
<base-install-dir>¥log¥msg__amj_notice.log
<base-install-dir>¥log¥msg__amj_noticeverbose.log UNIX の場合:
/var/PolicyDirector/log/msg__amj_fatal.log /var/PolicyDirector/log/msg__amj_error.log /var/PolicyDirector/log/msg__amj_warning.log /var/PolicyDirector/log/msg__amj_notice.log /var/PolicyDirector/log/msg__amj_noticeverbose.log 以下は、トレース・ログ項目のフォーマットの例です。
19:15:38.772 --- PROGRAM DEBUG4 jadmin MyApp MyApp Main Main Here is our entry...
19:15:38.772 - Timestamp in GMT format PROGRAM - Program Name (forthcoming)
DEBUG4 - Debug Level
jadmin - Component
MyApp - Subcomponent (i.e. Class)
MyApp - Logging class
Main - Logging method
Main - Thread ID
Here is our entry... - The text of the trace log entry 以下は、PDJLog.properties ファイルの内容の例です。
# 3 43 1.3.1.5 src/com/tivoli/pd/jras/pdjlog/PDJLog.properties,
# pd.jras, am410, 020715a 7/10/02 10:45:14
#
# Licensed Materials - Property of IBM
# 5748-XX8
# (c) Copyright International Business Machines Corp. 2001
# All Rights Reserved
# US Government Users Restricted Rights - Use, duplicaion or disclosure
# restricted by GSA ADP Schedule Contract with IBM Corp.
#---# This section shows the key/value pairs that may be specified to
# configure a PDJTraceLogger. It is the parent of all of the other
# trace loggers. The only value that should potentially be modified
# for this section is the isLogging value.
# To turn trace on for all the PDJRTE components: (1) Set the isLogging value
# for the PDJTraceLogger to true and (2) comment out below the isLogging
# value entry for the individual PDJRTE component trace loggers such as the
# PDJadminTraceLogger.
#---baseGroup.PDJTraceLogger.isLogging=false
#---# This section shows the key/value pairs that may be specified to
# configure a PDJMessageLogger. The only value that should potentially
# be modified for this section is the isLogging value, which is set to true
# by default. To turn on messaging for individual handlers attached to
# this logger, set the isLogging value for each desired handler, such
# as PDJNoticeFileHandler.
#
#---baseGroup.PDJMessageLogger.isLogging=true
#---# This section shows the key/value pairs that may be specified to
# configure an PDJTraceAllMaskFilter.
# The mask key determines the level at which trace is captured. The valid
# trace levels are one of the numerals 1-9. The trace levels are nested.
# Specifying a value of 9 includes levels 1-8, specifying a value of 7
# includes levels 1-7, and so on.
# To set the same mask for all the PDJRTE components:
# (1) Set the mask for the PDJTraceAllMaskFilter to the desired mask,
# and (2) comment out below the AllMaskFilter entries for the individual
# components such as the PDJadminAllMaskFilter.
#---baseGroup.PDJTraceAllMaskFilter.mask=9
#---# This section shows the key/value pairs that may be specified to
# configure a PDJTraceFileHandler.
# The fileName key specifies the file to which the trace output for all
# the PDJRTE components is written out. Specify the base
# file name only. The fully-qualified location will be:
#
# <pd-home>/<var-dir>/PolicyDirector/log/<file-name>
#
# The default fileName is trace__amj.log.
# If either PDJLog.properties or PD.properties is not found, no logging will
# take place.
#---#baseGroup.PDJTraceFileHandler.fileName=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJFatalFileHandler.
# The fileName key specifies the file to which the fatal error output
# for all the PDJRTE components is written out. Specify the base
# file name only. The fully-qualified location will be:
#
# <pd-home>/<var-dir>/PolicyDirector/log/<file-name>
#
# The default fileName is msg__amj_fatal.log.
# If either PDJLog.properties or PD.properties is not found, no logging will
# take place.
#---#baseGroup.PDJFatalFileHandler.fileName=
baseGroup.PDJFatalFileHandler.isLogging=true
#---# This section shows the key/value pairs that may be specified to
# configure a PDJErrorFileHandler.
# The fileName key specifies the file to which the error output
# for all the PDJRTE components is written out. Specify the base
# file name only. The fully-qualified location will be:
#
# <pd-home>/<var-dir>/PolicyDirector/log/<file-name>
#
# The default fileName is msg__amj_error.log.
# If either PDJLog.properties or PD.properties is not found, no logging will
# take place.
#---#baseGroup.PDJErrorFileHandler.fileName=
baseGroup.PDJErrorFileHandler.isLogging=true
#---# This section shows the key/value pairs that may be specified to
# configure a PDJWarningFileHandler.
# The fileName key specifies the file to which the warning output
# for all the PDJRTE components is written out. Specify the base
# file name only. The fully-qualified location will be:
#
# <pd-home>/<var-dir>/PolicyDirector/log/<file-name>
#
# The default fileName is msg__amj_warning.log.
# If either PDJLog.properties or PD.properties is not found, no logging will
# take place.
#---#baseGroup.PDJWarningFileHandler.fileName=
baseGroup.PDJWarningFileHandler.isLogging=true
#---# This section shows the key/value pairs that may be specified to
# configure a PDJNoticeFileHandler.
# The fileName key specifies the file to which the notice output
# for all the PDJRTE components is written out. Specify the base
# file name only. The fully-qualified location will be:
#
# <pd-home>/<var-dir>/PolicyDirector/log/<file-name>
#
# The default fileName is msg__amj_notice.log.
# If either PDJLog.properties or PD.properties is not found, no logging will
# take place.
#---#baseGroup.PDJNoticeFileHandler.fileName=
baseGroup.PDJNoticeFileHandler.isLogging=false
#---# This section shows the key/value pairs that may be specified to
# configure a PDJNoticeVerboseFileHandler.
# The fileName key specifies the file to which the verbose notice output
# for all the PDJRTE components is written out. Specify the base
# file name only. The fully-qualified location will be:
#
# <pd-home>/<var-dir>/PolicyDirector/log/<file-name>
#
# The default fileName is msg__amj_noticeverbose.log.
# If either PDJLog.properties or PD.properties is not found, no logging will
# take place.
#---#baseGroup.PDJNoticeVerboseFileHandler.fileName=
baseGroup.PDJNoticeVerboseFileHandler.isLogging=false
#---# This section shows the key/value pairs that may be specified to
# configure a PDJConsoleHandler.
#
# To enable all trace and message output to the console:
# (1) set the isLogging attribute for the PDJConsoleHandler.islogging
# to true, and
# (2) comment out the console handler entries for the other trace and
# message handler entries in this file.
#
# Setting the isLogging property of the console handlers will add them in
# with the other handlers, i.e. if the file handlers are turned on, turning
# on the console handlers will not turn them off.
#
#---baseGroup.PDJConsoleHandler.isLogging=false
#---# This section shows the key/value pairs that may be specified to
# configure a PDJTraceConsoleHandler.
#---#baseGroup.PDJTraceConsoleHandler.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJMessageConsoleHandler.
#---#baseGroup.PDJMessageConsoleHandler.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJadminTraceLogger.
#---#baseGroup.PDJadminTraceLogger.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJasn1TraceLogger.
#---#baseGroup.PDJasn1TraceLogger.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJutilTraceLogger.
#---#baseGroup.PDJutilTraceLogger.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJtsTraceLogger.
#---#baseGroup.PDJtsTraceLogger.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJauthzTraceLogger.
#---#baseGroup.PDJauthzTraceLogger.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure a PDJsvrsslcfgTraceLogger.
#---#baseGroup.PDJsvrsslcfgTraceLogger.isLogging=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJAdminAllMaskFilter.
#---#baseGroup.PDJadminAllMaskFilter.mask=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJutilAllMaskFilter.
#---#baseGroup.PDJutilAllMaskFilter.mask=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJasn1AllMaskFilter.
#---#baseGroup.PDJasn1AllMaskFilter.mask=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJtsAllMaskFilter.
#---#baseGroup.PDJtsAllMaskFilter.mask=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJauthzAllMaskFilter.
#---#baseGroup.PDJauthzAllMaskFilter.mask=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJsvrsslcfgAllMaskFilter.
#---#baseGroup.PDJsvrsslcfgAllMaskFilter.mask=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJadminClassFilter. Classes in PDJLog are treated as
# subcomponents. Modify the "classes" value to turn on/off the logging
# of different components. A blank value or absent classes qualifier means
# all components will be logged.
#---#baseGroup.PDJadminClassFilter.classes=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJutilClassFilter. Classes in PDJLog are treated as
# subcomponents. Modify the "classes" value to turn on/off the logging
# of different components. A blank value or absent classes qualifier means
# all components will be logged.
#---#baseGroup.PDJutilClassFilter.classes=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJasn1ClassFilter. Classes in PDJLog are treated as
# subcomponents. Modify the "classes" value to turn on/off the logging
# of different components. A blank value or absent classes qualifier means
# all components will be logged.
#---#baseGroup.PDJasn1ClassFilter.classes=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJtsClassFilter. Classes in PDJLog are treated as
# subcomponents. Modify the "classes" value to turn on/off the logging
# of different components. Absence of this qualifier means all components
# will be logged.
#---#baseGroup.PDJtsClassFilter.classes=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJauthzClassFilter. Classes in PDJLog are treated as
# subcomponents. Modify the "classes" value to turn on/off the logging
# of different components. Absence of this qualifier means all components
# will be logged.
#---#baseGroup.PDJauthzClassFilter.classes=
#---# This section shows the key/value pairs that may be specified to
# configure an PDJsvrsslcfgClassFilter. Classes in PDJLog are treated as
# subcomponents. Modify the "classes" value to turn on/off the logging
# of different components. Absence of this qualifier means all components
# will be logged.
#---#baseGroup.PDJsvrsslcfgClassFilter.classes=