NetworkMonitor

NetworkMonitor intercepts HTTP and HTTPS traffic made through Foundation's URL loading system and writes concise events to unified logging.

Requirements

• Swift 5.8+
• iOS 13.0+, iPadOS 13.0+, macOS 11.0+, tvOS 13.0+, visionOS 1.0+, watchOS 7.0+

Installation (Package.swift)

dependencies: [
    .package(url: "https://github.com/0xWDG/NetworkMonitor.git", branch: "main"),
],
targets: [
    .target(name: "MyTarget", dependencies: [
        .product(name: "NetworkMonitor", package: "NetworkMonitor"),
    ]),
]

Installation (Xcode)

1. In Xcode, open your project and navigate to File → Swift Packages → Add Package Dependency...
2. Paste the repository URL (https://github.com/0xWDG/NetworkMonitor) and click Next.
3. Click Finish.

Usage

Enable traffic logging once during app startup, before you create URL sessions. By default, entries are sent to the nl.wesleydegroot.NetworkMonitor OSLog subsystem.

import NetworkMonitor

NetworkMonitor.interceptNetworkTraffic()

To use your own log, pass an OSLog instance:

import OSLog
import NetworkMonitor

let networkLog = OSLog(subsystem: "com.example.MyApp", category: "Network")
NetworkMonitor.interceptNetworkTraffic(log: networkLog)

By default, the monitor logs each request's method and URL, then its status code and duration (or a failure). Select exactly the additional fields you need:

NetworkMonitor.interceptNetworkTraffic(
    log: networkLog,
    options: [.host, .path, .headers, .cookies]
)

Available options are .request, .response, .host, .path, .httpBody, .headers, .cookies, and .all. HTTP bodies are logged as UTF-8 text when possible, otherwise Base64. Headers, cookies, complete URLs, and HTTP bodies can contain credentials or personal data; only enable them in a suitable debugging environment. URLProtocol interception applies to HTTP(S) requests that use Foundation's URL loading system; it does not observe traffic from networking stacks that bypass it.

Legacy network-path observer

NetworkMonitorObserver is retained for observing network reachability and interface state. It is separate from traffic interception.

import SwiftUI
import NetworkMonitor

struct ContentView: View {
    @StateObject
    private var network = NetworkMonitorObserver()

    var body: some View {
        VStack {
            Text("Hello!")
            Text("The network status is \(network.isConnected ? "Connected" : "Disconnected")")
            Text("You are using a \"\(network.isExpensive ? "Expensive" : "Normal")\" internet connection")

            HStack(spacing: 0) {
                Text("You are using \"")
                switch (network.networkType) {
                case .cellular:
                    Text("Cellular")
                case .wifi:
                    Text("Wi-Fi")
                case .loopback:
                    Text("Loopback")
                case .other:
                    Text("Other")
                case .wiredEthernet:
                    Text("Wired")
                default:
                    Text("Unknown")
                }
                Text("\" to connect to the internet")
            }
        }
    }
}

Contact

🦋 @0xWDG 🐘 mastodon.social/@0xWDG 🐦 @0xWDG 🧵 @0xWDG 🌐 wesleydegroot.nl 🤖 Discord

Interested learning more about Swift? Check out my blog.