Versions Compared

Key

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

...

HTTP inbound endpoint parameters

Parameter                                                      Description                                                      Required                                                               
inbound.http.port

The port on which the endpoint listener should be started.

Yes
Info
titleNote
  • A sequence should be designed with a call/respond or send/receive sequence. It is not recommended to use a sequence that has in and out mediators.
  • If a send mediator is used within the inbound endpoint sequence, specify a receiving sequence. If you do not specify a receiving sequence, the response will dispatch to the main sequence.

...

By default inbound endpoints share the PassThrough transport worker pool to handle incoming requests. If you need a separate worker pool for the inbound endpoint, you need to configure the following parameters:

 Parameter                                                                                Description                                                                                                                                                                        Default Value                                 

inbound.worker.pool.size.core

The initial number of threads in the worker thread pool. This value can be changed accordingly based on the number of messages to be processed. The maximum value that can be specified here is the value of the i nbound.worker.pool.size.max parameter.400

inbound.worker.pool.size.max

The maximum number of threads in the worker thread pool. Specify a maximum limit in order to avoid performance degradation that can occur due to context switching.

500

inbound.worker.thread.keep.alive.sec

The keep-alive time for extra threads in the worker pool. This value should be less than the socket timeout. When this time is elapsed for an extra thread, it will be destroyed. The purpose of this parameter is to optimize the usage of resources by avoiding wastage that results from having extra threads that are not utilized.60

inbound.worker.pool.queue.length

The length of the queue that is used to hold runnable tasks to be executed by the worker pool. The thread pool starts queuing jobs when all existing threads are busy and the pool has reached the maximum number of threads. The value for this parameter should be -1 to use an unbounded queue. If a bound queue is used and the queue gets filled to its capacity, and any further attempt to submit jobs will fail causing synapse to drop some messages.-1

inbound.thread.group.id

Unique Identifier of the thread group.

PassThrough inbound worker thread group

inbound.thread.id

Unique Identifier of the thread.

PassThroughInboundWorkerThread

dispatch.filter.patternThe regular expression that defines the proxy services and API's to expose via the inbound endpoint. Provide the .* expression to expose all proxy services and API's or provide an expression similar to ^(/foo|/bar|/services/MyProxy)$ to define a set of services to expose via the inbound endpoint. If you do not provide an expression only the defined sequence of the inbound endpoint will be accessible.blank

 


Following is a sample configuration for an inbound endpoint with a separate worker pool:

...

If a proxy service is to be exposed only via inbound endpoints, the following service parameter has to be set in the proxy configuration.

Service ParameterDescriptionDefault Value
inbound.only

Whether the proxy service needs to be exposed only via inbound endpoints.

If set to true all requests that the proxy service receives via normal transport will be rejected. The proxy service will process only the requests that are received via inbound endpoints.

false

Following is a sample proxy configuration:

...