set_transaction_name (PythonエージェントAPI)

構文

newrelic.agent.set_transaction_name(name, group=None, priority=None)

現在のトランザクションの名前を設定します。

説明

このコールは、現在のトランザクションの名前を設定します。

次に、 name パラメータと group パラメータを実装する 1 つの方法を示す例を示します。

name = '%s/%s' % (controller, function)
group = 'Python/WebFramework/Controller'newrelic.agent.set_transaction_name(name, group)

優先度パラメータは、ウェブフレームワークにカスタムインストルメンテーションを実装する場合に、名前を設定するポイントが複数ある場合（ミドルウェア、ビューハンドラ、エラーハンドラなど）を除き、通常は無視して構いません。

パラメーター

パラメータ	説明
`name` ストリング	必須。現在のトランザクションに対する希望の名前。名前の設定例については、説明を参照してください。
`group` ストリング	オプション。 `group` は、UI でトランザクションタイプを設定するために使用される、 `name` パラメータの命名構造を表します。グループの設定例については説明を参照してください。指定しない場合、グループは、名前が `module:class.function` または `module:function` の形式であり、実行される関数の名前を表すことを想定して、デフォルトで `Function` 名を使用します。カスタムグループを作成する場合は、接頭辞として `Python/`を付けることをお勧めします。トランザクションの命名に使用される命名構造。この値は URL の一部としてレンダリングされるため、非 ASCII エンコードは避けてください。デフォルトは `Function`です。これの使用方法の詳細については、「説明」を参照してください。
`priority` int	オプション。優先順位の値は、トランザクションにどのような名前が与えられるかを決定するために使用されます。大きい数値は小さい数値をオーバーライドします。デフォルト値は `None`で、トランザクション名が既存の値をオーバーライドすることを意味します。優先順位を `None`のままにした場合、新しい名前は常に既存の値をオーバーライドします。優先度がどのように機能するかの例を次に示します。 newrelic.agent.set_transaction_name('first', 'Python/CustomGroup') # transaction name becomes 'first'. newrelic.agent.set_transaction_name('second', 'Python/CustomGroup', priority=10) # transaction name becomes 'second'. The priority becomes 10. newrelic.agent.set_transaction_name('third', 'Python/CustomGroup', priority=5) # transaction name is still 'second' because 5 < 10. newrelic.agent.set_transaction_name('fourth', 'Python/CustomGroup', priority=15) # transaction name becomes 'fourth' because 15 > 10. The priority becomes 15. newrelic.agent.set_transaction_name('fifth', 'Python/CustomGroup') # transaction name becomes 'fifth'. The priority remains 15.

パラメータ

説明

name

ストリング

必須。現在のトランザクションに対する希望の名前。名前の設定例については、説明を参照してください。

group

ストリング

オプション。 group は、UI でトランザクションタイプを設定するために使用される、 name パラメータの命名構造を表します。グループの設定例については説明を参照してください。

指定しない場合、グループは、名前が module:class.function または module:function の形式であり、実行される関数の名前を表すことを想定して、デフォルトで Function 名を使用します。カスタムグループを作成する場合は、接頭辞として Python/を付けることをお勧めします。

トランザクションの命名に使用される命名構造。この値は URL の一部としてレンダリングされるため、非 ASCII エンコードは避けてください。デフォルトは Functionです。これの使用方法の詳細については、「説明」を参照してください。

priority

int

オプション。優先順位の値は、トランザクションにどのような名前が与えられるかを決定するために使用されます。大きい数値は小さい数値をオーバーライドします。デフォルト値は Noneで、トランザクション名が既存の値をオーバーライドすることを意味します。優先順位を Noneのままにした場合、新しい名前は常に既存の値をオーバーライドします。優先度がどのように機能するかの例を次に示します。

newrelic.agent.set_transaction_name('first', 'Python/CustomGroup')
# transaction name becomes 'first'.

newrelic.agent.set_transaction_name('second', 'Python/CustomGroup', priority=10)
# transaction name becomes 'second'. The priority becomes 10.

newrelic.agent.set_transaction_name('third', 'Python/CustomGroup', priority=5)
# transaction name is still 'second' because 5 < 10.

newrelic.agent.set_transaction_name('fourth', 'Python/CustomGroup', priority=15)
# transaction name becomes 'fourth' because 15 > 10. The priority becomes 15.

newrelic.agent.set_transaction_name('fifth', 'Python/CustomGroup')
# transaction name becomes 'fifth'. The priority remains 15.

戻り値

なし。

例

名前とグループのパラメータの使用

name パラメータと group パラメータを実装する 1 つの方法を示す例:

name = '%s/%s' % (controller, function) 
group = 'Python/WebFramework/Controller'

newrelic.agent.set_transaction_name(name, group)

current_transactionによる名前の設定

current_transaction を使用して現在のトランザクション名を設定する例:

transaction = newrelic.agent.current_transaction()
new_transaction_name = transaction.name
newrelic.agent.set_transaction_name(new_transaction_name)

この機械翻訳は参考用に提供されます。

set_transaction_name (PythonエージェントAPI)

構文

説明

パラメーター

戻り値

例

名前とグループのパラメータの使用

current_transactionによる名前の設定