metrickit-diagnostics

Collect and analyze MetricKit payloads for iOS crash, hang, and performance diagnostics.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/co-labs-co/context-harness-skills --skill metrickit-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: metrickit-diagnostics
Source: https://github.com/co-labs-co/context-harness-skills/tree/main/skill/metrickit-diagnostics
Command: npx skills add https://github.com/co-labs-co/context-harness-skills --skill metrickit-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Native crash reporting, hang diagnostics, and performance metrics collection using Apple's MetricKit framework. This skill enables implementing MXMetricManagerSubscriber, custom signposts, OSLog integration, and payload processing with local storage for later upload.

Core Features & Use Cases

  • Native crash reporting and hang diagnostics via MXDiagnosticPayload and MXMetricPayload
  • Custom signpost categories for measuring video encoding, P2P streaming, and camera operations
  • OSLog integration for structured, privacy-aware logging
  • Local payload storage to support offline diagnostics and later analysis

Quick Start

Start DiagnosticsManager to begin receiving MetricKit payloads and store them locally.

Frequently Asked Questions about metrickit-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I collect MetricKit data for iOS crash and hang diagnostics?

MetricKit diagnostics are collected by implementing MXMetricManagerSubscriber to receive MXMetricPayload and MXDiagnosticPayload, process the diagnostic data, and persist results locally for later analysis.

What iOS version is required for MXDiagnosticPayload crash reporting?

MXDiagnosticPayload crash reporting requires iOS 14 or later, while MXMetricPayload for performance metrics is supported starting from iOS 13. Both are necessary for full MetricKit diagnostics.

How do I use custom signposts for iOS performance telemetry?

Custom signposts integrate with OSLog to provide structured, privacy-aware telemetry for specific operations like video encoding or camera operations, enabling precise performance measurement within iOS apps.

Can I store MetricKit payloads locally for offline diagnostics?

Yes, MetricKit payloads can be persisted in local storage to support offline diagnostics, allowing crash and hang data to be saved on the device for later upload and analysis.

What is the best way to measure video encoding performance in iOS?

The best way to measure video encoding performance is using custom signpost categories integrated with OSLog, which capture telemetry during specific operations and report them through MetricKit payloads.