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

# MXDiagnosticPayload

An object that encapsulates a diagnostic report.

```
class MXDiagnosticPayload
```

## Overview

The system delivers a diagnostic report as soon as it’s available.

## Topics

### Reading performance metrics

[`crashDiagnostics`](/documentation/MetricKit/MXDiagnosticPayload/crashDiagnostics)

The diagnostic reports for app crashes during the reporting period.

[`cpuExceptionDiagnostics`](/documentation/MetricKit/MXDiagnosticPayload/cpuExceptionDiagnostics)

The diagnostic reports for fatal and nonfatal CPU exceptions for the app during the reporting period.

### Reading responsiveness metrics

[`appLaunchDiagnostics`](/documentation/MetricKit/MXDiagnosticPayload/appLaunchDiagnostics)

The diagnostic reports for the app launch time.

[`hangDiagnostics`](/documentation/MetricKit/MXDiagnosticPayload/hangDiagnostics)

The diagnostic reports for times when the app was too busy to handle input responsively during the reporting period.

### Reading disk access metrics

[`diskWriteExceptionDiagnostics`](/documentation/MetricKit/MXDiagnosticPayload/diskWriteExceptionDiagnostics)

The diagnostic reports for disk write exceptions for the app during the reporting period.

### Generating a report

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

Returns the contents of the payload in JSON format.

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

Returns the results of the payload as a dictionary.

### Reading information about the payload

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

The starting time of the reporting period.

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

The ending time of the reporting period.


---

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)