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 

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 multipage 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.
• Example: 20130715233322.670

TIMESTAMP_DERIVED 

• Type: DateTime
• Description: The access time of Salesforce services in ISO8601-compatible format (YYYY-MM-DDTHH:MM:SS.sssZ). The timezone is GMT.
• 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 data source.
• Example: 00530000009M943