Use CFNetwork diagnostic logging to investigate HTTP and HTTPS problems.
If you’re using
NSURLSession and need to debug a complex networking issue, you can enable CFNetwork diagnostic logging to get detailed information about the progress of your network requests. CFNetwork diagnostic logging has unique advantages relative to other network debugging tools, including:
The ability to look at network traffic that’s protected by Transport Layer Security (TLS)
Information about CFNetwork’s internal state, like which cookies get saved and applied
For information about other network debugging tools, see Choosing a Network Debugging Tool.
Understand the Security Implications
CFNetwork diagnostic logs may contain decrypted TLS data and other security-sensitive information. Take these precautions:
Restrict access to any logs you capture.
If you build an app that enables this logging programmatically, make sure that anyone who receives that app understands the security implications of using it.
If you send a log to Apple, redact any security-sensitive information.
Enable Logging In Xcode
To enable CFNetwork diagnostic logging, edit the current scheme (choose Product > Scheme > Edit Scheme), navigate to the Arguments tab, and add a
CFNETWORK item to the Environment Variables list. The value of this item can range from 0 to 3, where 0 turns logging off, and higher numbers give you progressively more logging. When you next run your app and use
NSURLSession, CFNetwork diagnostic log entries appear in Xcode’s debug console area. If the console area isn’t visible, choose View > Debug Area > Show Debug Area to show it).
Enable Logging Programmatically to See Problems Outside of Xcode
To investigate problems outside of Xcode, programmatically enable CFNetwork diagnostic logging by setting the environment variable directly.
Do this right at the beginning of the app’s launch sequence:
If you’re programming in Objective-C, put the code at the start of your
If your program has a C++ component, make sure this code runs before any C++ static initializers that use CFNetwork or any APIs, like
NSURLSession, that use CFNetwork.
If you’re programming in Swift, put this code in
View Log Entries
How you view the resulting log entries depends on your specific situation:
In macOS, if you can reproduce the problem locally, run the Console utility on your Mac and view log entries there.
In iOS, if you can reproduce the problem locally, and you’re able to connect the device to your Mac through USB, run the Console utility on your Mac and view log entries there. Make sure you select your iOS device from the source list on the left of the main Console window (choose View > Show Sources if the source list is not visible).
If neither of the above work for you — for example, if you’re trying to debug a problem that can only be reproduced by one of your users in the field — get a sysdiagnose log from the machine exhibiting the problem and then extract the log entries from that. See the Bug Reporting > Profiles and Logs page on the developer web site for details on how to get a sysdiagnose log.