--- schema_version: "1" id: 2d790a797e55784e29815453aacbf304e417aeae2c5ebfd343a9e5b0be2422c7 title: Outbound Message Logging Policy collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/gateway/1.12/policies-outbound-message-logging.md canonical_url: https://docs.mulesoft.com/gateway/1.12/policies-outbound-message-logging source_site: docs.mulesoft.com content_type: documentation content_hash: b3fd3fa7d3397d35775ac3165eca1aef9798b2db5cfc069db35b90d6d0b13d94 description: MuleSoft Documentation Site release: "1.12" latest: false --- # Outbound Message Logging Policy

Policy name

Outbound Message Logging

Summary

Logs custom messages from outbound requests sent to upstream services, responses from upstream services, or information from other outbound policies applied to the same upstream service

Category

Troubleshooting

First Flex Gateway version available

v1.11.0

Returned Status Codes

No return codes exist for this policy
## [](#summary)Summary The Outbound Message Logging policy logs custom messages from outbound requests sent to upstream services, responses from upstream services, or information from other outbound policies applied to the same upstream service. This policy is applied at the upstream level. ## [](#configuring-policy-parameters)Configuring Policy Parameters ### [](#local-mode)Flex Gateway Local Mode When you apply the policy via declarative configuration files, Refer to the following policy definition and table of parameters: apiVersion: gateway.mulesoft.com/v1beta1 kind: PolicyBinding metadata: name: outbound-message-logging spec: targetRef: kind: Service name: upstream policyRef: name: message-logging-outbound-flex config: loggingConfiguration: - itemName: // REQUIRED itemData: //REQUIRED message: // REQUIRED conditional: // OPTIONAL category: // OPTIONAL level: // REQUIRED firstSection: // OPTIONAL secondSection: // OPTIONAL
Parameter Required or Optional Default Value Description

loggingConfiguration

Required

N/A

Array of configurations.

loggingConfiguration.itemName

Required

N/A

Configuration name.

loggingConfiguration.itemData.message

Required

N/A

DataWeave expression that resolves to the message log. To learn more about supported DataWeave expressions, see DataWeave Expressions Support.

loggingConfiguration.itemData.conditional

Optional

true

DataWeave expression that resolves to whether the message should be logged. To learn more about supported DataWeave expressions, see DataWeave Expressions Support.

loggingConfiguration.itemData.category

Optional

Default category

Log message prefix that indicates the package and class where the log is executed.

loggingConfiguration.itemData.level

Required

N/A

Defines the level of message to log: INFO, WARN, ERROR, or DEBUG
For more information, see Message Logging Severity Levels.

loggingConfiguration.itemData.firstSection

Optional

false

Boolean that indicates if messages are logged before the outbound request is sent to the upstream service, taking into account the order in which this policy is applied.

loggingConfiguration.itemData.secondSection

Optional

false

Boolean that indicates if messages are logged after receiving the response from the upstream service, taking into account the order in which this policy is applied.
#### [](#resource-configuration-example)Resource Configuration Example apiVersion: gateway.mulesoft.com/v1beta1 kind: PolicyBinding metadata: name: outbound-message-logging spec: targetRef: kind: Service name: my-upstream policyRef: name: message-logging-outbound-flex config: loggingConfiguration: - itemName: "Outbound Request Log" itemData: message: "#\[payload\]" conditional: "#\[attributes.queryParams\['debug'\]=='true'\]" level: "INFO" firstSection: true - itemName: "Outbound Response Log" itemData: message: "#\['Upstream response: ' ++ attributes.statusCode as String\]" level: "INFO" secondSection: true ### [](#connected-mode)Managed Flex Gateway and Flex Gateway Connected Mode When you apply the policy from the UI, the following parameters are displayed:
Parameter Description Required or Optional

Message

A DataWeave expression for extracting the message to be logged from outbound requests or upstream responses. To learn more about supported DataWeave expressions, see DataWeave Expressions Support.

Required

Conditional

A DataWeave Boolean expression used to specify whether a message is to be logged. To learn more about supported DataWeave expressions, see DataWeave Expressions Support.

Optional

Category

A prefix in the log message that indicates the package and class where the log is executed.

Optional

Level

The level of message to log: INFO, WARN, ERROR, or DEBUG.
For more information, see Message Logging Severity Levels.

Required

Before Sending Request

Set to cause your logging policy to log messages before the outbound request is sent to the upstream service, taking into account the order in which this policy is applied.

Optional

After Receiving Response

Set to cause your logging policy to log messages after receiving the response from the upstream service, taking into account the order in which this policy is applied.

Optional
## [](#dataweave-support)DataWeave Expressions Support The Outbound Message Logging policy supports the [standard DataWeave Expressions supported by Flex Gateway policies](https://docs.mulesoft.com/gateway/1.12/policies-flex-dataweave-support) and the following additional [`vars`](https://docs.mulesoft.com/dataweave/latest/dataweave-variables-context) DataWeave expressions. Format the following expressions `[vars.]`, for example `[vars.orgId]`: - `orgId` - `masterOrgId` - `envId` - `apiId` - `apiName` - `apiInstanceName` - `apiVersion` - `receivedTs` (rfc3339) - `repliedTs` (rfc3339, only available in response context) - `runtimeVersion` (For example: `v1.7.0`) - `hostId` (For example: `my-host`) - `reqId` (Referred to as `traceId` in Flex Gateway logs) - `requestDisposition` (`PROCESSED` or `VIOLATION`, only available in request context) - `request.remoteAddress` - `request.method` - `request.requestPath` - `request.headers` (all request headers) - `upstream.uri` (URI of the upstream service) - `upstream.headers` (headers sent to upstream service) - `upstream.statusCode` (status code from upstream response, only available in response context) - `violation.clientId` (Only available in response context) - `violation.clientName` (Only available in response context) - `violation.policyName` (Only available in response context) - `violation.violationType` (`VIOLATION` or `ERROR`, only available in response context) ## [](#how-this-policy-works)How This Policy Works Logging an outbound policy consists of the following sequence: 1. An outbound request is prepared to be sent to an upstream service. 2. The message is logged if these conditions are `true`: - The level and category of the log defined in the policy are included in the logger defined in the configuration file. - Either the conditional field of the policy is not set, or is set and the condition is met. - The `firstSection` flag is enabled (if logging before sending the request). 3. The request is sent to the upstream service. 4. The upstream service responds. 5. The message is logged if these conditions are `true`: - The level and category of the log defined in the policy are included in the logger defined in the configuration file. - Either the conditional field of the policy is not set, or is set and the condition is met. - The `secondSection` flag is enabled (if logging after receiving the response). 6. The response is returned to the client. Outbound Message Logging Policy does not interfere with the execution of any policy nor its flow. 7. The message appears in the application log. ## [](#logging-format)Logging Format A message log uses this format: ` [flex-gateway-envoy][] wasm log .default..default.svc main: [req: ] [accessLog] ` - `policy-name`: displays the name of the policy binding. - `api-name`: displays the name of the api instance. - `request uuid`: displays a unique identifier for the request that triggered the message. ## [](#severity-levels)Message Logging Severity Levels When you configure a Message Logging policy for your API instance, you can assign a severity level. Each severity level includes a specific set of information in the log report. Log reports include the severity level you select and the following levels on the hierarchy. For example, if you select DEBUG, the log reports include the DEBUG severity level as well as the INFO, WARN, and ERROR severity levels. However, if you select ERROR, the log reports include only error messages. The following table describes the type of information included in the logs for each severity level:
Log Severity Level Description

DEBUG

Tracing information used by application developers.

INFO

Informational messages that highlight the progress of the application.

WARN

Potentially harmful situations that indicate potential problems.

ERROR

Events that prevent normal program execution but might allow the application to continue running.