{section}
{column}

h1. Introduction

When a request incomes into Petals ESB through a service invocation on a binding component, it fires several other service invocations. All these service invocations form a *flows* or a *process*. Petals ESB provides a mechanism to rebuild these flows or processes executed from an entry point.

This mechanism is based on standard logs. Traces are logged on each input/output of services that are the flow/process steps.

{column}
{column:width=35%}
{panel:title=Table of contents}{toc:outline=true}{panel}
{panel:title=Contributors}{contributors:order=name|mode=list|showAnonymous=true|showCount=true|showLastTime=true}{panel}
{column}
{section}

h1. An example

According to the following flow/process:
!schemaUseCase1.png|width=100%,align=center!

We can get following traces:

| {color:green}{align:center}11{align}{color} | {code}... traceCode = 'provideFlowStepBegin', flowInstanceId = 'f586fc9b0-b374-00216a65569e', flowStepId = 'bb5lk333-sdflkj-5854', flowStepInterfaceName ='{http://petals.com/bpel/UC1/}UC1SubFlow1', flowStepServiceName = '{http://petals.com/bpel/UC1/}UC1SubFlow1Service', flowStepOperationName = '{http://petals.com/bpel/UC1/}process', flowStepEndpointName = 'UC1SubFlow1Endpoint', flowPreviewStepId = 'aa5lk333-sdflkj-5854'{code} |
| {color:red}{align:center}12{align}{color} | {code}... traceCode = 'provideFlowStepEnd', flowInstanceId = 'f586fc9b0-b374-00216a65569e', flowStepId = 'bb5lk333-sdflkj-5854'{code} |
| {color:green}{align:center}13{align}{color} | {code}... traceCode = 'provideFlowStepBegin', flowInstanceId = 'f586fc9b0-b374-00216a65569e', flowStepId = 'cc42lk333-sdflkj-5854', flowStepInterfaceName ='{http://petals.com/}Validation', flowStepServiceName = '{http://petals.com/}ValidationService', flowStepOperationName = '{http://petals.com/}ValidationString', flowStepEndpointName = 'validation', flowPreviewStepId = 'bb5lk333-sdflkj-5854', operation = 'validate', schema = 'schema.xsd'{code} |
| {color:red}{align:center}14{align}{color} | {code}... traceCode = 'provideFlowStepEnd', flowInstanceId = 'f586fc9b0-b374-00216a65569e', flowStepId = 'cc42lk333-sdflkj-5854'{code} |

h1. Logs content & formatting of MONIT level

The default directory for Petals ESB log files is {{$PETALS_HOME}}/logs (you can change logs directory and logs level by following the related configuration documentation). This directory is shared between:
* the petals.log file which holds all informations about bus runtime (bus starting, installing or removing a component, etc);
* a flowMonitoring directory.

The flowMonitoring directory itself will contain subfolders, each one being named after a flow's flowInstanceId. Each such subfolder will contain a file flow.log which will record all logs relating to this particular flow instance (from INFO to MONIT level, or even FINEST level when active).

Whatever their level and usage, logs names (traces in petals.log and flow.log) are always structured like this:
Petals-node-name Date LEVEL \[loggerName\] : Message
FIXME (Petals-node-name : représente le noeud sur lequel se fait les logs) :

On MONIT level, log messages packs two kind of informations:
* standard parameters for this level (are included in every component)
* specific parameters for some logging component.

h4. Standard parameters

_Parameters included in every trace of MONITORING level_
*traceCode*: (represents) the position of the trace in the flow (confer last paragraph).

*flowInstanceId*: (represents) the id of a flow instance.

*flowStepId*: the unique id of a flow step.

*dumpPath*: path for the directory where the IN or OUT message is saved.

_Parameters included only in starting step's traces (MONIT level)_
{section}
{column}

h6. For a Consume Service

*flowStepInterfaceName*: interface name of the first provide invoked (consume service only).

*flowStepServiceName*: service name of the first provide service invoked (consume service only).

*flowStepOperationName*: operation name of the first provide service invoked (consume service only).
{column}

{column}

h6. For a Provide Service

*traceCode*: (represents) the position of the trace in the flow (confer last paragraph).

*flowStepInterfaceName*: interface name of invoked provide service.

*flowStepServiceName*: service name of invoked provide service.

*flowStepOperationName*: operation name of invoked provide service.

*flowStepEndpointName*: endpoint name of invoked provide service.

*flowPreviousStepId*: flowStepId of service which initiated the call (provide service only). \|
{column}
{section}

Parameters recorded in MONIT level when a step fails (ERROR or FAULT state):

*failureMessage*: content of a fault message or an error message .


h4. Specific parameters

These are all parameters which are recorded when a step is starting. It is varying depending on the component.
The table here under presents these traces, varying on component itself and its configuration (consume or provide).
\\
|| Component || Consume || Provide ||
| bc-soap | *requestedURL*: The URL used by the webservice client to invoke the service | *requestedURL*: The URL of the external webservice invoked |
| bc-mail | *scheme*, *host*, *port*, *user*, *folder* | *emailAddress* |
| bc-sftp | N/A | *patterns*, *folder* |
| bc-ftp | N/A | *patterns*, *folder* |
| bc-filetransfer | *filePath* | *fileName*, *destDirName* |
| bc-sql | N/A | *operationSQL* |
| se-bpel | No specific information | No specific information |
| se-eip | No specific information | No specific information |
| se-validation | N/A | No specific information |
| se-xslt | N/A | No specific information |
| se-quartz | *eventTime* | N/A |
| se-jsr-181 | N/A | No specific information |
\\

Definitions of traceCode:
* *consumeFlowStepBegin*: record the fact that an external event is received by a consumer. Such a record can only occur on the consume side of binding-components,

When you activate the log handler {{PetalsPayloadDumperFileHandler}}, any log message is saved as following:
* the log trace is logged in the log file identified by the following pattern: {{$PETALS_HOME/logs/flow-monitoring/<flow instance id>/petals.log}}
* for log trace with level MONIT:
** the content of service request and reply is dumped in a file identified as following: {{$PETALS_HOME/logs/flow-monitoring/<flow instance id>/<flow step id>_<trace code>.xml}}
** the file name of the dumped message is added as a new attribute {{payloadContentDumpFile}} of the MONIT log trace.