Automatically collects process-level system metrics (memory, CPU, file descriptors) and reports them through the SwiftMetrics API.

The following metrics are collected and reported as gauges:

• Virtual Memory (process_virtual_memory_bytes) - Virtual memory size in bytes
• Resident Memory (process_resident_memory_bytes) - Resident Set Size (RSS) in bytes
• CPU Time (process_cpu_seconds_total) - Total user and system CPU time spent in seconds
• Process Start Time (process_start_time_seconds) - Process start time since Unix epoch in seconds
• Open File Descriptors (process_open_fds) - Current number of open file descriptors
• Max File Descriptors (process_max_fds) - Maximum number of open file descriptors allowed

import Logging
import SystemMetrics

// Create a logger, or use one of the existing loggers
let logger = Logger(label: "MyLogger")

// Create the monitor
let monitor = SystemMetricsMonitor(logger: logger)

// Create the service
let serviceGroup = ServiceGroup(
    services: [monitor],
    gracefulShutdownSignals: [.sigint],
    cancellationSignals: [.sigterm],
    logger: logger
)

// Start collecting metrics
try await serviceGroup.run()

See the SystemMetrics documentation for details.

Add SwiftMetricsExtras as a dependency in your Package.swift:

dependencies: [
    .package(url: "https://github.com/apple/swift-metrics-extras.git", from: "1.0.0")
]

Then add SystemMetrics to your target:

.target(
    name: "YourTarget",
    dependencies: [
        .product(name: "SystemMetrics", package: "swift-metrics-extras")
    ]
)

A complete working example with a pre-built Grafana dashboard is available in Examples/ServiceIntegration. The example includes:

• SwiftServiceLifecycle integration.
• SwiftMetrics configured to export the metrics.
• Docker Compose setup with Grafana container.
• A provisioned Grafana dashboard visualizing all the collected metrics.