Newer Version Available

This content describes an older version of this product. View Latest

External Custom Apex Callout Event Type

External Custom Apex Callout events represent external data callouts via custom adapters for Salesforce Connect This event type is available in the EventLogFile object in API version 40.0 and later.

For details about querying EventLogFile and learning more about event monitoring, see the Force.com REST API Developer Guide.

We provide Salesforce Connect Callout Event Monitoring to customers through a public pilot program. The pilot event types are available in orgs that use Salesforce Connect and Event Monitoring. If your org doesn't have these features, contact your Salesforce account executive to participate in the pilot. Salesforce Connect Callout Event Monitoring is subject to change and isn’t generally available unless or until Salesforce announces its general availability in documentation or in press releases or public statements. We can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features. You can provide feedback and suggestions for Salesforce Connect Callout Event Monitoring in the Salesforce Connect group in the Success Community.

Note

Fields

Field Details
ACTION
Type
String
Description
Action performed by the callout.
Possible Values
  • query
  • upsert
  • delete
ENTITY
Type
String
Description
Name of the external object being accessed.
Example
Order
EVENT_TYPE
Type
String
Description
Type of event. Value is always ExternalCustomApexCallout.
EXECUTE_MS
Type
Number
Description
Reserved for future use.
FETCH_MS
Type
Number
Description
Reserved for future use.
FILTER
Type
Text
Description
Field expressions to filter which rows to return. Corresponds to WHERE in SOQL queries.
Example
Filter:[columnName=CustomerID, columnValue=537, subfilters=null, tableName=Order, type=EQUALS]
LIMIT
Type
Number
Description
Maximum number of rows to return for a query. Corresponds to LIMIT in SOQL queries.
Example
200
OFFSET
Type
Number
Description
Number of rows to skip when paging through a result set. Corresponds to OFFSET in SOQL queries.
Example
0 (default)
ORDERBY
Type
String
Description
Field or column to use for sorting query results, and whether to sort the results in ascending (default) or descending order. Corresponds to ORDER BY in SOQL queries.
Examples
(Order:[columnName=OrderDate, direction=ASCENDING, tableName=Order])
ORGANIZATION_ID
Type
Id
Description
15-character ID of the organization.
Example
00D000000000123
REQUEST_ID
Type
String
Description
Unique ID of a transaction. A transaction can contain one or more events. All events in a transaction have the same REQUEST_ID.
Example
4A13-HSKv3CKs-0FKfceaV
ROWS
Type
Number
Description
Total number of records in the result set.

The value is always -1 if the custom adapter’s DataSource.Provider class doesn’t declare the QUERY_TOTAL_SIZE capability.

Example
200
SELECT
Type
String
Description
Comma-separated list of fields being queried. Corresponds to SELECT in SOQL queries.
Example
(ColumnSelection:[aggregation=NONE, columnName=Name, tableName=Order], ColumnSelection:[aggregation=NONE, columnName=CustomerID, tableName=Order], ColumnSelection:[aggregation=NONE, columnName=OrderDate, tableName=Order])
STATUS
Type
Boolean
Description
Whether the query was successful.
Possible Values
  • 1—Success
  • 0—Failed
  • Empty—Failed with no logged status or message
THROUGHPUT
Type
Number
Description
Reserved for future use.
TIMESTAMP
Type
String
Description
When the event occurred.
Example
20150101000000.000
MESSAGE
Type
String
Description
Error or warning message associated with the failed call.
Example
System.UnexpectedException: Query is either selecting too many fields or the filter conditions are too complicated
SUBQUERIES
Type
Number
Description
Reserved for future use.
TIMESTAMP_DERIVED
Type
DateTime
Description
When the event occurred in ISO8601-compatible format (YYYY-MM-DDTHH:MM:SS.sssZ).
Example
2015-07-27T11:32:59.555Z
TOTAL_MS
Type
Number
Description
How long it took (in milliseconds) to prepare and execute the query and to retrieve the query results.
USER_ID
Type
Id
Description
15-character ID of the user accessing the external system.
Example
00530000009M943