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 브라우저 설치 설명서를 참조하세요.

설명

에이전트 세션에 대한 사용자 정의 속성을 설정합니다. 속성이 설정되면 뉴렐릭 플랫폼은 페이지가 다시 로드되거나 속성이 수동으로 설정 해제될 때까지 지원되는 모든 이벤트와 함께 해당 속성을 기록합니다.

다음과 같은 브라우저 이벤트가 지원됩니다.

이벤트 이름	Notes
`AjaxRequest`
`BrowserInteraction`	SPA `setAttribute` 방법을 사용하여 설정된 속성은 `setCustomAttribute` 방법으로 설정된 속성보다 우선합니다.
`BrowserPerformance`
`JavaScriptError`	API 통해 맞춤 속성에 대한 오류를 보거나 기록하려면 브라우저 API `noticeError` 호출을 사용하세요.
`Log`	`options.customAttributes` 인수의 `log` 메서드에 제공된 맞춤 속성은 `setCustomAttribute` 에서 설정된 속성보다 우선합니다.
`PageAction`
`PageView`	`PageView` 이벤트에 속성이 포함되도록 하려면 창 로드 이벤트가 발생하기 전(데이터가 전송되는 시점)에 이 호출을 수행하십시오.
`PageViewTiming`
`UserAction`

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

중요

지속 속성은 동일한 이름의 info.jsAttributes 키보다 우선합니다! 예를 들어 somedomain.com/pageA 에 설정된 지속 속성 someName somedomain.com/pageB의 정보 블록에 정적으로 설정된 모든 someName 재정의하며 동일한(세션) 저장소를 공유한다고 가정합니다.

매개변수

매개변수	설명
`name` 끈	필수의. 속성의 이름입니다. `PageView` 이벤트의 열로 나타납니다. 사용 중인 경우 `PageAction` 이벤트의 열로도 나타납니다. 속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오.
`value` 문자열 OR 정수 OR 부울 OR 널	필수의. 속성의 값입니다. `PageView` 이벤트의 명명된 속성 열에 값으로 표시됩니다. 사용하는 경우 `PageAction` 이벤트의 열로 표시됩니다. 사용자 정의 속성 값은 복잡한 객체일 수 없으며 문자열, 정수, 부울과 같은 단순 유형만 가능합니다. `null` 값을 전달하면 동일한 이름의 기존 속성이 설정 해제됩니다. 속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오.
`persist` 부울	선택 과목. `true`로 설정하면 이름-값 쌍도 브라우저의 저장소 API로 설정됩니다. 그런 다음 동일한 세션 내에서 로드되는 다음 계측 페이지에서 쌍이 사용자 정의 속성으로 다시 적용됩니다. 기본값은 `false` 입니다.

설명

name

끈

필수의. 속성의 이름입니다. PageView 이벤트의 열로 나타납니다. 사용 중인 경우 PageAction 이벤트의 열로도 나타납니다.

속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오.

value

문자열 OR 정수 OR 부울 OR 널

필수의. 속성의 값입니다. PageView 이벤트의 명명된 속성 열에 값으로 표시됩니다. 사용하는 경우 PageAction 이벤트의 열로 표시됩니다. 사용자 정의 속성 값은 복잡한 객체일 수 없으며 문자열, 정수, 부울과 같은 단순 유형만 가능합니다.

null 값을 전달하면 동일한 이름의 기존 속성이 설정 해제됩니다.

속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오.

persist

부울

선택 과목. true로 설정하면 이름-값 쌍도 브라우저의 저장소 API로 설정됩니다. 그런 다음 동일한 세션 내에서 로드되는 다음 계측 페이지에서 쌍이 사용자 정의 속성으로 다시 적용됩니다.

기본값은 false 입니다.

예

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

사용자의 편의를 위해 제공되는 기계 번역입니다.

통사론.css-21sua1{background:none;border:none;width:0;padding:0;}

요구 사항

설명

중요

매개변수

예

HTML 요소용 JavaScript/jQuery 가져오기

통사론