noticeNetworkFailure (iOS SDK API)

Syntax

+ (void)noticeNetworkFailureForURL:(NSURL*)url
httpMethod:(NSString*)httpMethod
withTimer:(NRTimer*)timer
andFailureCode:(NSInteger)iOSFailureCode;

Manually record a failed transactional network request.

Requirements

Compatible with all agent versions.

Description

Failed requests are requests that fail to receive a complete response from the server caused by things like TCP timeouts, SSL failures, connection closures, and more.

The failure codes you pass into this method should correlate to Apple's documented NSURLConnection failure codes.

Parameters

Parameter

Description

$url

NSURL

Required. The URL of the request.

$httpMethod

string

Required. The HTTP method of the request.

$timer

NRTimer

Required. A timer that captures the start and end of the request.

$iOSFailureCode

NSInteger

Required. The failure codes you pass into this method should correlate to Apple's documented NSURLConnection failure codes.

Examples

Objective-C

Example:

[NewRelic noticeNetworkFailureForURL:[NSURL URLWithString:@"https://www.newrelic.com"]
httpMethod:@"GET"
withTimer:[[NRTimer alloc] init]
andFailureCode:NSURLErrorTimedOut];

Swift

Example:

NewRelic.noticeNetworkFailure(for: URL(string: "https://www.newrelic.com"), httpMethod: "GET",
with: NRTimer(), andFailureCode: NSURLErrorTimedOut)