---
schema_version: "1"
id: 4938a03be0a7a5500a6084d64578504a7f63a2c32970680564b35c9e074cfa87
title: Apex Interactions
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform-pkg-exchange/managed_packaging/guides/second-generation/appexchange/app-analytics/app-analytics-read-logs/app-analytics-read-logs-apex-interactions.md
canonical_url: https://developer.salesforce.com/docs/platform/pkg2-dev/guide/app-analytics-read-logs-apex-interactions.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 17862e3feeb95094720d10961520dd0f1119fdafb8396d1d869ed7d5cbeb86ad
products:
  - Second-Generation Managed Packaging Developer Guide
  - merged-docs
---

# Apex Interactions

Each record in your package usage log that has a `custom_entity_type` of `ApexClass` or `ApexTrigger` describes an interaction with your packaged Apex class or trigger.

|                                                                                          |
| ---------------------------------------------------------------------------------------- |
| Available in: both Salesforce Classic and Lightning Experience                           |
| Available in: **Enterprise**, **Performance**, **Unlimited**, and **Developer** Editions |

## Apex Execution

When `log_record_type` is `ApexExecution`, the log record is associated with a user action that resulted in the execution of Apex code from an Apex class or trigger. Only the outermost Apex is captured.

| Standard Data                                      | Supplemental Data  |
| -------------------------------------------------- | ------------------ |
| <ul><li>`entry_point`</li><li>`quiddity`</li></ul> | `num_soql_queries` |

## Apex Unexpected Exception

When `log_record_type` is `ApexUnexpectedException`, the log record is associated with a user action that resulted in an Apex class or trigger throwing an unhandled exception. The `stack_trace` field provides detail about the Apex unexpected exceptions.

| Standard Data | Supplemental Data |
| ------------- | ----------------- |
| `stack_trace` | none              |

## Example

Let’s look at an example package usage log record and analyze the Apex interaction.

```nolang
{
     "timestamp_derived": "2022-11-22T06:19:33.990Z",
     "log_record_type": "ApexExecution",
     "request_id": "4mbhxFWBBXz83tlq2Z5aAk",
     "organization_id": "00Dxx0000006H2l",
     "organization_name": "MyCustomer Inc.",
     "organization_status": "Demo",
     "organization_edition": "Enterprise Edition",
     "organization_country_code": "IN",
     "organization_language_locale": "en_US",
     "organization_time_zone": "Australia/Sydney",
     "organization_instance": "GS0",
     "organization_type": "Production",
     "user_id_token": "005-9BwnBWYO5FMn4cZ1sLw7F3LmTpoe8M77GrZOZHL6xQk=",
     "user_type": "Standard",
     "package_id": "033xx0000004FqD",
     "package_version_id": "04txx0000004Idi",
     "managed_package_namespace": "Acme",
     "custom_entity": "InsuranceDetailsBatchable",
     "custom_entity_type": "ApexClass",
     "session_key": "2l4YtFB/RmsRKVsS",
     "login_key": "fGV6RgVOH3ZCgl2v",
     "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/IP_ADDRESS_REMOVED Safari/537.36",
     "user_country_code": "US",
     "user_time_zone": "America/Los_Angeles",
     "entry_point": "Acme.InsuranceDetailsBatchable",
     "num_soql_queries": "2",
     "quiddity": "A"
}
```

The `InsuranceAgentDetailsBatchable` packaged component of type `ApexClass` was interacted with as a result of a user action from subscriber org `MyCustomer Inc.` Specifically, an execution of a batch Apex job occurred on 2022-11-22 at 6:19 am. The batch Apex job is represented by Quiddity = A.

The key data in this analysis are:

| Question | Field                                                                                                                           | Value                                                                                                      |
| -------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| What     | <ul><li>`custom_entity`</li><li>`custom_entity_type`</li><li>`package_version_id`</li><li>`managed_package_namespace`</li></ul> | <ul><li>`InsuranceDetailsBatchable`</li><li>`ApexClass`</li><li>`04txx0000004Idi`</li><li>`Admc`</li></ul> |
| Who      | <ul><li>`organization_id`</li><li>`user_id_token`</li></ul>                                                                     | <ul><li>`00Dxx0000006H2l`</li><li>`005-9BwnBWYO5FMn4cZ1sLw7F3LmTpoe8M77GrZOZHL6xQk=`</li></ul>             |
| How      | <ul><li>`log_record_type`</li><li>`quiddity`</li></ul>                                                                          | <ul><li>`ApexExecution`</li><li>`A`</li></ul>                                                              |
| When     | `timestamp_derived`                                                                                                             | `2022-11-22T06:19:33.990Z`                                                                                 |

**See Also**

- [Package Usage Logs Schema](https://developer.salesforce.com/docs/platform/pkg2-dev/app-analytics-custom-object-logs.md)
- [Apex Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_dev_guide.htm)