Suporte para Criação de Log do Common Base Event para Aplicativos WebFacing

Executando no WebSphere Application Server

Os aplicativos do WebFacing usam o log do WebSphere Application Server Common Base Event para fazer diagnóstico dos problemas de aplicativo no tempo de execução. Quando se executa um aplicativo WebFacing em um servidor de aplicativos, as informações de criação de log são enviadas por padrão para o console do servidor de aplicativos. Para obter mais informações sobre a criação de log e rastreio no WebSphere Application Server, consulte o centro de informações do seu nível de WebSphere Application Server, por exemplo, http://publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/ttrb_addtrace.html.

É possível configurar o nível de criação de log do criador de logs do aplicativo WebFacing (com.ibm.etools.iseries.webfacing.context_root_name) usando o console administrativo no WebSphere Application Server . Para obter informações sobre como configurar o criador de logs, consulte o Centro de Informações do seu nível do WebSphere Application Server e procure Configurando propriedades de log usando o console administrativo.

Também é possível configurar o nível de detalhes do criador de logs bem como outras configurações para o criador de logs do aplicativo WebFacing usando o arquivo de configuração webfacinglogging.properties.

Por padrão, a mensagem de log no WebSphere Application Server é gravada no console do servidor de aplicativos e o registro de log é gravado no arquivo activity.log do WebSphere Application Server. Se você ativar o rastreio através do console administrativo do servidor de aplicativos, as informações de rastreio serão gravadas no arquivo trace.log da instância do servidor de aplicativos. Quando o rastreio está ativado, todas as mensagens de log são registradas como trace.log no formato de texto simple e todos os registros de log com nível de log CONFIG e acima, também serão registrados em activity.log no formato Common Base Event. Para obter informações sobre como ativar o rastreio no WebSphere Application Server, consulte o centro de informações do seu nível do WebSphere Application Server e procure Ativando rastreio na inicialização do servidor.

Também é possível definir suas configurações para aplicativos WebFacing para separar as informações de rastreio e criação de log de tempo de execução em diferentes arquivos no sistema no qual seu servidor de aplicativos está em execução. Os registros de log, nos quais o nível de log está acima ou igual a CONFIG, são gravados em um arquivo de log e em um arquivo de rastreio, se o rastreio estiver ativado para este criador de logs. Os registros de rastreio, nos quais o nível de log está abaixo de CONFIG, são gravados em um arquivo de rastreio. Consulte a seção Definições de Configuração para um Aplicativo WebFacing abaixo para obter as propriedades que ativam este recurso.

Os arquivos de log e de rastreio são organizados por cada sessão HTTP. O nome do arquivo de log é sessionid.log, onde sessionid é o ID de sessão do navegador que acessa o aplicativo WebFacing. De modo semelhante, o nome do arquivo de rastreio é sessionid.trace. O arquivo de log relacionado a um aplicativo WebFacing é gravado em um diretório com o mesmo nome que o nome da raiz de contexto de seu projeto da Web contendo o aplicativo WebFacing. Consulte a propriedade logFileLocation na seção Definições de Configuração para um Aplicativo WebFacing abaixo para obter informações sobre como configurar o local de seus arquivos de log e de rastreio do WebFacing.

Consulte os tópicos a seguir para obter informações sobre como usar o Agent Controller para IBM® i:

Se quiser simplesmente examinar o texto da mensagem do registro de log, poderá configurar suas definições para formatar o registro de log de modo que ele seja gravado como uma cadeia simples. Consulte a propriedade useXMLFormatForCBELogging na seção Definições de Configuração para um Aplicativo WebFacing abaixo para obter informações sobre como controlar o formato de seu registro de log Common Base Event.

Definições de Configuração para um Aplicativo WebFacing

É possível configurar as configurações de criação de log e rastreio de um aplicativo WebFacing através do arquivo webfacinglogging.properties, que está localizado em WebContent/WEB-INF/classes para um projeto da Web do WebFacing. A seguir você vê as configurações dentro deste arquivo.

# Control the level of runtime logging
# The levels in descending order are:
#   SEVERE (highest value)
#   WARNING
#   INFO
#   CONFIG
#   FINE
#   FINER
#   FINEST (lowest value)
# In addition, there is a level OFF that can be used to turn off logging,
# and a level ALL that can be used to enable logging/tracing of all messages.
# See the Java document for the java.util.logging class for more information.
# The levels above or equal to CONFIG are considered logging.
# The levels below CONFIG are considered tracing.
# Default is SEVERE.
com.ibm.etools.iseries.webfacing.level=SEVERE

# Control if the logging level set in this file will override
# the static configuration settings of log detail levels in WAS
# Valid values are:
#     true  - default
#     false
com.ibm.etools.iseries.webfacing.overrideAdminLevelSetting=true

# Control which directory the log and trace files will be written to.
# A subdirectory with the same name as the web-app will be created
# to store all the log and trace files of a specific web application.
# This value will be used when property "logToFile" is set to true.
# "%WASTraceDir" - trace directory of the WAS server instance.
#                  By default, it is the SERVER_LOG_ROOT variable defined.
#                  in the WAS server. This value will be used as default value
#                  if the web application is running in a WAS environment.
#                  If this value is not available, "%h/iserieslogs" will be used as
#                  default.
# "%h" - the value of the "user.home" system property
#        "%h/iserieslogs" will be used as default value
# "%t" - the value of the system temporary directory
# "."  - the value of the WEB-INF directory
# "/" the local pathname separator
#
# Example for workstation full path:
# "c:\\my_directory\\my_log_dir"
# Please notice that double backslash is needed here.
#
# Example for iSeries IFS full path
# "/home/my_id/my_log_dir"
com.ibm.etools.iseries.webfacing.logFileLocation=%WASTraceDir

# Control if log and trace information will be written to files.
# Valid values are:
#     true
#     false  - default -- In this case the information is written to the console.
com.ibm.etools.iseries.webfacing.logToFile=false

# Control if parent's output handler of this logger will also be used.
# If this property is set to false, the log or tracing information will
# not be written to the WAS activity.log or trace.log
# Valid values are:
#     true  - default
#     false
com.ibm.etools.iseries.webfacing.useParentHandler=true

# Control the format of the Java log records written to a file.
# If this property is set to true, the log records written to the
# log file will be in XML format.
# See the Java  documentation for the java.util.logging.XMLFormatter class
# for more information.
# If this property is set to false, the log records written to the
# log file will be in simple string format.
# Valid values are:
#     true  - default
#     false
com.ibm.etools.iseries.webfacing.useXMLFormatForJSR47Logging=true

# Control the format in which Common Base Event log records are written to a file.
# If this property is set to true, the log records written to the
# log file will be in Common Base Event
# XML format.  
# If this property is set to false, the log records written to the log
# file will be in simple string format.
# Valid values are:
#     true  - default
#     false
com.ibm.etools.iseries.webfacing.useXMLFormatForCBELogging=true

#Control how many log files will be created for each web application
# before the oldest log file is deleted.
com.ibm.etools.iseries.maxlog=3
Nota: Se o servidor de aplicativos estiver em execução no IBM i, talvez seja necessário designar a permissão para este diretório para que os arquivos de log possam ser criados no IFS. Para IBM WebSphere Application Server, é necessário fornecer autoridade de gravação para o perfil do usuário QEJBSVR. Especificamente, o perfil QEJBSVR deve ter autoridade de leitura, gravação e execução para o diretório de rastreio na tabela acima.