EN
RU
ES
ZH
FR
DE
PT
AR
HI
What is MetricsKit?
MetricsKit is a lightweight library for collecting performance metrics and monitoring applications written in Swift for iOS and macOS platforms. It provides developers with a simple API for tracking function execution time, call frequency, memory usage, and sending custom events. The library is designed with privacy requirements in mind: all data can be stored locally or sent to your own server.
Why monitor Swift applications?
Developing for iOS/macOS requires constant performance control. MetricsKit helps:
- Identify bottlenecks in code (slow functions, memory leaks).
- Track user behavior (screens, gestures).
- Collect crash reports and error logs.
- Optimize application startup time.
- Integrate with CI/CD for automated performance tests.
Installation
MetricsKit is distributed via Swift Package Manager. Add to Package.swift:
dependencies: [ .package(url: "https://github.com/your-org/MetricsKit.git", from: "1.0.0")],targets: [ .target(name: "YourApp", dependencies: ["MetricsKit"])]Or via Xcode: File → Add Packages → paste the repository URL.
Main Features
- Performance Timers — measure execution time of code blocks.
- Event Counters — count taps, errors, transitions.
- Memory Monitoring — track object allocation and deallocation.
- Custom Metrics — send any numerical values.
- Logging with Levels (debug, info, warning, error).
- Export to JSON/CSV for analysis.
Swift Code Example
import MetricsKit
class ViewController: UIViewController { override func viewDidLoad() { super.viewDidLoad() MetricsKit.shared.startSession(name: "MainScreen") // Measure function execution time MetricsKit.shared.measure(name: "loadData") { // Your data loading code Thread.sleep(forTimeInterval: 0.5) } // Send an event MetricsKit.shared.trackEvent("button_tap", properties: ["button_id": "login"]) // Memory monitoring let memUsage = MetricsKit.shared.reportMemoryUsage() print("Memory used: \\(memUsage) MB") // End session MetricsKit.shared.endSession() }}When to Use
The library is ideal for:
- High-load applications (games, streaming).
- Enterprise applications where SLAs are important.
- Prototypes requiring quick problem diagnosis.
- Educational projects for learning about metrics.
MetricsKit does not depend on external services (no mandatory data upload to the cloud), making it suitable for applications with heightened security requirements.
Conclusion
MetricsKit is an open and extensible solution for monitoring Swift applications. You can easily adapt it to your needs by adding new metrics or integrations. Start using it today to make your application faster and more stable.
