중요
이 API는 모든 브라우저 버전(Browser Lite, Pro 또는 Pro+SPA)에서 작동합니다.
통사론
newrelic.setCustomAttribute(name: string, value: string|number|null[, persist: boolean])
페이지의 후속 이벤트에 사용자 정의 속성 이름과 값을 추가합니다.
요구 사항
에이전트 버전 nr-593 이상.
persist
매개변수 또는 null
값 지원을 위해서는 에이전트 버전 1.230.0 이상이 필요합니다.
설명
속성이 PageView
이벤트에 포함되도록 하려면 창 로드 이벤트가 실행되기 전에(해당 데이터가 전송될 때) 이 호출을 수행하십시오. 속성이 설정되면 New Relic 플랫폼은 페이지가 다시 로드되거나 속성이 수동으로 설정 해제될 때까지 모든 이벤트와 함께 이를 기록합니다.
호환되는 에이전트 버전과 함께 SPA 모니터링을 사용하는 경우 이 호출로 설정된 속성도 newrelic.interaction
이벤트에 포함됩니다. 그러나 SPA API를 사용하여 설정된 속성이 이러한 속성보다 우선합니다.
사용자 정의 속성에 대한 오류는 JS 오류 페이지 의 이벤트에 포함됩니다. API를 통해 맞춤 속성에 대한 오류를 보거나 기록하려면 브라우저 API의 noticeError
호출을 사용하세요.
persist
플래그를 사용하면 속성이 브라우저에 저장되어 세션 범위 내에서 동일한 출처의 후속 페이지 방문이 이벤트에 유지되도록 할 수 있습니다. 이 기능은 최종 사용자 브라우저 개인 정보 설정에 따라 변동될 수 있습니다. 이 함수가 value = null
로 호출되면 속성은 persist
플래그와 관계없이 현재 페이지의 이벤트와 스토리지 모두 에서 삭제됩니다.
중요
지속 속성은 동일한 이름의 info.jsAttributes
키보다 우선합니다! 예를 들어 somedomain.com/pageA
에 설정된 지속 속성 someName
somedomain.com/pageB
의 정보 블록에 정적으로 설정된 모든 someName
재정의하며 동일한(세션) 저장소를 공유한다고 가정합니다.
매개변수
매개변수 | 설명 |
---|---|
끈 | 필수의. 속성의 이름입니다. 속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오. |
문자열 OR 정수 OR null | 필수의. 속성의 값입니다.
속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오. |
부울 | 선택 과목. 기본값은 |
예
HTML 요소용 JavaScript/jQuery 가져오기
이 예제는 JavaScript/jQuery를 사용하여 Drupal 생성 페이지에서 다음 HTML 요소의 값을 가져옵니다.
<link rel="shortlink" href="/node/1111" />
<h1>Using NRQL</h1>
New Relic은 이를 사용자 정의 속성으로 보고합니다. 이는 PageView
및 PageAction
이벤트를 쿼리하는 데 유용합니다.
var node_id = jQuery("link[rel='shortlink']").attr("href");var node_title = jQuery('h1').text();
if (typeof newrelic == 'object') { newrelic.setCustomAttribute('nodeId', node_id); newrelic.setCustomAttribute('title', node_title);}