Troubleshooting Salesforce Connector 11.1 | MuleSoft Documentation
# Troubleshooting Salesforce Connector 11.1
To troubleshoot Anypoint Connector for Salesforce (Salesforce Connector), become familiar with the information about performing general troubleshooting and interpreting commonly thrown exception messages.
## Enable SSL Logging
Enable SSL logs to investigate an issue related to TLS communications.
Set your SSL log level depending on your required level of detail:
  1. Enable only SSL log details:
`javax.net.debug=ssl`
  2. Enable only handshaking details. (The handshake protocol is a series of messages exchanged over the record protocol.)
`javax.net.debug=ssl:handshake`
  3. Enable handshaking details and SSL details at the same time:
`javax.net.debug=ssl, handshake`
  4. Enable the dumping of all details and traffic data:
`javax.net.debug=all`
This option is very verbose and under normal circumstances is not necessary.   
---  


SSL logging results in a performance impact for HTTPS or other TLS connections. Enable SSL logging only to troubleshoot a specific issue and do not enable it for extended periods. SSL logging produces a significant amount of log messages and can inundate your log file if it is left enabled and unattended.   
---  
To enable SSL logs:
Set the debug parameter as an argument in the runtime configuration for the application.
  1. In Studio, right-click on the project and select **Run > Run Configurations**.
  2. Go to the **Arguments** tab and add `-M-Djavax.net.debug=ssl` in the **VM arguments** section.


## Enable Verbose Exception Logging
Enable verbose exception logs to show a complete stack trace of the error instead of the default truncated output:
  1. In Studio, right-click on the project and select **Run > Run Configurations**.
  2. Go to the **Arguments** tab and append the arguments in the **VM arguments** section to add the `mule.verbose.exceptions` property. For example:
`-XX:PermSize=128M -XX:MaxPermSize=256M -Dmule.verbose.exceptions=true`


## Enable Verbose Logging
To get a better understanding of why an application’s interaction with Salesforce Connector is failing, temporarily enable verbose logging for the connector.
Remember to always disable enhanced verbosity after troubleshooting, because it can affect your Mule application’s performance.
To enable verbose logging in the configuration file:
  1. Access Anypoint Studio and navigate to the **Package Explorer** view.
  2. Open your application’s project name.
  3. Open the `src/main/resources` folder.
  4. Open the `log4j2.xml` file inside the folder.
  5. Add an `<AsyncLogger>` tag inside the `<Loggers>` tag:
```
			<Loggers>
				...
				<AsyncLogger name="org.mule.extension.salesforce" level="DEBUG"/>
				...
			</Loggers>
```

  6. Save your application changes.
  7. Click the project name in **Package Explorer** and then click **Run** > **Run As** > **Mule Application**.


## Perform General Troubleshooting
Here is a list of general troubleshooting guidelines for Salesforce Connector:
  * Evaluate Values in a Salesforce List
  * Insert Values in a Salesforce Connector List
  * Japanese Support
  * Limits on API Calls
  * Opportunity Object


### Currency
Currency values cannot exceed 18 characters in length.
When working with multiple currencies, you must know which currency your sObject uses to avoid inaccurate entries. The default currency matches the location at the organization level.
### Evaluate Values in a Salesforce List
When using a value to evaluate against contents of an existing list field in Salesforce, use the exact value in the list. For example, if you use the value `US` to evaluate against contents of a list that contains the value `USA`, the evaluation works, but the result returns two values in the list: one for `US` and one for `USA`.
### Insert Values in a Salesforce Connector List
Inserting dependent values into an existing list in Salesforce Connector does not always work. Test to confirm this functionality.
### Japanese Support
Salesforce Connector supports Japanese characters for all operations, with the following exceptions:
  * The **Publish Streaming Channel** operation does not support Japanese characters in the **Channel name** field, which can contain only alphanumeric characters, and the `_` or `/` characters. Refer to the Salesforce StreamingChannel documentation for more information.
  * Metadata operations might return error messages if some fields contain Japanese characters. For example, creating custom objects or custom fields with a **Full Name** that contains Japanese characters triggers a `FIELD_INTEGRITY_EXCEPTION` error with the following message: `The Object Name field can only contain underscores and alphanumeric characters. It must be unique, begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores.`


### Limits on API Calls
You must know the scope of the rate limiting policy that applies to your account so that you do not exceed the number of allotted API calls per day.
### Opportunity Object
When extracting data from a Salesforce Opportunity object, be aware that a `quarter` in this context is relative to the fiscal year of the organization and not necessarily to the calendar year.
## Understand Commonly Thrown Exceptions
Here is a list of commonly thrown exception messages and how to interpret them:
  * SALESFORCE:COMMUNICATION
```
A communication error occurs between systems.
```

  * SALESFORCE:CONNECTIVITY
```
A problem occurred and a connection could not be established. Review your Salesforce Connector configuration and reconnection strategy.
```

  * SALESFORCE:INSUFFICIENT_PERMISSIONS
```
The provided permissions are insufficient.
```

  * SALESFORCE:INVALID_INPUT
```
The provided input data for an operation is not valid.
```

  * SALESFORCE:INVALID_RESPONSE
```
The response from the server cannot be processed.
```

  * SALESFORCE:LIMIT_EXCEEDED
```
A specific limit is exceeded, for example, if you try to create more than 200 entities at once with the *Create* operation.
```

  * SALESFORCE:MUTUAL_AUTHENTICATION_FAILED
```
The mutual authentication failed.
```

  * SALESFORCE:NOT_FOUND
```
The server could not find the requested resource.
```

  * SALESFORCE:OPERATION_NOT_SUPPORTED
```
The operation is not supported.
```

  * SALESFORCE:RETRY_EXHAUSTED
```
The maximum number of retries for the operation is reached.
```

  * SALESFORCE:TIMEOUT
```
A specific request takes longer than a configured amount of time to complete.
```

  * SALESFORCE:UNAVAILABLE
```
The server is unavailable.
```



## See Also
  * Introduction to Anypoint Connectors
  * Salesforce Connector Reference
  * MuleSoft Help Center
  *