• /
  • ログイン
  • 無料アカウント

add_custom_span_attribute (Python agent API)

Syntax

newrelic.agent.add_custom_span_attribute(key, value)

Adds a custom attribute to a span event.

Description

This call records a custom attribute (a key/value pair attached to your span event).

Attributes may be found in Distributed Tracing or in APM if a transaction trace is created by the parent transaction. Attributes can also be found and queried in New Relic One.

重要

Before you create custom attributes, review our list of reserved terms used by NRQL.

Parameters

Parameter

Description

key

string

Required. The key name. Only the first 255 characters are retained.

value

string, integer, float, boolean

Required. The string value to add to the current span event. Only the first 255 characters are retained.

Return values

Returns True if attribute was added successfully. 

Examples

Adding custom attributes to background task

An example of adding custom attributes to a background task:

@newrelic.agent.background_task()
def send_request():
with newrelic.agent.FunctionTrace(name='Trace'):
newrelic.agent.add_custom_span_attribute('attribute', 'value')

Using custom span attribute to troubleshoot

You can also use custom attributes to troubleshoot performance issues. For example, you might see occasional slow response times from a pool of memcache instances, but you don't know what instance is causing the problem. You might add an attribute to the span indicating the server, like so:

# Set server_ip to be the current server processing the transaction
newrelic.agent.add_custom_span_attribute("memcache_query_frontend_lookup", server_ip)

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.