중요
이 API는 모든 브라우저 버전(Browser Lite, Pro 또는 Pro+SPA)에서 작동합니다.
통사론
newrelic.setCustomAttribute(string $name, string OR number $value)
페이지의 후속 이벤트에 사용자 정의 속성 이름과 값을 추가합니다.
요구 사항
에이전트 버전 nr-593 이상.
설명
페이지의 후속 이벤트에 사용자 정의 속성 이름과 값을 추가합니다. 속성이 PageView
이벤트에 포함되도록 하려면 창 로드 이벤트가 발생하기 전에(해당 데이터가 전송될 때) 이 호출을 수행합니다. 속성이 설정되면 New Relic 플랫폼은 페이지가 다시 로드되거나 속성이 수동으로 설정 해제될 때까지 모든 PageAction
이벤트와 함께 이를 기록합니다.
호환되는 에이전트 버전과 함께 SPA 모니터링 을 사용하는 경우 이 호출로 설정된 속성은 newrelic.interaction
이벤트 에도 포함됩니다. 그러나 SPA API를 사용하여 설정한 속성은 이러한 속성보다 우선합니다.
사용자 정의 속성에 대한 오류는 JS 오류 페이지 의 이벤트에 포함됩니다. API를 통해 맞춤 속성에 대한 오류를 보거나 기록하려면 브라우저 API의 noticeError
호출을 사용하세요.
매개변수
매개변수 | 설명 |
---|---|
끈 | 필수의. 속성의 이름입니다. 속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오. |
문자열 OR 정수 | 필수의. 속성의 값입니다. 속성/값의 이름을 지정할 때 예약된 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);}