setCustomAttribute

통사론

newrelic.setCustomAttribute(name: string, value: string|number|boolean|null[, persist: boolean])

페이지의 후속 이벤트에 사용자 정의 사용자 정의 속성 이름 및 값을 추가합니다.

요구 사항

• 브라우저 Lite, Pro 또는 Pro+SPA 에이전트(v593 이상)

  • persist 매개변수 또는 null 값 지원을 위해서는 에이전트 버전 1.230.0 이상이 필요합니다.
  • boolean 값 지원을 위해서는 에이전트 버전 1.245.0 이상이 필요합니다.

• npm을 사용하여 브라우저 에이전트를 설치하는 경우 BrowserAgent 클래스를 인스턴스화할 때 하나 이상의 기능을 활성화해야 합니다. 예를 들어, features 배열에 다음을 추가합니다.

  import { Metrics } from '@newrelic/browser-agent/features/metrics'
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      Metrics
    ]
  }

  카피

자세한 내용은 NPM 브라우저 설치 설명서를 참조하세요.

설명

속성이 PageView 이벤트에 포함되도록 하려면 창 로드 이벤트가 실행되기 전에(해당 데이터가 전송될 때) 이 호출을 수행하십시오. 속성이 설정되면 New Relic 플랫폼은 페이지가 다시 로드되거나 속성이 수동으로 설정 해제될 때까지 모든 이벤트와 함께 이를 기록합니다.

호환되는 에이전트 버전과 함께 SPA 모니터링을 사용하는 경우 이 호출로 설정된 속성도 newrelic.interaction 이벤트에 포함됩니다. 그러나 SPA API를 사용하여 설정된 속성이 이러한 속성보다 우선합니다.

사용자 정의 속성에 대한 오류는 JS 오류 페이지 의 이벤트에 포함됩니다. API를 통해 맞춤 속성에 대한 오류를 보거나 기록하려면 브라우저 API의 noticeError 호출을 사용하세요.

persist 플래그를 사용하면 속성을 브라우저에 저장할 수도 있으므로 동일한 원본 within a session 범위의 후속 페이지 방문 시 이벤트에서 속성이 유지됩니다. 이 기능은 최종 사용자 브라우저 개인 정보 보호 설정에 따라 달라질 수 있습니다. 이 함수가 value = null 와 함께 호출되면 persist 플래그에 관계없이 현재 페이지의 이벤트 및 저장소에서 속성이 both 에서 삭제됩니다.

매개변수

예

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);
}