통사론
newrelic_add_custom_span_parameter(string $key, scalar $value)현재 범위에 사용자 지정 속성(키/값 쌍)을 연결합니다.
요구 사항
에이전트 버전 9.12.0.268 이상.
설명
현재 범위에 사용자 지정 속성 (키 및 값 데이터 쌍)을 추가합니다. ("사용자 정의 속성"이 이전에 "사용자 정의 매개변수"라고 했기 때문에 호출 이름은 newrelic_add_custom_span_parameter 입니다.) 예를 들어 고객 데이터베이스에서 고객의 전체 이름을 추가할 수 있습니다. 이 속성은 모든 범위에 나타납니다. 사용자 정의 속성에 대해 Span 을 쿼리할 수도 있습니다.
중요
스팬에서 newrelic_add_custom_span_parameter 으로 추가된 속성은 newrelic_add_custom_parameter 로 추가된 속성보다 우선합니다.
중요
사용자 정의 속성을 사용하려면 NRQL에서 사용하는 예약 용어 를 사용하지 마십시오.
매개변수
매개변수 | 설명 |
|---|---|
끈 | 필수의. 사용자 정의 속성의 이름입니다. 처음 255자만 유지됩니다. |
스칼라 | 필수의. 이 사용자 정의 속성과 연결할 값입니다. 제공된 값이 NaN, Infinity, denorm 또는 음의 0 값을 갖는 float 인 경우 이 함수의 동작은 정의되지 않습니다. 다른 부동 소수점 값의 경우 에이전트는 지정된 값에서 1개 이상의 정밀도 비트(ULP)를 버릴 수 있습니다. |
반환 값
매개변수가 성공적으로 추가되면 true를 반환합니다.
예
변수를 값으로 보고
if (extension_loaded('newrelic')) { // Ensure PHP agent is available // Record custom data about this web transaction newrelic_add_custom_span_parameter ('user_email', $user_email);}