External Data Source Callout Event Type

External Data Source Callout events represent external data callouts via the Salesforce Connect adapters for Amazon DynamoDB and Amazon Athena. This event type is available in the EventLogFile object in API version 56.0 and later.

For details about event monitoring, see the Trailhead Event Monitoring module or REST API Developer Guide.

Fields

Field Details
ACTION
Type
String
Description
Action performed by the callout.
Possible Values
For Amazon DynamoDB data source:
  • query
  • insert
  • delete
  • update
  • upsert
For Amazon Athena data source:
  • query
DATA_SOURCE_NAME
Type
String
Description
Name of the external data source being accessed.
EVENT_TYPE
Type
String
Description
Type of event. Value is always ExternalDataSourceCallout.
EXTERNAL_OBJECT
Type
String
Description
Name of the external object being accessed.
FETCH_MS
Type
Number
Description
How long it took (in milliseconds) to retrieve the query results from the external data source.
Example
127
FILTER
Type
Text
Description
Field expressions to filter which rows to return. Corresponds to WHERE in queries.
LIMIT
Type
Number
Description
Maximum number of rows to return for a query. Corresponds to Limit parameter in ExecuteStatement operation for an Amazon DynamoDB data source.
MESSAGE
Type
String
Description
Error or warning message associated with the failed call.
NEXT_LINK
Type
String
Description
Next link that the callout used to request a subsequent page of rows. A next link is provided in a previous response when the response includes only part of the result set.

For requests to AWS data sources, this field stores the nextToken parameter that contains a unique hash string.

OFFSET
Type
Number
Description
Number of rows to skip when paging through a result set. Corresponds to OFFSET in queries to Amazon Athena. This field is not supported by queries to Amazon DynamoDB.
OPERATION
Type
String
Description
The operation that’s being performed.
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 queries.
Example
  • Country ASC
  • CustomerName DESC
ORGANIZATION_ID
Type
Id
Description
15-character ID of the organization.
Example
00D000000000123
PARENT_CALLOUT
Type
String
Description
If the callout requested a subsequent page of rows, this field identifies the initial callout whose request resulted in the multi-page result set.
Example
4EoZtuBzzRIXSk-ysRdf1F-1
PROVIDER_TYPE
Type
String
Description
Whether the callout was made by Salesforce Connect adapter for Amazon DynamoDB or Amazon Athena.
Possible Values
  • amazonDynamodb
  • amazonAthena
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
RESPONSE_SIZE
Type
Number
Description
The size of the callout response, in bytes.
ROWS_FETCHED
Type
Number
Description
Number of records fetched by the callout. The records fetched by a callout can be a subset of a large result set.
Example
200
SEARCH
Type
String
Description
Search query string.
SELECT
Type
String
Description
Comma-separated list of fields being queried. Corresponds to SELECT in queries.

To query, Salesforce Connect adapter uses PartiQL with Amazon DynamoDB and SQL with Amazon Athena.

Example
CustomerID,OrderDate,OrderID,ShipCity,ShipCountry
STATUS
Type
Boolean
Description
Whether the query was successful.
Possible Values
  • 1—Success
  • 0—Failed
STATUS_CODE
Type
Number
Description
The HTTP response status code for the request.
TABLE_NAME
Type
String
Description
Name of the table being queried in the AWS data source.
THROUGHPUT
Type
Number
Description
Number of records retrieved in one second.
Example
3025.67
TIMESTAMP
Type
DateTime
Description
The access time of Salesforce services in GMT.
For example: 20130715233322.670.
TIMESTAMP_DERIVED
Type
DateTime
Description
The access time of Salesforce services in ISO8601-compatible format (YYYY-MM-DDTHH:MM:SS.sssZ).
For example: 2015-07-27T11:32:59.555Z. Timezone is GMT.
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 data source.
Example
00530000009M943