<!--
{
  "availability" : [
    "iOS: 13.0.0 - 27.0.0",
    "iPadOS: 13.0.0 - 27.0.0",
    "macCatalyst: 13.1.0 - 27.0.0",
    "macOS: 10.15.0 - 27.0.0",
    "visionOS: 1.0.0 - 27.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "MetricKit",
  "identifier" : "/documentation/MetricKit/MXMetricPayload",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "MetricKit"
    ],
    "preciseIdentifier" : "c:objc(cs)MXMetricPayload"
  },
  "title" : "MXMetricPayload"
}
-->

# MXMetricPayload

An object that encapsulates a daily metrics report.

```
class MXMetricPayload
```

## Topics

### Reading battery metrics

[`cellularConditionMetrics`](/documentation/MetricKit/MXMetricPayload/cellularConditionMetrics)

The cellular condition measurements for the reporting period.

[`cpuMetrics`](/documentation/MetricKit/MXMetricPayload/cpuMetrics)

The CPU metrics for the reporting period.

[`displayMetrics`](/documentation/MetricKit/MXMetricPayload/displayMetrics)

The display metrics for the reporting period.

[`gpuMetrics`](/documentation/MetricKit/MXMetricPayload/gpuMetrics)

The GPU metrics for the reporting period.

[`locationActivityMetrics`](/documentation/MetricKit/MXMetricPayload/locationActivityMetrics)

The location-tracking activity for the reporting period.

[`networkTransferMetrics`](/documentation/MetricKit/MXMetricPayload/networkTransferMetrics)

The network-transfer activity for the reporting period.

### Reading performance metrics

[`applicationExitMetrics`](/documentation/MetricKit/MXMetricPayload/applicationExitMetrics)

The app foreground and background exit metrics for the reporting period.

[`applicationTimeMetrics`](/documentation/MetricKit/MXMetricPayload/applicationTimeMetrics)

The app foreground and background time metrics for the reporting period.

[`memoryMetrics`](/documentation/MetricKit/MXMetricPayload/memoryMetrics)

The memory metrics for the reporting period.

### Reading responsiveness metrics

[`applicationLaunchMetrics`](/documentation/MetricKit/MXMetricPayload/applicationLaunchMetrics)

The app launch and resume metrics for the reporting period.

[`animationMetrics`](/documentation/MetricKit/MXMetricPayload/animationMetrics)

The metrics for the responsiveness of app animations for the reporting period.

[`applicationResponsivenessMetrics`](/documentation/MetricKit/MXMetricPayload/applicationResponsivenessMetrics)

The metrics indicating an app’s responsiveness to user interaction for the reporting period.

### Reading disk access metrics

[`diskIOMetrics`](/documentation/MetricKit/MXMetricPayload/diskIOMetrics)

The storage metrics for the reporting period.

### Reading custom metrics

[`signpostMetrics`](/documentation/MetricKit/MXMetricPayload/signpostMetrics)

An array of the custom metrics for the reporting period.

### Generating a report

[`jsonRepresentation()`](/documentation/MetricKit/MXMetricPayload/jsonRepresentation())

Returns the contents of the payload in JSON format.

[`dictionaryRepresentation()`](/documentation/MetricKit/MXMetricPayload/dictionaryRepresentation())

Returns the results of the payload as a dictionary.

### Reading information about the payload

[`timeStampBegin`](/documentation/MetricKit/MXMetricPayload/timeStampBegin)

The starting time of the reporting period.

[`timeStampEnd`](/documentation/MetricKit/MXMetricPayload/timeStampEnd)

The ending time of the reporting period.

[`includesMultipleApplicationVersions`](/documentation/MetricKit/MXMetricPayload/includesMultipleApplicationVersions)

A Boolean indicating if the version of the app changed at least once during the reporting period.

[`latestApplicationVersion`](/documentation/MetricKit/MXMetricPayload/latestApplicationVersion)

The version of the app on the device at the end of the reporting period.

[`metaData`](/documentation/MetricKit/MXMetricPayload/metaData)

A set of system-level information for the device.


---

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)