Message Logging Policy

The Message Logging policy lets you send syslog messages to third-party log management services, such as Splunk, Sumo Logic, and Loggly.

If you want to send syslog to one of those services, follow the service documentation of the concerned service to obtain the host, port, and protocol, then set the Syslog element on this policy accordingly.

You can attach this policy in the following locations:

An example payload for the policy is as follows:

<MessageLogging async="false" continueOnError="false" enabled="true" xmlns='http://www.sap.com/apimgmt'>
               <Syslog>
                              <Message>Message.id = {request.header.id}</Message>
                              <Host>10.15.124.66</Host>
               <!-- This is default port value -->
                   <Port>514</Port>
                   <Protocol>TCP</Protocol>
               </Syslog>
</MessageLogging>

Elements and Attributes		Description
`Syslog` destination To send syslog to Splunk, Sumo Logic, or Loggly,	`Message`	Build the message to be sent to the syslog, combining text with variables to capture the information you want. Note Response variables will not be available in PostClientFlow following an Error Flow. Use message variables to log response information for both error and success situations.
	`Host`	The hostname or IP address of the server where the syslog should be sent. If the element is not specified, the default is localhost.
	`Port`	Port where the syslog is running. If you don't include this element, the default is 514.
	`Protcol`	TCP or UDP (default). While UDP is more performant, the TCP protocol guarantees message log delivery to the syslog server. For sending syslog messages over TLS/SSL, only TCP is supported.
	`FormatMessage`	`true` or `false` Optional, but <FormatMessage>true</FormatMessage> is required for use with Loggly. This element lets you control the format of generated content prepended to the message. If set to true, the syslog message is prepended by a fixed number of characters, which lets you filter out that information from messages.