Logging in PETALS

Version 44 by Adrien Ruffie
on Mar 17, 2011 09:33.

<< Changes from 43 to 44

compared with

Version 45 by Christophe DENEUX
on Mar 17, 2011 10:01.

Changes from 45 to 46 >>

Key

This line was removed.

This word was removed. This word was added.

This line was added.

Changes (105)

View Page History

...

{column}

h1. Logging in Petals ESB

h1. Logging systems

Petals ESB uses two distinct logging systems. Most of the container apart form the registry uses the logger provided by the JDK, while the registry uses Apache log4j.

the registry uses Apache log4j.

The Petals ESB logger configuration is splitted into two default files:

* $PETALS_HOME/conf/loggers.properties: the JDK logger configuration.
* $PETALS_HOME/conf/log4j.properties: the log4j logger configuration.

...

{section}

h21. Petals Logger Levels

Petals defines a specific level: MONIT.

...

{code}

h21. Petals formatters

Petals provides two formatters: PetalsSimpleFormatter and PetalsExtendedFormatter.

...

PetalsSimpleFormatter uses the following pattern:
{panel:borderStyle=solid}{+}YYYY/MM/DD+ +HH:MM:SS,FFF+ +LOG LEVEL+ +LOGGER NAME+ : ?\[LOG MESSAGE\]
\[EXTRA DATA KEY\] = '\[EXTRA DATA VALUE\]'
\[JAVA EXCEPTION\]{panel}

PetalsExtendedFormatter is used to log message content (payload XML of SOAP or JBI Message), attachments name and properties.

The pattern of PetalsExtendedFormatter inherits from the pattern of PetalsSimpleFormatter.

*Example of logging output with PetalsSimpleFormatter:*
{panel:borderStyle=solid}
2011/03/16 14:04:20,829 MONIT \[Petals.Container.Components.petals-bc-soap\] : External request received
client = '192.168.1.95'
processBranchId = '0'
processInstanceId = 'petals:uid:e871ffb0-4fcd-11e0-b428-00123feb3632'
processLoopId = '0'
requestedUrl = 'http://192.168.1.95:8080/petals/services/LoggerDemoService/'
traceCode = 'MON005'
{panel}

*Example of logging output with PetalsExtendedFormatter:*
{panel:borderStyle=solid}
2011/03/16 15:57:33,798 MONIT \[Petals.Container.Components.petals-bc-soap\] : External request received
attachmentNames = ''
client = '192.168.1.95'
processBranchId = '0'
processInstanceId = 'petals:uid:b95be910-4fdd-11e0-b678-00123feb3632'
processLoopId = '0'
requestedUrl = 'http://192.168.1.95:8080/petals/services/LoggerDemoService/'
soapEnvelope = '<?xml version='1.0' encoding='utf-8'?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:log="http://petals.ow2.org/bpel/LoggerDemo/"><soapenv:Body>
<log:LoggerDemoRequest>
<log:input>test</log:input>
</log:LoggerDemoRequest>
</soapenv:Body></soapenv:Envelope>'
traceCode = 'MON005'
{panel}

{builder-infopanel:The performance of Petals ESB is reduced when the PetalsExtendendFormatter is activate.}
{info:title=Default behavior}One or both previous formatters are always used during execution, unless default handler formatters in ../conf/logger.properties are changed
{info}
If following formatter is applied for both handlers:

*java.util.logging.FileHandler.formatter = org.ow2.petals.commons.logger.PetalsSimpleFormatter*
*java.util.logging.ConsoleHandler.formatter = org.ow2.petals.commons.logger.PetalsSimpleFormatter*

All logs are processed by the PetalsSimpleFormatter whether we are in _FINEST{_}_, SEVERE, CONFIG ... MONIT_, but

the both previous log traces are written if the level *MONIT* is precised.

h21. Specifics log informations

Following informations are +common{+}{+}s+ to both formatters:

...

After that, _Extended_ formatter allows to precise more detailled informations, as with SOAP component,

...

h21. Appendix

h32. Default loggers.properties

The default *loggers.properties* is :
{noformat}# PETALS: PETALS Services Platform

# This library is free software; you can redistribute it and/or

# modify it under the terms of the GNU Lesser General Public

# License as published by the Free Software Foundation; either

# version 2.1 of the License, or any later version.

# This library is distributed in the hope that it will be useful,

# but WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

# Lesser General Public License for more details.

# You should have received a copy of the GNU Lesser General Public

# License along with this library; if not, write to the Free Software

# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307

# USA.

# Initial developer(s): EBM WebSourcing

handlers=java.util.logging.FileHandler, java.util.logging.ConsoleHandler

java.util.logging.FileHandler.level = FINEST

java.util.logging.FileHandler.pattern = ${petals.home}/logs/petals.log

java.util.logging.FileHandler.formatter = org.ow2.petals.commons.logger.PetalsSimpleFormatter

java.util.logging.FileHandler.append = true

java.util.logging.ConsoleHandler.level = FINEST

java.util.logging.ConsoleHandler.formatter = org.ow2.petals.commons.logger.PetalsSimpleFormatter

##Root level

.level = FINEST

##Petals level

Petals.level = FINEST

#Petals.PetalsAdminService.level = FINEST

#Petals.AutoLoaderService.level = FINEST

#Petals.ConfigurationService.level = FINEST

#Petals.Container.level = FINEST

#Petals.Container.ContainerService.level = FINEST

#Petals.Container.Components.level = FINEST

#Petals.Container.Lifecycle.level = FINEST

#Petals.Container.Lifecycle.ComponentLifeCycle.level = FINEST

#Petals.Container.Lifecycle.Installer.level = FINEST

#Petals.Container.Lifecycle.ServiceAssemblyLifeCycle.level = FINEST

#Petals.Container.Lifecycle.SharedLibraryLifeCycle.level = FINEST

#Petals.Communication.level = FINEST

#Petals.Communication.TopologyService.level = FINEST

#Petals.Communication.JNDIAgentService.level = FINEST

#Petals.Communication.JNDIService.level = FINEST

#Petals.Communication.JMXService.level = FINEST

#Petals.Communication.RMIConnector.level = FINEST

#Petals.Communication.RemoteCheckerClient.level = FINEST

#Petals.Tools.WebServiceManager.level = FINEST

#Petals.System.level = FINEST

#Petals.System.PersistenceService.level = FINEST

#Petals.System.LoaderManagerService.level = FINEST

#Petals.System.SystemStateService.level = FINEST

#Petals.System.RepositoryService.level = FINEST

#Petals.System.Artifact.FractalArtifactRepositoryService.level = FINEST

#Petals.JBI-Management.level = FINEST

#Petals.JBI-Management.AdminService.level = FINEST

#Petals.JBI-Management.SystemRecoveryService.level = FINEST

#Petals.JBI-Management.InstallationService.level = FINEST

#Petals.JBI-Management.ComponentInstallationService.level = FINEST

#Petals.JBI-Management.DeploymentService.level = FINEST

#Petals.JBI-Management.AtomicDeploymentService.level = FINEST

#Petals.JBI-Management.TransactionManager.level = FINEST

#Petals.JBI-Messaging.level = FINEST

#Petals.JBI-Messaging.RouterMonitorService.level = FINEST

#Petals.JBI-Messaging.RouterService.level = FINEST

#Petals.JBI-Messaging.FlowControllerModule.level = FINEST

#Petals.JBI-Messaging.FlowFilterModule.level = FINEST

#Petals.JBI-Messaging.PriorityOrdererModule.level = FINEST

#Petals.JBI-Messaging.TransportResolverModule.level = FINEST

#Petals.JBI-Messaging.AuthorizationModule.level = FINEST

#Petals.JBI-Messaging.EndpointResolverModule.level = FINEST

#Petals.JBI-Messaging.JAASAuthenticationModule.level = FINEST

#Petals.JBI-Messaging.PriorityOrdererModule.level = FINEST

#Petals.JBI-Messaging.EndpointRegistry.level = FINEST

#Petals.JBI-Messaging.JMXExchangeCheckerClient.level = FINEST

#Petals.JBI-Component.ComponentContext.level = FINEST

#Petals.Transporter.level = FINEST

#Petals.Transporter.LocalTransporter.level = FINEST

#Petals.Transporter.NioTransporter.level = FINEST

#Petals.Transporter.NioTransportProtocol.NioSelectorAgent.level = FINEST

#Petals.Transporter.NioTransportProtocol.NioServerAgent.level = FINEST

#Petals.Transporter.NioTransportProtocol.NioClientObjectPool.level = FINEST

#Petals.WS.level = FINEST

#Petals.WS.ArtifactRepositoryService.level = FINEST

#Petals.WS.DeploymentService.level = FINEST

#Petals.WS.DragonConnectionService.level = FINEST

#Petals.WS.EndpointService.level = FINEST

#Petals.WS.InformationService.level = FINEST

#Petals.WS.InstallationService.level = FINEST

#Petals.WS.JBIArtefactsService.level = FINEST

#Petals.WS.RuntimeService.level = FINEST

#Petals.WS.ServiceAssemblyStateService.level = FINEST

#Petals.WS.TopologyService.level = FINEST

{noformat}

...

Wiki

All versions of Petals ESB

Helpful links

Logging in PETALS

Changes (105)