# Power and Performance Metrics and Logs Get power and performance metrics, logs, and signatures. ## Discussion The `perfPowerMetricsresource` resource is a read-only resource where you get the power and performance metrics and diagnostics for App Store versions of your app. Use this information to improve your app’s performance. Customers can opt-in to share this information with you on their devices. A *metric* is a measurement of the power and performance impact of an app running on a device. The [`MetricCategory`](/documentation/AppStoreConnectAPI/MetricCategory) type lists the categories of measurements the system makes; for example, the `LAUNCH` metric measures how long it takes an app to present its first frame. Use the [`Get power and performance metrics for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-perfPowerMetrics) and [`Get power and performance metrics for a build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-perfPowerMetrics) endpoints to get the metrics reports for the most recent version of your app or for a specific build. An *insight* is an automatically generated analysis that shows a trend based on a set of metrics data. Insights compare the performance of the most recent app version with previous versions. Look for insights in the response body object, [`xcodeMetrics`](/documentation/AppStoreConnectAPI/xcodeMetrics). A *diagnostic signature* is a recurring pattern of function calls your app makes that are associated with a metric. To get a diagnostic log for a signature, first call the [`List all diagnostic signatures for a build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-diagnosticSignatures) endpoint to get the resource IDs for signatures you’re interested in. Then call [`Download logs for a diagnostic signature`](/documentation/AppStoreConnectAPI/GET-v1-diagnosticSignatures-_id_-logs) using the signature resource IDs to download the logs. To learn more about power and performance metrics, see [About Metrics organizer](https://help.apple.com/xcode/mac/current/#/devb642b28ac), and `Improving Your App's Performance`. ## Topics ### Getting Metrics and Diagnostic Logs [Retrieve Power and Performance Metrics and Log Insights](/documentation/AppStoreConnectAPI/retrieve-power-and-performance-metrics-and-log-insights) Use the App Store Connect API to collect and parse diagnostic logs and metrics for your apps. [`Get power and performance metrics for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-perfPowerMetrics) Get the performance and power metrics data for the most recent version of an app. [`Get power and performance metrics for a build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-perfPowerMetrics) Get the performance and power metrics data for a specific build. [`List all diagnostic signatures for a build`](/documentation/AppStoreConnectAPI/GET-v1-builds-_id_-diagnosticSignatures) List the aggregate backtrace signatures captured for a specific build. [`Download logs for a diagnostic signature`](/documentation/AppStoreConnectAPI/GET-v1-diagnosticSignatures-_id_-logs) Get the anonymized backtrace logs associated with a specific diagnostic signature. ### Objects and types [`xcodeMetrics`](/documentation/AppStoreConnectAPI/xcodeMetrics) A response that contains power and performance measurements for your app. [`DiagnosticInsight`](/documentation/AppStoreConnectAPI/DiagnosticInsight) An AI-generated analysis of a recurring performance issue identified in your app’s diagnostic logs, with suggested fixes. [`DiagnosticSignaturesResponse`](/documentation/AppStoreConnectAPI/DiagnosticSignaturesResponse) A response containing a list of unique performance issue signatures identified in your app’s diagnostic data. [`DiagnosticSignature`](/documentation/AppStoreConnectAPI/DiagnosticSignature) A unique pattern identifying a recurring crash, hang, or disk-write exception in your app’s diagnostic logs. [`diagnosticLogs`](/documentation/AppStoreConnectAPI/diagnosticLogs) A response containing log data for a diagnostic signature. [`DiagnosticLog`](/documentation/AppStoreConnectAPI/DiagnosticLog) A raw performance log file associated with a diagnostic signature, downloadable for detailed analysis. [`DiagnosticLogCallStackNode`](/documentation/AppStoreConnectAPI/DiagnosticLogCallStackNode) Diagnostic information that describes a single line in a call stack. [`MetricsInsight`](/documentation/AppStoreConnectAPI/MetricsInsight) Results of an analysis of metric data for a single metric category for your app. [`MetricCategory`](/documentation/AppStoreConnectAPI/MetricCategory) Categories of metric reports for apps that you distribute through the App Store. [`PerfPowerMetric`](/documentation/AppStoreConnectAPI/PerfPowerMetric) Unused. [`AppPerfPowerMetricsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppPerfPowerMetricsLinkagesResponse) [`DiagnosticSignatureLogsLinkagesResponse`](/documentation/AppStoreConnectAPI/DiagnosticSignatureLogsLinkagesResponse) ## See Also [Generating Tokens for API Requests](/documentation/AppStoreConnectAPI/generating-tokens-for-api-requests) Create JSON Web Tokens (JWTs) signed with your private key to authorize API requests. --- Copyright © 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)