통사론
newrelic.agent.add_custom_span_attribute(key, value)스팬 이벤트에 사용자 정의 속성을 추가합니다.
설명
이 호출은 사용자 정의 속성 ( 스팬 이벤트 에 연결된 키/값 쌍)을 기록합니다.
특성은 분산 추적 또는 상위 트랜잭션에 의해 트랜잭션 추적이 생성되는 경우 APM에서 찾을 수 있습니다. 속성은 New Relic UI에서도 찾고 쿼리 할 수 있습니다.
중요
맞춤 속성을 만들기 전에 NRQL에서 사용하는 예약어 목록을 검토하세요.
매개변수
매개변수 | 설명 |
|---|---|
끈 | 필수의. 키 이름입니다. 처음 255자만 유지됩니다. |
문자열, 정수, 부동소수점, 부울 | 필수의. 현재 범위 이벤트에 추가할 문자열 값입니다. 처음 255자만 유지됩니다. |
반환 값
속성이 성공적으로 추가된 경우 True 을 반환합니다.
예
백그라운드 작업에 사용자 정의 속성 추가
백그라운드 작업 에 사용자 정의 속성을 추가하는 예:
@newrelic.agent.background_task()def send_request(): with newrelic.agent.FunctionTrace(name='Trace'): newrelic.agent.add_custom_span_attribute('attribute', 'value')사용자 지정 범위 속성을 사용하여 문제 해결
사용자 정의 속성을 사용하여 성능 문제를 해결할 수도 있습니다. 예를 들어 Memcache 인스턴스 풀에서 때때로 느린 응답 시간을 볼 수 있지만 어떤 인스턴스가 문제를 일으키는지 알 수 없습니다. 다음과 같이 서버를 나타내는 범위에 속성을 추가할 수 있습니다.
# Set server_ip to be the current server processing the transaction
newrelic.agent.add_custom_span_attribute("memcache_query_frontend_lookup", server_ip)