Create a custom attribute

Syntax

Objective-c

setAttribute:(NSString*)name value:(id) value;

Swift [#swift]

NewRelic.setAttribute(string $name, string or float $value)

Description [#description]

This static method creates a session-level custom attribute with a specified name and value. When called, it overwrites its previous value and type. The created attribute is shared by multiple Mobile monitoring event types.

You can override any of the MobileSession default attributes except:

• appId
• appName
• accountId
• carrier
• category
• deviceManufacturer
• deviceModel
• eventType
• install
• lastInteraction
• memUsageMb
• newRelicVersion
• osMajorVersion
• osName
• osVersion
• platform
• platformVersion
• sessionDuration
• sessionId
• timestamp
• type
• upgradeFrom
• uuid
• Anything prefixed with NewRelic

Parameters [#parameters]

Return values [#return-values]

Returns true if recorded successfully, and false if it doesn't.

Examples [#examples]

Objective-C [#obj-c]

BOOL attributeSet = [NewRelic setAttribute:@"buildConfiguration" value:@"AppStore-release"];
BOOL attributeSet = [NewRelic setAttribute:@"rate" value:@9999.99];

Swift [#swift]

var attributeSet = NewRelic.setAttribute("buildConfiguration", value: "AppStore-release")
attributeSet = NewRelic.setAttribute("rate", value: 9999.99)

Syntax

setAttribute(options: { name: string; value: string; }) => void

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

NewRelicCapacitorPlugin.setAttribute({ name: "CapacitorAttribute", value: "123" });

Syntax

setAttribute(attributeName: string, value: boolean | number | string): void;

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

NewRelic.setAttribute(Name: "CordovaAttribute", value: "123"): void;

Syntax

SetAttribute(string name, string value) : bool;

SetAttribute(string name, double value) : bool;

SetAttribute(string name, bool value) : bool;

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

CrossNewRelic.Current.SetAttribute("MAUIBoolAttr", false);
    CrossNewRelic.Current.SetAttribute("MAUIStrAttr", "Cat");
    CrossNewRelic.Current.SetAttribute("MAUINumAttr", 13.5);

Syntax

setAttribute (String name, dynamic value) : void;

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

NewrelicMobile.instance.setAttribute('RNCustomAttrNumber', 37);

Syntax

setAttribute(name: string, value: boolean | number | string): void;

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

NewRelic.setAttribute('RNCustomAttrNumber', 37);

Syntax

setAttribute(string name, string value) : bool;

setAttribute(string name, double value) : bool;

setAttribute(string name, bool value) : bool;

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

NewRelicAgent.SetAttribute("UnityBoolCustomAttr", false);
    NewRelicAgent.SetAttribute("UnityStringCustomAttr", "Cat");
    NewRelicAgent.SetAttribute('UnityCustomAttrNumber', 37);

Syntax

setStringAttribute(FString name,FString value) : void;

setDoubleAttribute(FString name,double value):void;

setBooleanAttribute(FString name ,bool value):void;

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

#include "NewRelicBPLibrary.h"

   UNewRelicBPLibrary::setBooleanAttribute("From Unreal",true);

   UNewRelicBPLibrary::setDoubleAttribute("Unreal Double", 15.0);

   UNewRelicBPLibrary::setStringAttribute("Unreal String","From UnReal");

Syntax

SetAttribute(string name, string value) : bool;

SetAttribute(string name, double value) : bool;

SetAttribute(string name, bool value) : bool;

Description [#description]

Creates a session-level attribute shared by multiple mobile event types. Overwrites its previous value and type each time it is called.

Parameters [#parameters]

Example [#example]

CrossNewRelicClient.Current.SetAttribute("XamarinBoolAttr", false);
    CrossNewRelicClient.Current.SetAttribute("XamarinStrAttr", "Cat");
    CrossNewRelicClient.Current.SetAttribute("XamarinNumAttr", 13.5);