통사론
newrelic.agent.add_custom_parameters(items)
트랜잭션에 하나 이상의 사용자 정의 속성을 추가합니다.
설명
이 호출은 하나 이상의 사용자 정의 속성 ( 트랜잭션 에 연결된 키/값 튜플)을 기록합니다. '맞춤 속성'이 이전에 '맞춤 매개변수'라고 불렸으므로 호출 이름은 add_custom_parameters
입니다.
트랜잭션이 오류와 연관되거나 해당 트랜잭션에 대해 트랜잭션 추적이 생성되는 경우 속성을 APM에서 찾을 수 있습니다. 속성은 New Relic UI에서도 찾고 쿼리할 수 있습니다.
중요
맞춤 속성을 만들기 전에 NRQL에서 사용하는 예약어 목록을 검토하세요.
매개변수
매개변수 | 설명 |
---|---|
목록 | 필수의. 목록의 각 항목은 첫 번째 요소가 키이고 두 번째 요소가 값인 튜플이어야 합니다. 각 키는 속성의 이름을 나타내는 문자열이고 각 해당 값은 이 속성에 대한 현재 트랜잭션에 추가할 값입니다. 값은 int , float , string 또는 boolean일 수 있습니다. 키와 값 모두에 대해 처음 255자만 유지됩니다. |
반환 값
모든 속성이 성공적으로 추가된 경우 True
을 반환합니다.
예
백그라운드 작업에 사용자 정의 매개변수 추가
백그라운드 작업 에 사용자 정의 매개변수를 추가하는 예:
@newrelic.agent.background_task()def send_request(): response = requests.get("http://example.com") newrelic.agent.add_custom_parameters( [("url_path_status_code", response.status_code)] )
맞춤 매개변수를 사용하여 문제 해결
사용자 정의 매개변수를 사용하여 성능 문제를 해결할 수도 있습니다. 예를 들어 Memcache 인스턴스 풀에서 때때로 느린 응답 시간을 볼 수 있지만 어떤 인스턴스가 문제를 일으키는지 알 수 없습니다. 다음과 같이 서버를 나타내는 트랜잭션에 속성을 추가할 수 있습니다.
# Set server_ip to be the current server processing the transactionnewrelic.agent.add_custom_parameters([ ("memcache_query_frontend_lookup", "server_ip")])