All docs This doc

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

enableSec [policy="key"]

This enables WS-Security for the message which is sent to the endpoint. The optional policy attribute specifies the WS-Security policy.

enableAddressing [version="final | submission"] [seperateListener=" true | false"]

This enables WS-Addressing for the message which is sent to the endpoint. User can specify to have separate listener with version final or submission.

...

Endpoint Timeout

A time out may occur for an Address endpoint if the response fails to arrive at Synapse within a time duration specified in milliseconds. The timeout action specifies whether to discard response that arrives later, or to trigger a fault. Synapse has a periodic timeout handler that triggers itself at each 15 seconds interval. Thus endpoint timeout will have a +/- erroce on trigger time. Though this can be minimized by setting a System property The parameters available to configure an endpoint time out are as follows.

duration

Timeout duration that should elapse before the end point is timed out.

action

This parameter is used to specify the action to perform once an endpoint has timed out. The available options are as follows.

  • discard: If this is selected, the responses which arrive after the endpoint has timed out will be discarded.
  • fault: If this is selected, a fault is triggered when the endpoint is timed out.
Tip

You can specify a value that is 1 millisecond less than the time duration you specify for the endpoint time out for the synapse.timeout_handler_interval

...

property

...

Info
titleNote

A lesser value may have a higher overhead on the system.

Timeout Configuration

duration

Timeout duration in milliseconds.

action

Once a timeout occurs the action to perform, available options are discard (discard the response which arrives late) or fault (trigger a fault) .

Marking Endpoint for Suspension

in the <ESB_Home>/repository/conf/synapse.properties file. This would minimise the number of late responses from the backend.

...

Marking Endpoint for Suspension

The markForSuspension element contains parameters that affect the suspension of a  endpoint which would be timed out after a specified time duration.

As described before (see description on Timeout state above) this configuration element describes the configuration for a timeout endpoint.

...

errorCodes

A comma separated error code list which can be returned by the endpoint. See SynpaseConstant class for a possible list of error codes.

This parameter is used to specify one or more error codes which can cause the endpoint to be marked for suspension when they are returned by the endpoint. Multiple error codes can be specified separated by comas. See SynpaseConstant class for a list of available error codes.

retriesBeforeSuspension

Number of retries before go into suspended state.

The number of times the endpoint should be allowed to retry sending the response before it is marked for suspension.

retryDelay

The delay between each try.

...

Leaf endpoints(Address and WSDL) endpoint can be put into suspended state if it is they are detected as failed endpoints. An endpoint that fails may be suspended When an endpoint is in in suspended state for a specified time duration after such following a failure, during which it cannot process any new messages will not be processed through the endpoint. The amount of time waiting before next attempt follows the following formulafollowing formula determines the wait time before the next attempt.

next suspension time period = Max (Initial Suspension duration * (progression factor* try count*), Maximum Duration)

All the variables in the above formula are configuration values used to calculate the try count. Try count means, how many tries occurred is the number of tries carried out after the endpoint is "Suspended". As suspended. The increase in the try count increases, causes an increase in the next suspension time period will also increase. This increase time period is bound to a maximum duration.

...

 

The parameters available to configure a suspension of an endpoint due to failure are as follows.

errorCode

A comma separated error code list which can be returned by the endpoint.

This parameter is used to specify one or more error codes which can cause the endpoint to be suspended when they are returned from the endpoint. Multiple error codes can be specified, separated by commas.

initialDuration

Initial duration(in milliseconds) to suspend the endpointThe number of milliseconds after which the endpoint should be suspended when it is being suspended for the first time.

progressionFactor

The progression factor for the geometric series. See the above formula for a more detailed description.

maximumDuration

Maximum duration(in milliseconds) to suspend the endpointThe maximum number of milliseconds which should elapse before the endpoint is suspended following failure.

Following are the sample address URI definitions.

...