newrelic_add_custom_parameter(PHP 에이전트 API)

통사론

newrelic_add_custom_parameter(string $key, scalar $value)

사용자 지정 속성(키/값 쌍)을 현재 트랜잭션 및 현재 범위(활성화된 경우)에 연결합니다.

요구 사항

에이전트 버전 4.4.5.35 이상.

설명

현재 웹 트랜잭션에 사용자 정의 속성 (키 및 값 데이터 쌍)을 추가합니다. ("사용자 정의 속성"이 이전에 "사용자 정의 매개변수"라고 했기 때문에 호출 이름은 newrelic_add_custom_parameter 입니다.) 예를 들어 고객 데이터베이스에서 고객의 전체 이름을 추가할 수 있습니다. 이 속성은 이 트랜잭션의 결과인 모든 트랜잭션 추적에 나타납니다. 사용자 정의 속성에 대한 트랜잭션 이벤트를 쿼리할 수도 있습니다.

중요

보안 권장 사항 - 트랜잭션 속성 구성을 검토하십시오. 모든 속성은 트랜잭션 이벤트와 관련된 설정을 포함하거나 제외하며 Span 속성 구성 또는 전역 속성 구성에 적용해야 합니다.

중요

사용자 정의 속성을 사용하려면 NRQL에서 사용하는 예약 용어 를 사용하지 마십시오.

매개변수

매개변수	설명
`$key` 끈	필수의. 사용자 정의 속성의 이름입니다. 처음 255자만 유지됩니다.
`$value` 스칼라	필수의. 이 사용자 정의 속성과 연결할 값입니다. 제공된 값이 NaN, Infinity, denorm 또는 음의 0 값을 갖는 float 인 경우 이 함수의 동작은 정의되지 않습니다. 다른 부동 소수점 값의 경우 에이전트는 지정된 값에서 1개 이상의 정밀도 비트(ULP)를 버릴 수 있습니다.

설명

$key

끈

필수의. 사용자 정의 속성의 이름입니다. 처음 255자만 유지됩니다.

$value

스칼라

필수의. 이 사용자 정의 속성과 연결할 값입니다.

제공된 값이 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_parameter('user_email', $user_email);
}

여러 통화

동일한 웹 트랜잭션에서 $key 매개변수에 대해 동일한 값을 사용하여 newrelic_add_custom_parameter 를 여러 번 호출하는 경우 마지막 호출의 $value 우선 적용됩니다. 마지막 호출의 값은 웹 트랜잭션의 사용자 정의 속성 으로 기록됩니다.

예를 들어 코드가 다음과 같은 경우:

if (extension_loaded('newrelic')) { // Ensure PHP agent is available
    // Record custom data about this web transaction
    newrelic_add_custom_parameter('user_email', billy@newrelic.com);
    newrelic_add_custom_parameter('user_email', samantha@newrelic.com);
}

samantha@newrelic.com 값은 웹 트랜잭션에서 user_email 사용자 정의 속성으로 기록되고 이전 호출의 billy@newrelic.com 덮어쓰여집니다.

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