<!--
{
  "documentType" : "article",
  "framework" : "Analytics Reports",
  "identifier" : "/documentation/Analytics-Reports/app-runtime-usage",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "App Runtime Usage"
}
-->

# App Runtime Usage

Analyze how often your app executes specific symbols of different dynamic libraries.

## Overview

The data in this report contains aggregated information about the symbols and dynamic library version (dylib) that your app executes.

- Territories: Worldwide
- Platforms: iOS, iPadOS.  For more information about iOS and iPadOS, see the Platforms section in [Data Completeness and Corrections](/documentation/Analytics-Reports/data-completeness-corrections).
- Availability:
  - Daily: Every day.
- History: On request, data is available beginning with iOS 17.4 and iPadOS 17.4.
- Completeness: Data from devices that contribute to this report can arrive as late as 8 days after the date it generates on device. You can download recent data daily, but it might be incomplete, and data updates incrementally daily, until all late-arriving events are available.
- Privacy:
  - Includes data from users who have opted to share their data with Apple and developers.
  - Individual rows will only appear if they have a value of 5 or more.
- Data Context: You can analyze your data with additional context by comparing it with the data in the [App Sessions Context](/documentation/Analytics-Reports/app-sessions-context) report, which provides a count of unique devices that use your app on a specific day. For example, if your app performed an action detailed in this report on 10 unique devices on a specific day, and the App Sessions Context report shows there were 100 unique devices running your app that day, then you can approximate that 10% of the devices running your app performed that action.

## Report Fields

|Report Field                       |Description                                                                                               |Data Type|
|-----------------------------------|----------------------------------------------------------------------------------------------------------|---------|
|Count                              |Number of times the event occurred                                                                        |`integer`|
|Territory                          |Country or region in which the event occurred                                                             |`string` |
|Date                               |Date when the event occurred                                                                              |`string` |
|Platform                           |OS version on the device on which the event occurred                                                      |`string` |
|Device                             |Type of device on which the event occurred                                                                |`string` |
|Build                              |Build of device on which event occurred                                                                   |`string` |
|Unique Devices                     |The count of unique devices                                                                               |`integer`|
|Release Type                       |Type of software release                                                                                  |`string` |
|App Version                        |Version of the app associated with the event                                                              |`string` |
|App Name                           |Name of the sampled app                                                                                   |`string` |
|Architecture                       |Architecture of the symbol                                                                                |`string` |
|Binary Code Directory Hash         |Code directory hash of the binary                                                                         |`string` |
|Binary Path                        |Path to the currently executing binary                                                                    |`string` |
|Binary Team ID                     |Team ID of the binary signature                                                                           |`string` |
|Binary UUID                        |Universally unique identifier of the binary                                                               |`string` |
|Dynamic Library Code Directory Hash|Code directory hash of the dynamic library                                                                |`string` |
|Dynamic Library Path               |Path to the dynamic library that contains this symbol                                                     |`string` |
|Dynamic Library Team ID            |Team ID of the dynamic library signature                                                                  |`string` |
|Dynamic Library UUID               |Universally unique identifier  of the dynamic library from which this symbol comes                        |`string` |
|Symbol Name                        |Name of the symbol (if known)                                                                             |`string` |
|Symbol Offset                      |Offset for the symbol in the binary                                                                       |`string` |
|Symbol Count                       |Number of times symbol appears in this sample                                                             |`long`   |
|Dynamic Library Version            |Version (either bundle version or mach object file format version) of the dynamic library using the symbol|`string` |
|Binary Version                     |Version (either bundle version or mach object file format version) of the binary calling the symbol       |`string` |
|Caller Path                        |Path to dynamic library that calls this symbol                                                            |`string` |
|Caller Symbol Name                 |Name of the symbol that calls this symbol                                                                 |`string` |

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)