iOS agent release notesRSS

Fixes

• Removed URL parameters from MobileRequestError and MobileRequest events. The concern being there may be confidential information contained in these parameters.

New in this release

Now reports network request events to Insights! This feature must be enabled when starting the agent using [NewRelic enableFeatures:NRFeatureFlag_NetworkRequestEvents]. When enabled all network calls will be tracked, in addition to network errors. These new events will be available under the MobileNetworkRequest eventType. Examples of how to query these new events is available in our documentation: Mobile request query examples (MobileRequest).

New in this release

Now reports network request events to Insights! This feature must be enabled when starting the agent using [NewRelic enableFeatures:NRFeatureFlag_NetworkRequestEvents]. When enabled all network calls will be tracked, in addition to network errors. These new events will be available under the MobileNetworkRequest eventType.

Features

• Added a new MobileBreadcrumb custom event type that allows you to annotate the execution of your app, to help troubleshoot crashes and provide greater detail in Insights. Record this new event type with the method +recordBreadcrumb:withAttributes:.
• Added an additional +recordCustomEvent:name:withAttributes method that takes the event name as an optional parameter. This avoids the need to add a name attribute in the passed attribute set.

Features

• Added a new MobileBeadcrumb event type that allows you to annotate the execution of your app, to help troubleshoot crashes and provide greater detail in Insights. Use this new event type using the conveneince method +recordBreadcrumb:withAttributes:
• Added an additional +recordCustomEvent:name:withAttributes method that takes the event name as an optional parameter. This avoids the need to add a name attribute in the passed attribute set.

Fixes

• Fixed rare app launch crash caused by collision of JSON serialization & New Relic's method instrumentation.
• Added better messaging for custom eventType validation errors.
• Improved crash report data quality.

Fixes

• The New Relic post-build script will now capture and upload dSYM files created in subfolders of the build folder.

Improvements

• Adds new API +[NewRelic recordCustomEvent:(NSString*)eventType withAttributes:(NSDictionary*)attributes]

This method replaces +[NewRelic recordEvent:(NSString*)name withAttributes:(NSDictionary*)attributes] which is now deprecated, with the intention of removal in the future. The new API creates a new event with an event type specified by the eventType parameter, whereas the deprecated method create a event with the Mobile event type and an attribute with the name 'name' and the value of the name parameter. This change satisfies customer requests for:

• Improved Insights query performance

• Defining custom event types

• Finding custom event in Insights more easily

• Flexibility to define data retention per custom event type

• Adds helper method +setUserId: to NewRelic.h which sets a session attribute, userId, with the passed value. This method is effectively the same as [NewRelic setAttribute:@"userId" value:<username>];

• This release adds a new Insights event type: MobileRequestError. This new event tracks networking and http errors during the app's lifecycle, adding the ability to slice and dice network error data! More details can be found at Mobile Request Error Events.

• This agent now applies the lastInteraction attribute to all events, not just crash events.

• The applications build value is now added as a default session attribute: appBuild.

Improvements

• Adds new API +[NewRelic recordCustomEvent:(NSString*)eventType withAttributes:(NSDictionary*)attributes]

This method replaces +[NewRelic recordEvent:(NSString*)name withAttributes:(NSDictionary*)attributes] which is now deprecated, with the intention of removal in the future. The new API creates a new event with an event type specified by the eventType parameter, whereas the deprecated method create a event with the Mobile event type and an attribute with the name 'name' and the value of the name parameter. This change satisfies customer requests for:

• Improved Insights query performance
• Defining custom event types
• Finding custom event in Insights more easily
• Flexibility to define data retention per custom event type